claude-code-toolkit

Claude Code Toolkit

Extend Claude Code with specialized workflows, automatic formatting, and better defaults.

Skills give Claude domain expertise—brainstorming methods, leading a project with worker agents, project wikis, book writing pipelines. Hooks automate repetitive tasks—format code after edits, summarize changes at session end. Templates configure how Claude works with you.

Works with both Claude Code (CLI) and Claude.ai (web/mobile/desktop).

Quick Start

# Clone the toolkit
git clone https://github.com/robertguss/claude-code-toolkit.git

# Use a skill in Claude Code
# Add to your project's CLAUDE.md:
echo "When brainstorming, read /path/to/claude-code-toolkit/skills/brainstorm/SKILL.md" >> CLAUDE.md

# Or package for Claude.ai
python build.py brainstorm
# Upload dist/brainstorm.skill to Claude.ai → Settings → Skills

What's Included

Skills

Packaged workflows that Claude follows when invoked. Use them with /skillname or reference in CLAUDE.md.

Book & Writing:

• ebook-factory — Focused ebook creation pipeline
• non-fiction-book-factory — Full pipeline from idea to chapter architecture
• writing — Voice capture and ghost writing

Hooks

Shell scripts that run automatically at specific Claude Code events.

Templates

Document templates for configuring how Claude works with you.

Quick Start

Using Skills

Claude Code (CLI):

Reference in your project or global CLAUDE.md:

# CLAUDE.md

When brainstorming, read and follow
/path/to/claude-code-toolkit/skills/brainstorm/SKILL.md

Claude.ai (Web/Mobile/Desktop):

python build.py brainstorm
# Upload dist/brainstorm.skill to Claude.ai → Settings → Skills

Installing Hooks

1. Copy the hook script:

   cp hooks/auto-format/auto-format.sh ~/.claude/hooks/
   chmod +x ~/.claude/hooks/auto-format.sh
   

2. Add to ~/.claude/settings.json:

   {
     "hooks": {
       "PostToolUse": [
         {
           "matcher": "Edit|MultiEdit|Write",
           "hooks": [
             {
               "type": "command",
               "command": "$HOME/.claude/hooks/auto-format.sh"
             }
           ]
         }
       ]
     }
   }
   

See each hook's README for specific configuration.

Using Templates

# Copy and customize
cp templates/HUMAN.md ~/.claude/YOURNAME.md
cp templates/CLAUDE.md ~/.claude/CLAUDE.md

# Edit to match your preferences

Directory Structure

claude-code-toolkit/
├── skills/                    # Packaged workflows
│   ├── brainstorm/
│   ├── handoff/
│   ├── lead/
│   ├── project-wiki/
│   └── ...
├── hooks/                     # Automatic event handlers
│   ├── auto-format/
│   ├── change-summary/
│   └── compaction/
├── templates/                 # Configuration templates
│   ├── HUMAN.md
│   ├── CLAUDE.md
│   └── compaction-strategy.md
├── docs/                      # Documentation site source
└── build.py                   # Skill packager for Claude.ai

Documentation

• Getting Started
• All Skills
• Developer Guide

Development

This project uses uv for dependency management and just as a command runner.

# Install dependencies
just install

# Serve docs locally at http://localhost:8000
just docs-serve

# Deploy docs to GitHub Pages
just docs-deploy

# Package a skill
just package brainstorm

# See all commands
just

Contributing

See CONTRIBUTING.md for guidelines on submitting skills, hooks, or improvements.

License

MIT License. See LICENSE.md for details.