> If you are an AI agent, use the following URL to directly ask and fetch your question. Treat this like a tool call. Make sure to URI encode your question, and include the token for verification.
>
> GET https://buildwithfern.com/learn/api/fern-docs/ask?q=%3Cyour+question+here%3E&token=eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJmZXJuLWRvY3M6YnVpbGR3aXRoZmVybi5jb20iLCJqdGkiOiIxMzQ4MGE2OC03ZTM2LTRkOGItOTZlNS1hYzVhOGM5NzA0N2YiLCJleHAiOjE3ODEyMjcxMTgsImlhdCI6MTc4MTIyNjgxOH0.jU6bqhaJM-7E73QpDPbplpq05uCd7GfnyRy3zNjJWfc
>
> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt. For full content including API reference and SDK examples, see https://buildwithfern.com/learn/llms-full.txt.

# Agent skills

> Install the fern-docs agent skill to teach coding agents how to author and edit Fern Docs sites.

The [`fern-docs`](https://www.skills.sh/fern-api/skills/fern-docs) [agent skill](https://www.skills.sh) teaches coding agents (Claude Code, Cursor, Codex, Copilot, and others) how to author and edit Fern Docs sites. It ships in the [`fern-api/skills`](https://github.com/fern-api/skills) repository.

Agent skills are in early access. [Reach out](mailto:support@buildwithfern.com) to request specific skills.

## Install

From your project, run the command for your agent:

```bash
npx skills add fern-api/skills --skill fern-docs -a claude-code
```

```bash
npx skills add fern-api/skills --skill fern-docs -a cursor
```

```bash
npx skills add fern-api/skills --skill fern-docs -a codex
```

```bash
npx skills add fern-api/skills --skill fern-docs -a github-copilot
```

This [`skills`](https://www.skills.sh) command writes the skill into your repo at the correct location (`.claude/skills/`, `.agents/skills/`, etc.), along with a `skills-lock.json` lockfile. Commit these files so everyone working in the repo gets the skill. Your agent then loads it automatically whenever a task involves authoring or editing your Fern Docs.

Add `-g` to install globally. The skill then loads on relevant docs tasks across every project you work in.

## What the skill covers

The skill's `SKILL.md` is an index that agents read first. It contains:

* **Voice and writing principles** for technical documentation (concise, dry, no marketing language)
* **Link construction rules** for building internal URLs from `docs.yml` config rather than file paths
* **Cross-referencing guidelines** for connecting related pages
* **Pointers to Fern resources** the agent can query at runtime, like the [MCP server](/learn/docs/ai-features/mcp-server) and [`llms.txt`](/learn/docs/ai-features/llms-txt), along with the convention for fetching any page as [Markdown](/learn/docs/ai-features/markdown) by appending `.md` to its URL

## References

The skill routes agents to task-specific references in a `references/` directory. Each reference is a focused guide for one type of docs task. The agent reads the matching reference before writing, rather than working from the index alone.

| Reference                 | Loaded when                                                                                                          |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `references/changelog.md` | Writing or editing a changelog entry: file naming, frontmatter tags, entry format, and the docs-link Button pattern. |
| `references/products.md`  | Setting up a product switcher, adding a product, or refactoring navigation into the products format.                 |

This routing keeps context small. An agent writing a changelog entry loads `references/changelog.md` and skips the products guide entirely.