agent-doctor

Sync and inventory skills and MCP configs for multi-agent coding setups (Cursor, Codex, Claude Code).

Single source of truth lives in each project's .agents/ directory. Harness-native paths (.cursor/, .codex/, .claude/) are generated shims.

Install

npm install --save-dev @chendpoc/agent-doctor
# or: pnpm add -D @chendpoc/agent-doctor

Usage

After installing it in a project, use the agent-doctor bin:

# One-time scaffold
npx agent-doctor init

# Render shims from .agents/manifest.yaml
npx agent-doctor sync

# Verify shims are up to date (CI / pre-commit check)
npx agent-doctor check

# Audit scattered skills and MCP
npx agent-doctor inventory

# One-time: enable pre-commit sync
npx agent-doctor install-hooks

check is read-only. It exits non-zero when generated shims are missing, stale, extra, or pointing at the wrong skill target; run agent-doctor sync to fix them.

For one-off usage without adding a dependency first:

npx @chendpoc/agent-doctor init

Daily Workflow

1. Change .agents/manifest.yaml, .agents/skills/*, or .agents/mcp/*.yaml.
2. Run npx agent-doctor sync.
3. Run npx agent-doctor check before commit.

Project layout (consumer repo)

.agents/
  manifest.yaml       # whitelist: skills, personal inherit, MCP servers
  skills/             # project skill bodies
  mcp/                # portable MCP definitions (*.yaml)

Do not hand-edit .cursor/mcp.json or other shims — change .agents/ and run agent-doctor sync.

Skill install discipline

| Scope | Command | Target | |-------|---------|--------| | Project | npx skills add <pkg> -a cursor -a codex -a claude-code -y | .agents/skills/ | | Personal | npx skills add <pkg> -g -a codex -a claude-code -y | ~/.agents/skills/ |

List project skills in manifest.yaml under skills.project. List inherited personal skills under inherit.personal.

Development

pnpm install
pnpm dev -- inventory --cwd .
pnpm verify
pnpm release:check

Docs

• Manifest schema
• Harness adapters
• Glossary

License

MIT