Skip to content
/ .claude Public template

The Ultimate Claude Code Toolkit — 119 skills, 59 agents, 84 marketplace repos (5,400+ community skills), 30 commands, 10 hooks. Drop-in ~/.claude config that auto-activates the right resources from your prompt. Zero config required.

License

Notifications You must be signed in to change notification settings

travisjneuman/.claude

Repository files navigation

tjn.claude/ — The Ultimate Claude Code Toolkit

v2.8.0 Platform Website License Use Template

Skills Agents Commands Repos Marketplace Skills Hooks Templates MCP


🚀 What Is This?

A drop-in configuration layer for Claude Code that transforms it from a capable AI assistant into an enterprise-grade development powerhouse.

One git clone gives you 119 domain skills, 59 specialist agents, 84 community marketplaces with 5,400+ additional skills, 30 slash commands, 10 lifecycle hooks, and 12 MCP server configs — all auto-activating based on what you're working on. No manual configuration required.

How it works: Describe what you want in plain language. The toolkit's dynamic router detects context from your prompt and loads the right skills, agents, rules, and checklists automatically. No slash commands needed (though they're available if you prefer).

Who it's for: Developers who use Claude Code and want deeper domain expertise, structured workflows, and quality guardrails without manual setup.


⚡ Quick Start

Use as GitHub Template (Recommended)

Click the green "Use this template" button at the top of this repo to create your own copy with a clean commit history. Then clone your new repo to ~/.claude/.

One-Line Install

Or clone directly if you prefer:

git clone --recurse-submodules https://github.com/travisjneuman/.claude.git ~/.claude

Manual Clone (if submodules fail)

git clone https://github.com/travisjneuman/.claude.git ~/.claude
cd ~/.claude
git submodule update --init --recursive

Verify Installation

# Start Claude Code — the toolkit loads automatically
claude

# Run diagnostics
/health-check

That's it. The toolkit auto-activates from ~/.claude/ on every Claude Code session.


📦 What's Included

Component Count Description
Skills 119 Domain expertise modules (React, security, DevOps, finance, etc.)
Agents 59 Specialist subagents for focused tasks (code review, debugging, etc.)
Commands 30 Slash commands for common workflows (/commit, /review-code, etc.)
Marketplace Repos 84 Community skill repositories (5,400+ additional skills)
Hooks 10 Lifecycle hooks (session start/stop, pre-commit, safety guards)
Templates 17 Project scaffolding and task templates
MCP Servers 12 Model Context Protocol server configurations
Rules 30 Checklists, stack guides, and workflow references
📋 Skills by Category
Category Skills
Web Development react-native, vue-development, svelte-development, flutter-development, pwa-development, electron-desktop, tauri-desktop, frontend-enhancer
Backend & API api-design, graphql-expert, database-expert, microservices-architecture, event-driven-architecture, websockets-realtime, serverless-development
DevOps & Cloud devops-cloud, monitoring-observability, performance-engineering, mobile-cicd
AI & Data ai-ml-development, llm-app-development, data-science
Security application-security, authentication-patterns
Mobile android-development, ios-development, macos-native, kotlin-multiplatform, react-native, flutter-development
Quality generic-code-reviewer, generic-feature-developer, generic-design-system, generic-ux-designer, test-specialist, tdd-workflow, debug-systematic, tech-debt-analyzer
Business business-strategy, finance, marketing, sales, product-management, hr-talent, legal-compliance, risk-management, operations, innovation
Creative brand-identity, graphic-design, video-production, audio-production, ui-animation, ui-research
Productivity codebase-documenter, document-skills, content-repurposer, status-report-generator, core-workflow
Specialized game-development, i18n-localization, seo-analytics-auditor, email-systems, payment-integration, product-analytics, growth-engineering, monetization-strategy
Non-Tech travel-planner, event-planner, recipe-card-creator, health-wellness, career-path-planner, real-estate-analyzer

See MASTER_INDEX.md for the full listing with descriptions.


⚙️ How It Works

Dynamic Routing

Every prompt flows through a routing system that loads the best-fit resources on-demand — drawing from 119 built-in skills, 59 agents, 30 rules/checklists, and 5,300+ community marketplace skills across 84 repos:

 Your prompt
     │
     ▼
 ┌──────────────────────────────┐
 │  CLAUDE.md Auto-Routing      │  ← Keyword detection table
 │  (always loaded)             │
 └──────────┬───────────────────┘
            │
   ┌────────┼────────┬───────────────┐
   ▼        ▼        ▼               ▼
┌──────┐ ┌──────┐ ┌──────┐ ┌──────────────┐
│Skills│ │Rules │ │Agents│ │ Marketplace  │
│(119) │ │& Chk │ │ (59) │ │  84 repos    │
│      │ │      │ │      │ │  5,400+ more │
└──────┘ └──────┘ └──────┘ └──────────────┘

Example: Type "review this React component for security issues" and the router automatically loads the React/TypeScript stack guide, the security hardening checklist, and spawns the code reviewer agent — without any slash commands.

Auto-Routing Table (from CLAUDE.md)

Your prompt mentions... Toolkit loads...
React, TypeScript React/TS stack guide + React skills
Security, OWASP, auth Security checklist + auth patterns
Deploy, CI/CD Deployment workflow + DevOps skill
Database, schema Database design checklist
Performance, optimize Performance checklist
UI, visual, CSS UI/visual changes checklist
Test, testing Verification template + test specialist
Research, investigate Research methodology workflow
Any specialized domain Best-fit skill from MASTER_INDEX + marketplace (5,400+ skills)
Installed plugins Active agents, commands, and skills from community repos

Hook Lifecycle

Hooks run automatically at key points in every session:

Session Start
  ├── Pull all repos (background, 60s timeout)
  └── Load previous session context

Every Prompt
  └── Inject git branch + status into context

Before Bash Commands
  ├── Block dangerous commands (rm -rf /, force push, etc.)
  └── Update doc counts before git commit

After File Edits
  └── Scan for leaked secrets

Session Stop
  └── Save session summary for next time

See hooks/README.md for the full hook reference.


🔑 Key Features

🏪 Marketplace — 84 repos, 5,400+ skills

The toolkit aggregates 84 community skill repositories as git submodules in plugins/marketplaces/. All are read-only (fetch but never push). Skills span security (Trail of Bits), full-stack development, scientific computing, SAP/enterprise, Elixir, Terraform, creative writing, and more. Some marketplace repos are installed as plugins, making their agents, commands, and skills fully active in the routing system alongside built-in resources. Non-installed repos contribute discoverable skills via keyword search.

# Search marketplace skills
find ~/.claude/plugins/marketplaces -name "SKILL.md" | xargs grep -li "kubernetes"

# Update all marketplace repos
bash ~/.claude/_pull-all-repos.sh

See docs/MARKETPLACE-GUIDE.md for the full catalog.

🛡️ Safety Guards

The guard-dangerous.sh hook blocks dangerous commands before execution:

Blocked Pattern Risk
rm -rf / / rm -rf ~ Filesystem destruction
git push --force Overwrite remote history
DROP TABLE / TRUNCATE TABLE Database destruction
git reset --hard origin Discard all local changes
git clean -fd Delete untracked files
curl ... | sh Pipe-to-shell (RCE)
npm publish Accidental package publication
chmod -R 777 Overly permissive permissions
docker system prune -a Destroy all Docker resources

Additional safety: pre-write-validate.sh blocks writes to .env, .ssh, .gnupg, *.pem, and *.key files. secret-scan.sh scans every file edit for leaked API keys and tokens.

🖥️ Cross-Platform

All hooks use a Node.js-based runner (hooks/run-hook.js) that resolves paths via os.homedir(). This avoids WSL path issues on Windows where ~ resolves to /root/ instead of the Windows user home.

On Windows, the runner explicitly prefers Git Bash (C:\Program Files\Git\usr\bin\bash.exe) over WSL bash to prevent drive mount failures on network drives.

Platform Shell Notes
macOS /bin/bash Standard bash via Git or Homebrew
Linux /bin/bash Standard bash
Windows Git Bash (preferred) Avoids WSL drive mount errors
🤖 Agent Teams

For complex tasks, spawn multiple specialist agents to work in parallel:

  • Code review from multiple angles — security, performance, tests
  • Cross-layer features — frontend + backend + database agents
  • Competing hypotheses — debug with parallel investigation

Agent types include architecture analysts, debugging specialists, performance optimizers, security auditors, test generators, and 50+ more. See agents/README.md.

🔌 MCP Servers

12 MCP server configurations available (all disabled by default for token efficiency):

Server Purpose
sequential-thinking Structured reasoning chains
playwright Browser testing & automation
memory Persistent memory across sessions
sqlite / postgres Database operations
github / git Enhanced GitHub/git operations
chrome-devtools Browser debugging & profiling
context7 Enhanced context retrieval

Enable on-demand via /mcp. See docs/MCP-SERVERS.md.

🔄 Session Continuity

The toolkit maintains context between sessions automatically:

  1. Session stopsession-stop-summary.sh saves working directory, branch, recent commits, active tasks, and pending todos to ~/.claude/last-session.md
  2. Session startsession-start-context.sh injects the previous session context (if < 24 hours old)
  3. Repo syncsession-start-pull.sh pulls all repos in the background on startup

🛠️ Configuration

Key Files

File Purpose
CLAUDE.md Core rules, auto-routing table, code standards
settings.json Claude Code settings, hook registrations, permissions
.mcp.json MCP server definitions
counts.json Resource counts (source of truth)
plugin.json Plugin metadata

Common Customizations

Add your own project directories to auto-pull:

cp ~/.claude/.env.example ~/.claude/.env.local
# Edit CUSTOM_PROJECT_DIRS="/path/to/your/projects"

Switch action mode between proactive (default) and conservative — see rules/workflows/action-policy.md.

Disable a hook — edit settings.json and remove the hook entry.


🖥️ Multi-Machine Setup

The toolkit uses a two-layer architecture:

  1. This repo (~/.claude/) — Shared configuration, cloned on every machine
  2. Machine-specific (.env.local, known_marketplaces.json) — Gitignored, per-device

New Device Setup

git clone --recurse-submodules https://github.com/travisjneuman/.claude.git ~/.claude
cp ~/.claude/.env.example ~/.claude/.env.local
# Edit .env.local with machine-specific paths
bash ~/.claude/scripts/fix-marketplace-paths.sh

See docs/NEW-DEVICE-SETUP.md for the full walkthrough.


💻 Platform Support

Platform Status Shell Notes
macOS Full support bash/zsh Notifications via osascript
Linux Full support bash Notifications via notify-send
Windows 11 Full support Git Bash Hooks use Node.js runner to avoid WSL issues
WSL Works bash Native Linux behavior inside WSL

Requirements: Node.js (comes with Claude Code), Git, bash (Git Bash on Windows).


🆕 What's New in v2.8.0

Released February 11, 2026.

  • P0 fix: Resolved invalid JSON in settings.json that caused auto-compact and hook failures on Opus 4.6
  • Hook registration: Registered missing hooks (pre-commit-counts.sh, secret-scan.sh)
  • Token optimization: Removed redundant CLAUDE.md sections, consolidated bash permissions (20 entries → 2 wildcards)
  • Cross-platform fix: Hook runner now prefers Git Bash on Windows to avoid WSL drive mount errors
  • Streamlined commands: start-task.md reduced from 296 → 156 lines

See CHANGELOG.md for the full history.


📚 Documentation

Document Description
CLAUDE.md Core rules and auto-routing table
CHANGELOG.md Version history
Architecture System design and component interactions
Setup Guide First-time installation walkthrough
New Device Setup Multi-machine configuration
Workflow Guide Development workflow patterns
Marketplace Guide Community skill catalog
Agent Teams Multi-agent coordination
Auto-Claude Guide Autonomous coding framework
MCP Servers MCP server reference
Configuration Full settings.json reference
Folder Structure Directory layout and purpose
Skills Index All 119 skills with descriptions
Agents Index All 59 agents with descriptions

💡 Philosophy

This toolkit follows three core principles:

  1. Everything activates dynamically. Describe what you want — the system loads what's needed. No memorizing commands.
  2. Token efficiency over completeness. Domain content loads on-demand, not upfront. Unused skills cost zero tokens.
  3. Safety by default. Dangerous commands are blocked, secrets are scanned, protected files are guarded — all before you make a mistake.

Maintained by Travis Neuman · claude.travisjneuman.com · MIT License

About

The Ultimate Claude Code Toolkit — 119 skills, 59 agents, 84 marketplace repos (5,400+ community skills), 30 commands, 10 hooks. Drop-in ~/.claude config that auto-activates the right resources from your prompt. Zero config required.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages