Skip to content

robertguss/claude-code-toolkit

Repository files navigation

Claude Code Toolkit

A collection of skills, hooks, and templates that extend Claude Code with specialized workflows and better defaults.

What's Included

Skills

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

Skill Description
brainstorm Multi-session ideation partner with method catalog
code-documenter Intelligent documentation generation with health tracking
handoff Session continuity documents for picking up where you left off

Book & Writing:

Hooks

Shell scripts that run automatically at specific Claude Code events.

Hook Event Description
auto-format PostToolUse Formats files after edits (ruff, goimports, prettier)
change-summary Stop TypeScript checking + session change summary
compaction PreCompact Injects preservation priorities for better context compaction

Templates

Document templates for configuring how Claude works with you.

Template Purpose
HUMAN.md Relationship document — helps Claude remember who you are
CLAUDE.md Global instructions for all projects
compaction-strategy.md What to preserve during context compaction

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/
│   ├── code-documenter/
│   ├── handoff/
│   └── ...
├── 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

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

License

Personal use. Modify freely.

About

A collection of custom skills that extend Claude's capabilities with specialized workflows, methods, and domain knowledge.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published