everything-claude-code

Claude Code Base

A comprehensive, unified Claude Code configuration repository combining best practices from several Claude Code orchestration systems. It is recommended to pick & choose what is relevant to your scope and use-case.

Description

Claude Code Base is an all-in-one configuration package for Claude Code that includes:

• 199+ Skills - Workflow automation for coding standards, testing, security, deployment, and domain-specific tasks
• 40+ Commands - Slash commands for quick access to common operations
• Hooks - Automated workflow triggers for continuous learning and optimization
• Rules - Coding standards for TypeScript, Python, Go, Swift, and more
• Agents - Specialized sub-agents for planning, coding, reviewing, security, and more
• MCP Configurations - Model Context Protocol server setups
• Plugin System - Full plugin infrastructure for extensibility

Quick Start

Prerequisites

• Claude Code installed (npm install -g @anthropic-ai/claude-code)
• Node.js 18+
• Git

macOS (Apple Silicon / Intel)

macOS is fully supported. Install prerequisites with Homebrew:

# Install Homebrew if not already installed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js 20+ via nvm (recommended)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc   # or ~/.bash_profile
nvm install 20 && nvm use 20

# Or via Homebrew
brew install node

# Install Claude Code CLI
npm install -g @anthropic-ai/claude-code

Note for Apple Silicon (M1/M2/M3): All Node.js tooling runs natively via arm64. No Rosetta 2 needed for this project.

Linux / WSL2

Standard Linux prerequisites apply. See the Installation section below.

Installation

If ~/.claude/ already exists (i.e., Claude Code is already configured), use the Selective Installation steps instead of cloning into ~/.claude/ directly.

# Clone the repository
git clone https://github.com/nbossn/claude-code-base.git ~/.claude/

# Install dependencies
cd ~/.claude
npm install

# Run the setup script (installs rules for one or more languages)
./install.sh typescript python

Basic Usage

# Use a skill
/skill-name

# Use a command
/command-name

# Trigger an agent
@agent-type task description

# Run a hook manually
claude hook run hook-name

Tools with Usage Examples

Skills

Skills are comprehensive workflow definitions. Use /skill-name to invoke:

# Development workflows
/tdd              # Test-driven development
/code-review      # Code review process
/refactor-clean   # Clean up dead code

# Specialized domains
/security-review  # Security analysis
/api-design       # REST API design patterns
/postgres-patterns # PostgreSQL optimization

# Advanced agents
/sparc-methodology # SPARC implementation
/swarm-orchestration # Multi-agent coordination
/v3-performance-optimization # Performance tuning

Commands

Slash commands for quick actions:

/plan             # Create implementation plan
/eval             # Run evaluation harness
/claw             # Start NanoClaw session
/projects         # List known projects
/learn            # Extract patterns from session
/promote          # Promote instincts globally
/model-route      # Route task to optimal model
/verify           # Run verification checks

Agents

Specialized sub-agents for delegation:

@planner          # Create detailed implementation plans
@coder            # Write clean, efficient code
@reviewer         # Comprehensive code review
@security-reviewer # Security vulnerability detection
@tester           # Generate and run tests
@architect        # System design and architecture
@researcher       # Deep research and analysis
@performance-engineer # Performance optimization

Hooks

Automated triggers:

• pre-task - Before task execution
• post-task - After task completion
• pre-edit - Before file edits
• post-edit - After file modifications
• session-end - Before session closes
• auto-tmux-dev - Development environment setup
• learn-eval - Pattern extraction

Rules

Language-specific coding standards:

• rules/typescript/ - TypeScript best practices
• rules/python/ - Pythonic idioms
• rules/golang/ - Go patterns
• rules/swift/ - Swift conventions
• rules/common/ - Language-agnostic rules

Installation

Full Installation

# 1. Clone repository
git clone https://github.com/nbossn/claude-code-base.git ~/.claude

# 2. Navigate to directory
cd ~/.claude

# 3. Install dependencies
npm install

# 4. Run installer (specify one or more languages)
./install.sh typescript python

# 5. Configure Claude Code
# Edit ~/.claude/settings.json as needed

Selective Installation

Use this approach when ~/.claude/ already exists (Claude Code is already set up):