Skip to main content

Using DialStack with AI agents

If you work through an AI agent — Claude Code, Cursor, GitHub Copilot, Codex, Gemini CLI — install the DialStack docs skill. It makes the agent read this documentation before answering, and cite the page it used.

Why bother​

These docs are public, so most models already have some knowledge of DialStack baked in. That sounds helpful and is the actual hazard: the recalled answer is fluent, usually close, carries no source, and goes stale silently. You cannot tell which half of it to trust, and neither can the agent.

The skill changes that. It is a thin pointer layer — it holds almost no product detail of its own, so it does not go out of date when we ship. It tells the agent where to look, insists it look, and insists it cite.

Install​

Claude Code​

/plugin marketplace add dialstack/dialstack-sdk
/plugin install dialstack-docs@dialstack

Cursor, Codex, Copilot, Gemini CLI, and others​

The skill follows the Agent Skills open standard, which these tools all read. Copy the skill directory into wherever your tool keeps skills:

git clone https://github.com/dialstack/dialstack-sdk
cp -r dialstack-sdk/skills/dialstack-docs <your-tool's-skills-directory>

Check your tool's documentation for that path.

Claude.ai and Cowork​

Useful for support and account-admin teams who work in the browser rather than in an editor. An organization owner installs it once for everyone, under Settings → Skills → Organization skills. Build the upload archive by running ./package.sh inside the skill directory.

What it does​

  • Fetches the relevant page before answering, instead of relying on recall.
  • Distinguishes portal questions from API questions. Several topics are documented both ways, and the answers are different.
  • Cites the page it used, so you can check it.
  • Refuses to invent endpoints, parameters, or portal screens, and says so when the docs do not cover something.

If you are not using the skill​

Point your agent at these two files, which exist for exactly this purpose:

FileWhat it is
/llms.txtIndex of every page with a one-line description
/api/endpoints.mdEvery API operation with its verb, path, and query parameters

Any page can be fetched as clean markdown by prefixing /docs and appending .md — so /guides/pagination is also available at /docs/guides/pagination.md.