# Agility Skills for Your Coding Agent

> Source: https://agilitycms.com/docs/developers/agility-skills-for-coding-agents

Coding agents such as Claude Code, Cursor, GitHub Copilot and Gemini CLI do better work on an Agility project when they know how Agility behaves: that saves land in Staging, that lists return 10 items unless you ask for more, that some reference names need exact case. This page shows the ways to give an agent that knowledge today, and what to put in a skill of your own.

> [!WARNING]
> **There is no official Agility skills package.** Agility doesn't publish an installable skills package for coding agents. Use the tools below instead.
>
> Don't install a package or skill that presents itself as an official Agility skill. An unofficial package under an Agility-like name could contain anything, and an agent follows the instructions it loads.

## What you can use today

| Tool | What it gives your agent | Setup |
| --- | --- | --- |
| [Agility CMS MCP server](/docs/developers/agility-cms-mcp-server) | Live access to your instances: work with models, content, pages and media, as you, within your Agility permissions | Add the server to your agent and sign in with OAuth |
| [Agility Knowledgebase MCP server](/docs/overview/agility-knowledgebase-mcp-server) | Search and read the Agility documentation from inside the agent | Add the server URL to your agent |
| `llms.txt` and Markdown pages | A map of the docs and a clean Markdown copy of every article, for agents that fetch URLs | Nothing to install |
| [`AGENTS.md`](/docs/developers/agents-md-for-agility) | Your project's rules, conventions and instance facts, read at the start of every session | A file in your repo |

Use them together. The MCP servers let the agent act and look things up. `AGENTS.md` and your own skills tell it how to behave in your project.

## Connect the Agility CMS MCP server

The Agility CMS MCP server lets an agent work with your Agility instances directly. It is hosted at `https://mcp.agilitycms.com/api/mcp`, uses OAuth 2.0, and acts only within your existing Agility permissions.

For Claude Code:

```bash
claude mcp add --transport http "Agility-CMS" https://mcp.agilitycms.com/api/mcp
```

For one-click installs and setup steps for other clients, see [mcp.agilitycms.com/instructions](https://mcp.agilitycms.com/instructions) and [Agility CMS MCP Server](/docs/developers/agility-cms-mcp-server#installation).

Two things to tell your agent:

- **Saving never publishes.** `save_content_items` always saves to the instance's default workflow state, usually Staging, and ignores any `state` you pass. Saved items are not live until they are published.
- **Publishing changes your live site.** Decide in advance whether your agent may publish, and write that down in `AGENTS.md`.

## Connect the Agility Knowledgebase MCP server

The Knowledgebase MCP server is a separate, read-only server that searches this documentation. For Claude Code:

```bash
claude mcp add agility-knowledgebase --transport http https://docs.agilitycms.com/docs/api/mcp
```

It has two tools, `search_docs` and `fetch_doc`. For other clients, see [Agility Knowledgebase MCP Server](/docs/overview/agility-knowledgebase-mcp-server#setup).

## Point your agent at llms.txt and the Markdown pages

If your agent can fetch URLs, it doesn't need an MCP server to read the docs:

- **`https://agilitycms.com/docs/llms.txt`** lists the documentation pages, with links to their Markdown copies.
- **Every article is also available as Markdown.** Add `.md` to its URL, for example `https://agilitycms.com/docs/developers/content-fetch-api.md`.

Add a line to `AGENTS.md` such as "For Agility questions, read https://agilitycms.com/docs/llms.txt and fetch the `.md` version of the relevant article" so the agent uses the docs instead of guessing.

## Write your project's AGENTS.md

`AGENTS.md` is where your agent learns your project's rules and your instance's facts. Keep one canonical file and make tool-specific files such as `CLAUDE.md` point to it.

- [Writing an AGENTS.md for Agility Projects](/docs/developers/agents-md-for-agility) covers the conventions that matter most and gives a skeleton to start from.
- [Building an Agility Site with AI Coding Tools](/docs/developers/building-sites-with-ai-coding-tools) has a template for the Agility Next.js Starter.
- [MCP and Agility Gotchas to Know Before You Build](/docs/developers/vibe-coding-gotchas) is a list worth copying into it.

## Write your own skill for repeatable tasks

Some coding agents can load a skill: a folder of instructions, and optionally scripts or reference files, that the agent uses when a task calls for it. Claude Code, for example, loads a skill from a `SKILL.md` file in a folder under `.claude/skills/` ([Claude Code skills](https://code.claude.com/docs/en/skills)). Check your agent's documentation for its format.

Skills suit tasks you repeat, such as "create a news article through the MCP server" or "add a component model and its React component". Link each skill from `AGENTS.md`. These Agility facts are worth including in any skill that reads or writes content:

| Rule | Why | Source |
| --- | --- | --- |
| Pass `take` explicitly on list requests, and page with `skip` | Content Fetch API lists return 10 items by default, with a maximum of 250 per request | [Fetch API reference: get list](/docs/api-reference/fetch/get-list) |
| Saves go to Staging. Publish only when your project allows it | `save_content_items` ignores `state` and saves to the default workflow state | [Agility CMS MCP Server](/docs/developers/agility-cms-mcp-server#publishing--workflow) |
| Publishing a page doesn't publish its components | Publish the component content too, then check the live page | [MCP and Agility Gotchas](/docs/developers/vibe-coding-gotchas) |
| On an update, send every field | An update replaces the whole item, so fields you leave out are wiped | [MCP and Agility Gotchas](/docs/developers/vibe-coding-gotchas) |
| Use reference names exactly as `get_containers` returns them | The read API returns container reference names lowercased. When writing a User Selectable linked-content field, use the exact case `get_containers` returns | [MCP and Agility Gotchas](/docs/developers/vibe-coding-gotchas#reference-names-get-normalized) |
| Send `null` for release and pull dates unless you mean to schedule | A pull date that is already past takes an item down as soon as it would go live | [MCP and Agility Gotchas](/docs/developers/vibe-coding-gotchas) |
| Read back what you saved | Confirms nothing was lost in the save | [MCP and Agility Gotchas](/docs/developers/vibe-coding-gotchas) |

Keep instance-specific facts, such as your instance GUID, container IDs and reference names, in `AGENTS.md` rather than in a skill, so one skill works across projects.

## Related

- [Vibe Coding with Agility](/docs/developers/vibe-coding-with-agility)
- [Agility CMS MCP Server](/docs/developers/agility-cms-mcp-server)
- [Agility Knowledgebase MCP Server](/docs/overview/agility-knowledgebase-mcp-server)
- [Writing an AGENTS.md for Agility Projects](/docs/developers/agents-md-for-agility)
- [MCP and Agility Gotchas to Know Before You Build](/docs/developers/vibe-coding-gotchas)
- [AI & the MCP Server](/docs/ai)

---

## Related pages

- [Building an Agility Site with AI Coding Tools](https://agilitycms.com/docs/developers/building-sites-with-ai-coding-tools.md)
- [Vibe Coding with Agility](https://agilitycms.com/docs/developers/vibe-coding-with-agility.md)
- [From Brief to Working Site: The Vibe Coding Workflow](https://agilitycms.com/docs/developers/vibe-coding-workflow.md)
- [Writing an AGENTS.md for Agility Projects](https://agilitycms.com/docs/developers/agents-md-for-agility.md)
- [MCP and Agility Gotchas to Know Before You Build](https://agilitycms.com/docs/developers/vibe-coding-gotchas.md)
- [Vibe Coding Playbooks by Use Case](https://agilitycms.com/docs/developers/vibe-coding-playbooks.md)
- [From Proof of Concept to Production](https://agilitycms.com/docs/developers/vibe-coding-to-production.md)

Index of every docs page: https://agilitycms.com/docs/llms.txt