@macpaw/cctk 1.0.0-beta.1

package/License

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023, MacPaw Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# @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
+
+```bash
+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`
+
+```bash
+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`
+
+```bash
+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`
+
+```bash
+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`
+
+```bash
+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

package/bin/index.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { claudeCodeToolkit } from '../dist/index.js';
+
+claudeCodeToolkit();