---
title: "AI agents"
description: "Help coding agents use docscn, with the docscn skill and the docs as Markdown."
url: https://docscn.dev/docs/ai-agents
lastModified: 2026-10-09T07:22:10.000Z
---

# AI agents (/docs/ai-agents)

> Help coding agents use docscn, with the docscn skill and the docs as Markdown.

## The docscn skill [#the-docscn-skill]

docscn has an [agent skill](https://agentskills.io) for coding agents such as Claude Code, Cursor and Codex. It tells the agent how to set up docs in a shadcn/ui project, migrate from Fumadocs UI, add the AI chat, and follow docscn's conventions: the `@/components/docs/` import paths, shadcn/ui theme tokens instead of Fumadocs UI's, and editing components instead of using `slots`. For anything else, it reads these docs.

Install it into your project with the [skills CLI](https://github.com/vercel-labs/skills):

<CodeBlockTabs defaultValue="npm">
  <CodeBlockTabsList>
    <CodeBlockTabsTrigger value="npm">
      npm
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="pnpm">
      pnpm
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="yarn">
      yarn
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="bun">
      bun
    </CodeBlockTabsTrigger>
  </CodeBlockTabsList>

  <CodeBlockTab value="npm">
    ```bash
    npx skills add ruiyuwg/docscn
    ```
  </CodeBlockTab>

  <CodeBlockTab value="pnpm">
    ```bash
    pnpm dlx skills add ruiyuwg/docscn
    ```
  </CodeBlockTab>

  <CodeBlockTab value="yarn">
    ```bash
    yarn dlx skills add ruiyuwg/docscn
    ```
  </CodeBlockTab>

  <CodeBlockTab value="bun">
    ```bash
    bun x skills add ruiyuwg/docscn
    ```
  </CodeBlockTab>
</CodeBlockTabs>

The CLI asks which agents to install it for. The skill's source is in [`skills/docscn`](https://github.com/ruiyuwg/docscn/tree/main/skills/docscn).

## shadcn/ui's MCP server [#shadcnuis-mcp-server]

shadcn/ui's [MCP server](https://ui.shadcn.com/docs/mcp) lets agents browse, search and install registry items, including docscn's. The CLI finds `@docscn` items through the registry index, but the MCP server only searches registries listed in `components.json`, so add docscn's:

```json title="components.json"
{
  "registries": {
    "@docscn": "https://docscn.dev/r/{name}.json"
  }
}
```

Then set up the server for your agent (`claude`, `cursor`, `vscode`, `codex` or `opencode`):

<CodeBlockTabs defaultValue="npm">
  <CodeBlockTabsList>
    <CodeBlockTabsTrigger value="npm">
      npm
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="pnpm">
      pnpm
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="yarn">
      yarn
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="bun">
      bun
    </CodeBlockTabsTrigger>
  </CodeBlockTabsList>

  <CodeBlockTab value="npm">
    ```bash
    npx shadcn@latest mcp init --client claude
    ```
  </CodeBlockTab>

  <CodeBlockTab value="pnpm">
    ```bash
    pnpm dlx shadcn@latest mcp init --client claude
    ```
  </CodeBlockTab>

  <CodeBlockTab value="yarn">
    ```bash
    yarn dlx shadcn@latest mcp init --client claude
    ```
  </CodeBlockTab>

  <CodeBlockTab value="bun">
    ```bash
    bun x shadcn@latest mcp init --client claude
    ```
  </CodeBlockTab>
</CodeBlockTabs>

Agents can then answer requests like "show me docscn's sidebar components" or "add docscn's docs block".

## The docs as Markdown [#the-docs-as-markdown]

These docs are also available as Markdown, for agents and LLMs to read:

| URL                                                  | Content                                                                                        |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| [`/llms.txt`](https://docscn.dev/llms.txt)           | An index of every page, with its description                                                   |
| [`/llms-full.txt`](https://docscn.dev/llms-full.txt) | Every page in one file                                                                         |
| `/docs/<page>.md`                                    | One page, for example [`/docs/getting-started.md`](https://docscn.dev/docs/getting-started.md) |

A request for the homepage or a docs page that prefers Markdown (`Accept: text/markdown`) also gets the Markdown: `llms.txt` for the homepage. The skill is also published for the [Agent Skills discovery RFC](https://github.com/cloudflare/agent-skills-discovery-rfc) at [`/.well-known/agent-skills/index.json`](https://docscn.dev/.well-known/agent-skills/index.json). The **Copy Markdown** button at the top of each page copies it, and the menu next to it opens the page in ChatGPT, Claude and other AI tools.

To add the same to your own docs, see [Page actions](/docs/components/page-actions) and Fumadocs' [LLM guide](https://fumadocs.dev/docs/integrations/llms). To let your readers ask questions about your docs, add the [AI chat](/docs/components/ai-chat).