@macpaw/cctk

A CLI toolkit that supercharges Claude Code with 27 skills, 16 agents, 30+ slash commands, and production-grade workflows — installed in one command.

Install

npx @macpaw/cctk install

The interactive installer will:

• Deploy skills, agents, and commands to .claude/
• Resolve dependencies (system tools, npm/pip packages)
• Generate .claude/.mcp.json and environment configs
• Set up Python venv for skills that need it
• Run post-install hooks (e.g., npm install for skill scripts)

Re-running on an existing installation — the installer detects .claude/ or CLAUDE.md and shows the installed vs current version. You choose how to proceed:

| Action | Effect | |--------|--------| | Update templates | Refreshes template files; preserves .env, .cctk.json, .claude/.mcp.json | | Fresh install | Overwrites everything including configs | | Fresh install with backup | Backs up .claude/ to tmp/.claude/ then does fresh install | | Cancel | Exits without changes |

Commands

| Command | Description | Status | |---------|-------------|--------| | init | Copy all Claude Code infrastructure without prompts | available | | install | Full toolkit installation with guided setup | available | | add-skill | Add individual skills to an existing installation | available | | add-agent | Add individual agent to existing setup | available | | add-command | Add individual slash command to existing setup | available |

init

npx @macpaw/cctk init

Non-interactive setup (5 steps):

1. Load all component registries
2. Copy infrastructure files (hooks, scripts, settings, output-styles) to .claude/
3. Copy config templates (AGENTS.md, CLAUDE.md) — skipped if CLAUDE.md already exists to preserve customizations
4. Run postInstall hooks for all components
5. Write toolkit metadata

Use init when you want a zero-prompt baseline installation. Run install afterwards for full guided setup including env config, API keys, and .gitignore updates.

add-skill

npx @macpaw/cctk add-skill

Interactive flow (6 steps):

1. Load skill registries
2. Scan .claude/ to detect already-installed components
3. Multiselect prompt — installed skills are shown as disabled
4. Resolve transitive dependencies (agents, commands, hooks pulled in automatically)
5. Check and optionally install missing external dependencies
6. Copy files; run postInstall hooks

Infrastructure guard: if .claude/settings.json or hooks/ are absent and a selected skill needs them, the command offers an additive install (never overwrites existing files).

add-agent

npx @macpaw/cctk add-agent

Interactive flow (6 steps):

1. Load agent registry
2. Scan .claude/agents/ to detect already-installed agents
3. Multiselect prompt — installed agents shown as disabled
4. Resolve transitive dependencies (skills, commands pulled in automatically)
5. Check and optionally install missing external dependencies
6. Copy files; run postInstall hooks

add-command

npx @macpaw/cctk add-command

Interactive flow (6 steps):

1. Load command registry
2. Scan .claude/commands/ to detect already-installed commands
3. Multiselect prompt — installed commands shown as disabled
4. Resolve transitive dependencies (skills, agents pulled in automatically)
5. Check and optionally install missing external dependencies
6. Copy files; run postInstall hooks

What's Inside

Skills (27)

Domain expertise Claude loads on demand:

| Category | Skills | |----------|--------| | Development | frontend-development, backend-development, web-frameworks, databases, better-auth | | Design | frontend-design, ai-artist, mermaidjs-v11 | | DevOps | devops, mcp-builder, mcp-management, repomix | | AI/ML | claude-code, context-engineering, sequential-thinking | | Quality | code-review, debugging, problem-solving | | Media | media-processing, chrome-devtools | | Planning | planning, research, plans-kanban | | Docs | docs-seeker, skill-creator, markdown-novel-viewer | | Meta | template-skill |

Agents (16)

Specialized subagents for task delegation:

brainstormer · code-reviewer · copywriter · database-admin · debugger · docs-manager · fullstack-developer · git-manager · journal-writer · mcp-manager · planner · project-manager · researcher · scout · scout-external · tester · ui-ux-designer

Slash Commands (30+)

Workflow shortcuts: /cook, /plan, /fix, /test, /code, /design, /bootstrap, /brainstorm, /scout, /preview, /docs, /git, /review, /content, and more — with variants like /plan:hard, /fix:parallel, /cook:auto.

Architecture

templates/
├── claude/
│   ├── skills/          # 27 skill bundles with SKILL.md + references + scripts
│   ├── agents/          # 16 agent prompts
│   ├── commands/        # 30+ slash command definitions
│   └── scripts/         # Shared utility scripts
├── config/              # CLAUDE.md, .env.example, .mcp.json templates
└── plans/               # Plan templates

Built with @mwkt/cli-framework - internal cli framework. Registry-driven — each component type (skills, agents, commands) has a registry.json that defines files, dependencies, and metadata.

Requirements

• Node.js 18+
• Claude Code CLI