# cursor-kenji

> cursor-kenji is an installable library of ready-made AI **playbooks** (skills) that your AI code editor triggers automatically when you describe a task in plain English — so it follows a proven workflow instead of improvising. For Cursor, Claude Code, Codex CLI, and Gemini CLI: 142 agent skills, 54 slash commands, 6 subagents, and MCP server templates for React / Next.js / Supabase. Full-pack one-liner: `npx @kensaurus/cursor-kenji --all` (skills + commands; `--all` = Cursor + Claude + Codex + Gemini). Skills-only: `npx skills add kensaurus/cursor-kenji` (does not write slash commands; that CLI's `--all` means every skill to every agent). Re-check: `npx @kensaurus/cursor-kenji --verify --all`. Context-file tools (Codex, Gemini) get rules merged into `AGENTS.md`/`GEMINI.md` plus portable command ports.

Validated against the [Agent Skills specification](https://agentskills.io/specification) on every commit. npm package: `@kensaurus/cursor-kenji`.

## Install

- [README.md](https://github.com/kensaurus/cursor-kenji/blob/main/README.md): Quick start, install modes, FAQ, skill taxonomy
- [docs/GETTING-STARTED.md](https://github.com/kensaurus/cursor-kenji/blob/main/docs/GETTING-STARTED.md): First-time Cursor setup, MCP copy steps, troubleshooting

## Reference

- [docs/CATALOG.md](https://github.com/kensaurus/cursor-kenji/blob/main/docs/CATALOG.md): Full skill list with trigger phrases and composition patterns
- [docs/THIRD-PARTY-SKILLS.md](https://github.com/kensaurus/cursor-kenji/blob/main/docs/THIRD-PARTY-SKILLS.md): Vendored upstream skills (`thirdparty-*`), attribution, update policy
- [docs/TRIGGER-CHEATSHEET.md](https://github.com/kensaurus/cursor-kenji/blob/main/docs/TRIGGER-CHEATSHEET.md): Plain lookup table for skill triggers
- [docs/PLAN-LOOPS.md](https://github.com/kensaurus/cursor-kenji/blob/main/docs/PLAN-LOOPS.md): 20 `plan-*` audit skills in grouped loops (approve before execution)
- [docs/AGENTS.template.md](https://github.com/kensaurus/cursor-kenji/blob/main/docs/AGENTS.template.md): Project constitution template for consumer repos

## MCP & security

- [mcp/README.md](https://github.com/kensaurus/cursor-kenji/blob/main/mcp/README.md): MCP server setup, pinned package versions
- [SECURITY.md](https://github.com/kensaurus/cursor-kenji/blob/main/SECURITY.md): Secrets hygiene, `.mcp.json` guidance, reporting vulnerabilities

## Distribution & publishing

- [docs/DISTRIBUTION.md](https://github.com/kensaurus/cursor-kenji/blob/main/docs/DISTRIBUTION.md): Install channels, directory listings, discovery status
- [docs/PUBLISHING.md](https://github.com/kensaurus/cursor-kenji/blob/main/docs/PUBLISHING.md): Maintainer release guide (GitHub Release → OIDC npm)
- [docs/PROMOTION.md](https://github.com/kensaurus/cursor-kenji/blob/main/docs/PROMOTION.md): Listing copy for skills.sh, cursor.directory, marketplace
- [docs/examples/plan-audits/](https://github.com/kensaurus/cursor-kenji/tree/main/docs/examples/plan-audits): Sample `plan-*.md` audit outputs
- [CHANGELOG.md](https://github.com/kensaurus/cursor-kenji/blob/main/CHANGELOG.md): Release history
- [CONTRIBUTING.md](https://github.com/kensaurus/cursor-kenji/blob/main/CONTRIBUTING.md): Adding skills, validation, PR workflow