agora-skills

Agora Skills

Structured reference knowledge for Agora (agora.io) real-time AI and Communication SDKs, designed for AI coding assistants. Covers Conversational AI (voice AI agents), RTC (video/voice), RTM (signaling/messaging), and server-side token generation.

Installation

Skills CLI (recommended)

npx skills add github:AgoraIO/skills

Skills activate automatically when your agent detects relevant tasks (e.g., "build a voice agent", "integrate Agora RTC", "generate a token").

Claude Code Plugin (recommended if using Claude)

Install Agora skills and the Agora Docs MCP server as a Claude Code plugin. Run these two slash commands inside Claude Code:

/plugin marketplace add AgoraIO/skills
/plugin install agora@agora-skills

The Agora MCP server (mcp.agora.io) is bundled automatically — no separate MCP configuration needed.

Git clone

Clone the repo once, then point your tool at skills/agora/:

git clone https://github.com/AgoraIO/skills.git ~/agora-skills

Configure with your Agent or IDE (optional)

Claude Code — symlink (user-level):

When installing the skill using the Skills CLI, you can symlink the skill to your home directory. This will make the skill available to all your agents.

ln -s ~/agora-skills/skills/agora ~/.claude/skills/agora

Claude Code — copy (project-level, shared with team):

When installing the skill using the Claude Code Plugin, you can copy the skill to your project directory. This will make the skill available to all your agents in the project.

mkdir -p .claude/skills
cp -r ~/agora-skills/skills/agora .claude/skills/agora

Cursor: Copy or symlink into .cursor/rules/. See Cursor skills docs.

Windsurf: Add skills/agora/ to your Cascade context. See Windsurf skills docs.

GitHub Copilot: Reference via @workspace or add to .github/copilot-instructions.md. See Copilot CLI skills and Copilot Agents skills.

Any other tool: The skill files are plain markdown. Point your tool at skills/agora/ or load individual files directly. Use SKILL.md as the entry point — it links to everything else.

---

What This Is

This repo contains markdown skill files that give AI coding assistants deep knowledge of Agora's platform. When a developer asks for help with Agora, the assistant loads the relevant reference material — from high-level product overviews down to platform-specific code examples and API details.

Products covered:

• RTC (Video/Voice SDK) — Web, React, Next.js, iOS (Swift), Android (Kotlin/Java), React Native, Flutter
• RTM (Signaling) — Web (JS/TS), iOS (Swift), Android (Kotlin) — all v2; messaging, presence, metadata, stream channels
• Conversational AI — REST API, agent config, Gemini Live + OpenAI Realtime MLLM, iOS/Android toolkits, 6 recipe repos (agent-samples, agent-toolkit, agent-client-toolkit-react, agent-ui-kit, server-custom-llm, server-mcp)
• Cloud Recording — REST API acquire/start/query/stop lifecycle
• Server Gateway — Linux SDK (C++) for server-side RTC
• Server-Side — Token generation for Node.js, Python, Go
• Multi-Product Integration — RTC + RTM + ConvoAI initialization order, UID strategy, codec selection, token matrix
• Testing Guidance — Mocking patterns for all platforms (Web, React, iOS, Android, React Native, Flutter, RTM)

Design — 4-Layer Progressive Disclosure

LLM context windows are finite. Load the minimum needed, go deeper only when required.

Layer	What	Size	When Loaded
1 — Description	Trigger keywords in SKILL.md frontmatter	~100 words	Always (skill index)
2 — SKILL.md body	Core concepts, product index, framework notes	~72 lines	On activation
3 — Product README	Overview, critical rules, topic links	20–100 lines	Per product
4 — Topic files	Implementation detail, code examples, API reference, or TOC + links	34–500 lines	Per topic

Navigation: SKILL.md → product README.md → topic file (e.g., web.md, agent-samples.md).

Link-First vs Inline

Not all content belongs inline. The skill uses two strategies depending on how fast upstream content moves and how well it's documented: