Agent Skills
Coding agents do not read inside node_modules, so installing ChaiBuilder is not enough for
them to know how to use it. chaiskills is a set of Agent Skills
that teach coding agents to build with the SDK, and a small CLI that puts them where each agent
looks.
This is for the agent that writes your code. To let an AI agent edit your sites instead, see MCP Server Setup.
Install
From the root of a project that depends on chaipro:
pnpm dlx chaiskills add
This:
- Detects the SDK edition and version from
package.json, or from a vendored copy of the SDK if your project includes it as a git subtree. - Copies every skill to
.agents/skills/<name>/and.claude/skills/<name>/. - Stamps each copied skill with the skills version and the SDK version it was written for.
- Adds a managed block to
AGENTS.md(and toCLAUDE.mdwhen it exists and does not importAGENTS.md) listing each skill and the rules agents most often get wrong.
Commit the result, so every person and every agent on the project gets the same skills.
The skills
| Skill | Covers |
|---|---|
chaibuilder |
The router: which skill to read for which task |
chaibuilder-setup |
Installing the SDK, databases, Payload, table names |
chaibuilder-custom-blocks |
Block components, props schemas, settings groups, slots, data providers |
chaibuilder-rendering |
Rendering pages, layouts and custom render pipelines |
chaibuilder-server |
Server config, actions, permissions, page types, AI providers |
chaibuilder-editor-ui |
Editor hooks, panels, slots and register APIs |
chaibuilder-pro-plugins |
The built-in plugins and their options |
chaibuilder-pro-mcp-server |
Enabling the MCP server and writing custom MCP tools |
chaibuilder-pro-mcp-operator |
Working on a site through the MCP tools |
Which agent reads what
| Agent | Reads |
|---|---|
| Claude Code | .claude/skills/ and CLAUDE.md |
| Cursor, Codex, GitHub Copilot, Gemini CLI, opencode, Amp, Windsurf | .agents/skills/ and AGENTS.md |
Options
| Option | Effect |
|---|---|
--skill <name> |
Only these skills (repeatable or comma-separated). Default: all |
--agent <target> |
agents (.agents/skills), claude (.claude/skills) or all (default) |
--global |
Install into ~/.agents/skills and ~/.claude/skills, with no AGENTS.md block |
--no-agents-md |
Leave AGENTS.md and CLAUDE.md alone |
--cwd <dir> |
The project root, if not the current directory |
-y, --yes |
Do not ask before writing |
Keep them current
The skills are versioned with chaipro: a chaiskills release describes the chaipro release
of the same version. After upgrading the SDK, refresh them:
pnpm dlx chaiskills@latest update # re-copy the installed skills and refresh the index
pnpm dlx chaiskills@latest check # exit 1 if anything is stale
check fails when an installed skill came from another chaiskills version, when the SDK
version changed since the skills were stamped, or when the AGENTS.md or CLAUDE.md block is out
of date. Add it to CI to catch an SDK upgrade that forgot the skills. list shows every skill and
the version installed in each directory.
Everything between <!-- BEGIN:chaiskills --> and <!-- END:chaiskills --> in AGENTS.md is
rewritten on every run, so keep your own notes outside those markers.
The package was published as
@chaibuilder/skillsbefore v0.5.0, with achaibuilder-skillscommand. Usechaiskillsfrom v0.5.0 on.
Related
- Project Setup - installing the SDK the skills describe
- Custom Blocks - the most common thing agents build
- MCP Server Setup - letting AI agents edit your sites

