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.
- 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.
- 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).
- 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.
en is the root (unprefixed): https://doc.chorus-ai.dev/...
zh, ja, ko are path-prefixed pages: take a page path from the index and prepend the locale — https://doc.chorus-ai.dev/zh/..., /ja/..., /ko/...
- Appending
.md works on the prefixed pages too (e.g. https://doc.chorus-ai.dev/zh/guides/getting-started.md).
- Match the user's language when the docs exist in it; fall back to
en otherwise.
Relationship to the Workflow Skills
This skill complements the AI-DLC workflow skills — it does not replace them:
| The user wants to… |
Use |
| Learn how to use / configure / deploy / operate Chorus |
this skill (skill_view("chorus:docs")) |
| Drive an idea / write a proposal / execute or verify a task |
skill_view("chorus:idea"), skill_view("chorus:proposal"), skill_view("chorus:develop"), skill_view("chorus:review"), skill_view("chorus:yolo") |
Always use the live host doc.chorus-ai.dev. docs.chorus-ai.dev (with an "s") is a dead link — never use it.
1---2name: docs-53description: Chorus documentation router for Hermes Agent — consult the live Chorus docs site to answer product-usage questions (UI workflow, agent/plugin setup, API/MCP, deployment, operations).4license: AGPL-3.05metadata:6 source: https://skillmd.com/skills/chorus-aidlc/docs-57 author: chorus8 version: "0.24.1"9 category: project-management10 mcp_server: chorus11---1213# Docs Skill1415This 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.1617It 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")`.1819---2021## When to Use2223Use this skill whenever the user asks a **product-usage** question about Chorus, such as:2425- **UI workflow** — how the Idea → Proposal → Task → Verify pipeline works in the web app, what a control does, how statuses flow.26- **Agent setup** — creating an API key, permissions and role presets, connecting an agent.27- **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")`).28- **API / MCP** — the REST API, the MCP tool surface, authentication, real-time events.29- **Deployment** — self-hosting, the CDK stack, environment configuration.30- **Operations / troubleshooting** — running Chorus, diagnosing connection or setup problems.3132Do **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.3334---3536## Access Convention3738The 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.39401. **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.**412. **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`).423. **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.4344On 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.4546---4748## Locale4950The `/llms.txt` index itself is **not** localized — there is exactly one, at the root. Localization applies to **pages**, not the index:5152- 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.**53- `en` is the root (unprefixed): `https://doc.chorus-ai.dev/...`54- `zh`, `ja`, `ko` are **path-prefixed pages**: take a page path from the index and prepend the locale — `https://doc.chorus-ai.dev/zh/...`, `/ja/...`, `/ko/...`55- Appending `.md` works on the prefixed pages too (e.g. `https://doc.chorus-ai.dev/zh/guides/getting-started.md`).56- **Match the user's language** when the docs exist in it; fall back to `en` otherwise.5758---5960## Relationship to the Workflow Skills6162This skill **complements** the AI-DLC workflow skills — it does not replace them:6364| The user wants to… | Use |65|--------------------|-----|66| Learn how to use / configure / deploy / operate Chorus | **this skill** (`skill_view("chorus:docs")`) |67| Drive an idea / write a proposal / execute or verify a task | `skill_view("chorus:idea")`, `skill_view("chorus:proposal")`, `skill_view("chorus:develop")`, `skill_view("chorus:review")`, `skill_view("chorus:yolo")` |6869Always use the live host `doc.chorus-ai.dev`. `docs.chorus-ai.dev` (with an "s") is a dead link — never use it.