Claude Code Toolkit

A curated collection of skills, agents, commands, and hooks to supercharge your Claude Code experience. Copy what you need to ~/.claude/ and start using immediately.

Prerequisites

Before installation, ensure you have:

• jq - Required for statusline JSON parsing and settings management
• git - Recommended for git workflow features
• uv - Required for Python scripts (auto-installs dependencies via PEP 723)
• Platform-specific:
  • macOS: coreutils (for gtac command used by statusline)
  • Linux: coreutils (usually pre-installed, provides tac command)

The automated installer will detect and offer to install missing dependencies.

Automatic Installation (Recommended)

The easiest way to install the toolkit is using the interactive installer:

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

# Run the installer (auto-detects macOS or Linux)
./install.sh

Interactive Installation Modes

The installer offers flexible installation options:

1. Install All (Recommended)

• One-click installation of all components
• Fastest and simplest option
• Installs: skills, agents, commands, hooks, statusline, and settings

2. Select by Folder

• Choose which component types to install
• For each folder (skills/agents/commands/hooks), you can:
  • All - Copy all items in that folder
  • One-by-one - Review and select each item individually
  • Skip - Skip that entire folder
• Perfect for customizing your installation

3. Skip Installation

• Exit without copying anything
• Useful if you just want to browse the code

What the Installer Does

• ✓ Checks for required dependencies (jq, git, coreutils, pip)
• ✓ Offers to install missing packages via package manager
• ✓ Creates necessary directories (~/.claude/*)
• ✓ Replaces existing skill folders (ensures clean updates, no file conflicts)
• ✓ Copies selected components with detailed logging
• ✓ Installs Python scripts (dependencies auto-managed by uv)
• ✓ Sets up statusline with proper permissions
• ✓ Installs damage-control security hooks (protects .env, credentials, blocks destructive commands)
• ✓ Installs concise-mode hook (brief responses, toggleable with /concise)
• ✓ Intelligently merges settings.json (preserves your existing settings)
• ✓ Configures Perplexity API key (searches environment and shell configs, or prompts for key)
• ✓ Automatically backs up hooks.json and settings.json to .bak files

Platform-Specific Installers

You can also run the platform-specific installer directly:

# For macOS
./install-mac.sh

# For Linux
./install-linux.sh

Non-Interactive Installation

Both installers support command-line options for non-interactive use:

# Install everything non-interactively
./install-linux.sh -y

# Install all, skip update check
./install-linux.sh -y --no-update

# Install all, skip UV installation (for damage-control)
./install-linux.sh --all --no-uv

# Show help
./install-linux.sh --help

Available options:

Manual Installation

If you prefer manual installation or want selective components:

# Create directories
mkdir -p ~/.claude/{skills,agents,commands,hooks,scripts}

# Copy everything
cp -r skills/* ~/.claude/skills/
cp -r agents/* ~/.claude/agents/
cp -r commands/* ~/.claude/commands/
cp -r scripts/* ~/.claude/scripts/
cp hooks.json ~/.claude/hooks.json
cp statusline.sh ~/.claude/statusline.sh
chmod +x ~/.claude/statusline.sh
chmod +x ~/.claude/scripts/*.py
# Note: Python dependencies are handled by uv (PEP 723 inline metadata)

# Or copy selectively - pick only what you need
cp -r skills/git ~/.claude/skills/
cp agents/git-ops.md ~/.claude/agents/

What's Included

Skills (15)

Skills are modular capabilities that provide domain expertise on demand. They live in ~/.claude/skills/.

...