Skip to content
ACMS ACMS Docs

AI Agents

ACMS ships an agent skill so AI coding tools understand your project’s setup, content field API, CLI commands, storage adapters, and troubleshooting patterns — right inside the conversation context.

Quick Setup

Section titled “Quick Setup”

The easiest way to install the skill is during project initialization:

Terminal window
npx acms init

The init wizard includes a step to install ACMS agent skills. If ACMS is already set up, you can install the skill standalone:

Terminal window
npx skills-npm

skills-npm discovers the skills/acms/SKILL.md file inside the @useacms/cli package and symlinks it into your agent’s skill directory.

How It Works

Section titled “How It Works”

When you install @useacms/cli, a skills/acms/SKILL.md file is included in the package. This file contains structured documentation that AI coding agents can read to understand ACMS.

Running npx skills-npm scans your node_modules for packages that ship skills and creates symlinks in your agent’s skill directory:

  • Claude Code → .claude/skills/acms/
  • Codex → .codex/skills/acms/
  • Cursor / Windsurf / others → .agents/skills/acms/

The agent then automatically loads this context when working in your project.

Manual Setup

Section titled “Manual Setup”

If you prefer to set up the symlinks yourself:

Terminal window
# Claude Code (project-level)
mkdir -p .claude/skills && ln -s ../../node_modules/@useacms/cli/skills/acms .claude/skills/acms


# Codex
mkdir -p .codex/skills && ln -s ../../node_modules/@useacms/cli/skills/acms .codex/skills/acms


# Shared (works with most agents)
mkdir -p .agents/skills && ln -s ../../node_modules/@useacms/cli/skills/acms .agents/skills/acms

What the Skill Covers

Section titled “What the Skill Covers”

The ACMS agent skill teaches your AI coding assistant about:

  • Project setup — configuration files, dev server, and initialization
  • Content field API — proxy access patterns, type methods (.int(), .bool(), .text(), .img(), .list(), .loc(), .color(), .md(), .cal(), etc.)
  • CLI commands — acms dev, acms push, acms pull, acms sync, acms purge, and more
  • Storage adapters — local file, GitHub, Vercel Edge Config, Cloudflare KV, Convex
  • REST API — all endpoints for schema, content, field CRUD, and array operations
  • TypeScript types — auto-generated type definitions and module augmentation
  • Troubleshooting — common issues and how to resolve them

Supported Agents

Section titled “Supported Agents”

Any AI coding tool that supports the skills-npm convention will work, including:

If your agent doesn’t support skills-npm, use the manual setup instructions above or copy the skill file directly into your agent’s context.