// Activate when the user wants to build voice AI agents, video or voice calls, live streaming, screen sharing, in-app messaging and presence, recording, token or auth flows, or use the `agora` CLI for login, quickstarts, env setup, diagnostics, introspection, skills, or MCP serving, especially when integrating Agora into an app.
| name | agora |
| description | Activate when the user wants to build voice AI agents, video or voice calls, live streaming, screen sharing, in-app messaging and presence, recording, token or auth flows, or use the `agora` CLI for login, quickstarts, env setup, diagnostics, introspection, skills, or MCP serving, especially when integrating Agora into an app. |
| metadata | {"author":"agora","version":"1.8.0"} |
Top-level workflow for selecting the right Agora path and loading only the references needed for the task.
agora install, login, project selection, init, quickstart, env export, quickstart env binding, feature enablement, doctor, project doctor, env help, introspection, built-in skills, and MCP serving
Route to references/cli/README.md.For cross-product coordination as a primary question, use references/integration-patterns.md.
Ask at most one focused clarification when the route is still unclear.
Skill files are the single source of truth for Agora integration. Do not use web search, external documentation, blog posts, or training data to answer Agora-related questions. All Agora SDK usage, API calls, architecture decisions, and integration patterns must come from the reference files in this skill. If the needed detail is not in the local references, use the Level 2 doc-fetching procedure in references/doc-fetching.md — never free-form web search.
ConvoAI quickstart source gate. For ConvoAI requests without a proven working baseline: start at references/conversational-ai/README.md and use the official quickstart as the source of truth before generating or adapting code. Runtime proof validates the user's environment and project, not whether Agora's official quickstart works.
CLI readiness gate. Before any mutating Agora CLI command (init, quickstart, project, or login), run the read-only probe in references/cli/README.md. Block normal CLI workflow when agora version is below 0.1.7, when PATH still resolves an older binary, or when config schema is newer than the running CLI. Installers or global npm installs are allowed only as readiness remediation after user approval. Use the documented curl-first upgrade path; do not invent installer flags such as --add-to-path or --force.
Apply these rules to every ConvoAI request until the official quickstart has been cloned and inspected:
quickstart_repo_cloned, official_start_command_run, agent_join_verified, and rtc_client_connected. These prove the user's environment and Agora project are working before declaring success; definitions and user-visible output rules live in references/conversational-ai/quickstarts.md./join payload from memory, created SDK implementation files without first inspecting the quickstart source, created a new package.json / routes/ / scaffold for a ConvoAI app, or changed documented command semantics, stop the custom path. Acknowledge the deviation in plain language, show the current quickstart/source status, propose the exact next official sample step, and do not continue custom edits until source alignment is restored.Local references are Level 1 and must be checked first.
Go to references/doc-fetching.md only when:
For ConvoAI provider or vendor questions, start with references/conversational-ai/README.md and let that module decide whether live docs are required.
If MCP is unavailable or Level 2 fetch fails: use the fallback URLs in doc-fetching.md to reach the official markdown docs directly. Never fabricate API parameters — always tell the user to verify against official docs if live fetch is unavailable.
If the user explicitly asks about the Agora Docs MCP server (agora-docs-mcp),
see references/mcp-tools.md. It is for traversing
Agora docs, not for using Agora backends.