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:

  1. 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.
  2. Copies every skill to .agents/skills/<name>/ and .claude/skills/<name>/.
  3. Stamps each copied skill with the skills version and the SDK version it was written for.
  4. Adds a managed block to AGENTS.md (and to CLAUDE.md when it exists and does not import AGENTS.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/skills before v0.5.0, with a chaibuilder-skills command. Use chaiskills from v0.5.0 on.

© ChaiBuilder. All rights reserved.

ChaiBuilderMade withChaiBuilder