Docs Skill

Docs Skill

This skill is a thin router to the live Chorus documentation site (https://doc.chorus-ai.dev). Use it to answer questions about how to use, configure, deploy, or operate Chorus — grounding the answer in the current published docs instead of memory.

It is not a workflow skill: it does not drive the AI-DLC pipeline. For that, load skill_view("chorus:idea"), skill_view("chorus:proposal"), skill_view("chorus:develop"), skill_view("chorus:review"), or skill_view("chorus:yolo").

When to Use

Use this skill whenever the user asks a product-usage question about Chorus, such as:

• UI workflow — how the Idea → Proposal → Task → Verify pipeline works in the web app, what a control does, how statuses flow.
• Agent setup — creating an API key, permissions and role presets, connecting an agent.
• Plugin setup — installing/configuring the Chorus plugin for your coding agent (on Hermes: the pinned chorus + chorus-mcp plugin directories, the native mcp_servers.chorus entry, terminal.cwd, and hermes gateway — see skill_view("chorus:chorus")).
• API / MCP — the REST API, the MCP tool surface, authentication, real-time events.
• Deployment — self-hosting, the CDK stack, environment configuration.
• Operations / troubleshooting — running Chorus, diagnosing connection or setup problems.

Do NOT use it to drive the pipeline (claiming ideas, writing proposals, executing tasks) — that is what the stage skills above are for. This skill answers "how does the product work / how do I set it up"; the stage skills do the work.

Access Convention

The docs site is agent-friendly. Follow this three-step convention every time. Do NOT answer from memory, and do NOT hardcode a page list — the index is the source of truth and pages change over time.

1. Fetch the index. Get https://doc.chorus-ai.dev/llms.txt — a machine-readable index that lists every documentation page with a one-line summary and its .md URL. The index is a single, unlocalized file that lives ONLY at the root /llms.txt. Never prefix it with a locale — https://doc.chorus-ai.dev/zh/llms.txt (and /ja/, /ko/) does NOT exist and returns 404.
2. Fetch the relevant page(s) as raw Markdown. Pick the page(s) that match the question from the index, then fetch the raw Markdown by appending .md to the page URL (e.g. https://doc.chorus-ai.dev/guides/getting-started → https://doc.chorus-ai.dev/guides/getting-started.md).
3. Ground the answer and link the human page. Base your answer on the fetched Markdown, and link the human-facing page (the .md URL without the .md suffix) so the user can open it in a browser.

On Hermes, fetch with the built-in web_extract tool, or curl -sL <url> via terminal when you need the raw bytes. Any web-fetch capability works — this skill states the convention, not a specific tool binding.

Locale

The /llms.txt index itself is not localized — there is exactly one, at the root. Localization applies to pages, not the index:

• The index always lives at https://doc.chorus-ai.dev/llms.txt and lists the root (en) page URLs. Do not look for /zh/llms.txt — it does not exist.