mongez-agent-kit-monorepos

Monorepos

Claude Code (and every other agent) discovers project skills only from the session-root skills directory — it does not recurse into subdirectories. So in a full-stack repo opened at the root, an inner project's backend/.claude/skills/ (or backend/skills/) is invisible. agent-kit closes that gap by aggregating each project's skills up into the root.

repo/                          ← you open your agent here; one .claude/skills/
├── package.json               ← agentKit.monorepo.projects: ["backend", "frontend"]
├── AGENTS.md
├── backend/
│   ├── package.json           ← backend's own agentKit.pick/omit
│   ├── skills/code-standards/SKILL.md
│   └── node_modules/@warlock.js/core/skills/…
└── frontend/
    ├── package.json
    ├── skills/forms/SKILL.md
    └── node_modules/@warlock.js/core/skills/…

npx agent-kit sync --projects backend,frontend

.claude/skills/
  backend-code-standards/        # backend's authored skill — prefixed with the project dir
  frontend-forms/                # frontend's authored skill
  warlock-js-core-use-cache/     # shared dependency — ONE copy, by package slug

The mental model

Each declared project is scanned as if you ran agent-kit sync inside it — its node_modules/ dependency skills (filtered by that project's own agentKit config) plus its authored skills/ folder — and the results are merged up into the root's skill directories.

Declaring projects

Two equivalent ways. Pin it in config so contributors don't retype it:

{
  "scripts": { "postinstall": "agent-kit sync" },
  "agentKit": { "monorepo": { "projects": ["backend", "frontend"] } }
}

…or pass it ad-hoc on the CLI (overrides the config):

npx agent-kit sync --projects backend,frontend
npx agent-kit sync --projects "apps/*"        # one-level glob: every dir under apps/

Entries are paths relative to the repo root (or absolute). A one-level glob (apps/*, packages/*, or bare *) expands to each immediate subdirectory; hidden dirs and node_modules are skipped. Multi-level / mid-path globs are intentionally unsupported.