Claude Code Kit

A curated collection of agents, skills, and settings that supercharge Claude Code. The goal of this kit is to gather battle-tested subagents, reusable skills, and sensible default settings in one place so practitioners can drop them into their local Claude Code environment and immediately boost productivity.

🚀 What's Inside

Component Count Location Installs to
Agents 133 specialized subagents agents/ ~/.claude/agents/
Skills 197 reusable skills skills/ ~/.claude/skills/
Settings Global config + permissions settings/ ~/.claude/
Hooks 4 automation hooks hooks/ ~/.claude/hooks/
  • Agents are role-focused subagents (language experts, reviewers, architects, etc.) that Claude Code can delegate work to.
  • Skills are self-contained capability packages (each with a SKILL.md) that teach Claude how to use a specific tool, library, or workflow.
  • Settings provide a ready-to-use settings.json with environment tuning, permission guardrails, and a status line.

🔧 Installation (user-level / global)

These steps install everything at the user level so the agents, skills, and settings are available across all your projects (Claude Code reads from ~/.claude/ on Linux/macOS and %USERPROFILE%\.claude\ on Windows).

Run the commands from the root of this repository.


Linux / macOS

Dependencies: node ≥ 18 (for hooks) and jq (for the status line). Both are optional if you skip hooks or the status line.

# Debian/Ubuntu
sudo apt install nodejs jq

# macOS
brew install node jq
# 1. Create the target directories if they don't exist
mkdir -p ~/.claude/agents ~/.claude/skills ~/.claude/hooks/pre-tool-use ~/.claude/hooks/post-tool-use ~/.claude/hooks/notification

# 2. Copy all agents
cp -v agents/*.md ~/.claude/agents/

# 3. Copy all skills (each skill is its own directory)
cp -rv skills/* ~/.claude/skills/

# 4. Copy hooks
cp -v hooks/pre-tool-use/*.js ~/.claude/hooks/pre-tool-use/
cp -v hooks/post-tool-use/*.js ~/.claude/hooks/post-tool-use/
cp -v hooks/notification/*.js  ~/.claude/hooks/notification/

# 5. Copy the status line script and make it executable
cp settings/statusline.sh ~/.claude/statusline.sh
chmod +x ~/.claude/statusline.sh

# 6. Copy the platform settings (already points to ~/.claude/statusline.sh)
cp -v settings/settings-bash.json ~/.claude/settings.json

Re-syncing / updates (recommended)

rsync is idempotent — re-run it anytime to pick up updates without clobbering unrelated files:

rsync -av agents/  ~/.claude/agents/
rsync -av skills/  ~/.claude/skills/
rsync -av hooks/   ~/.claude/hooks/
cp settings/statusline.sh ~/.claude/statusline.sh && chmod +x ~/.claude/statusline.sh
rsync -av settings/settings-bash.json ~/.claude/settings.json

Requires jq (brew install jq / apt install jq). git is optional — the script degrades gracefully when not in a repo.


Windows (PowerShell)

Dependencies: node ≥ 18 (for hooks). Install via nodejs.org or:

winget install OpenJS.NodeJS
# 1. Create the target directories if they don't exist
New-Item -ItemType Directory -Force `
  "$env:USERPROFILE\.claude\agents", `
  "$env:USERPROFILE\.claude\skills", `
  "$env:USERPROFILE\.claude\hooks\pre-tool-use", `
  "$env:USERPROFILE\.claude\hooks\post-tool-use", `
  "$env:USERPROFILE\.claude\hooks\notification"

# 2. Copy all agents
Copy-Item agents\*.md "$env:USERPROFILE\.claude\agents\"

# 3. Copy all skills (each skill is its own directory)
Copy-Item skills\* "$env:USERPROFILE\.claude\skills\" -Recurse

# 4. Copy hooks
Copy-Item hooks\pre-tool-use\*.js "$env:USERPROFILE\.claude\hooks\pre-tool-use\"
Copy-Item hooks\post-tool-use\*.js "$env:USERPROFILE\.claude\hooks\post-tool-use\"
Copy-Item hooks\notification\*.js  "$env:USERPROFILE\.claude\hooks\notification\"

# 5. Copy the status line script
Copy-Item settings\statusline.ps1 "$env:USERPROFILE\.claude\statusline.ps1"

# 6. Copy the platform settings and inject your username into path placeholders
$settings = Get-Content settings\settings-powershell.json -Raw
$settings = $settings -replace '<YourName>', $env:USERNAME
$settings | Set-Content "$env:USERPROFILE\.claude\settings.json" -Encoding utf8

Re-syncing / updates (recommended)

robocopy is the Windows equivalent of rsync — safe to re-run, only copies changed files:

robocopy agents  "$env:USERPROFILE\.claude\agents"  *.md /NFL /NDL
robocopy skills  "$env:USERPROFILE\.claude\skills"  /E   /NFL /NDL
robocopy hooks   "$env:USERPROFILE\.claude\hooks"   /E   /NFL /NDL
Copy-Item settings\statusline.ps1 "$env:USERPROFILE\.claude\statusline.ps1" -Force
$settings = Get-Content settings\settings-powershell.json -Raw
$settings = $settings -replace '<YourName>', $env:USERNAME
$settings | Set-Content "$env:USERPROFILE\.claude\settings.json" -Encoding utf8

If you have PowerShell 7 installed, open ~/.claude/settings.json after install and swap powershell for pwsh in the statusLine.command value. Windows Terminal is recommended for correct ANSI / UTF-8 rendering. No jq required — the script uses PowerShell's native JSON parser.


Heads up — settings. Copying settings.json overwrites your existing global Claude Code settings. If you already have a customized file, back it up first:

  • Linux/macOS: cp ~/.claude/settings.json ~/.claude/settings.json.bak
  • Windows: Copy-Item "$env:USERPROFILE\.claude\settings.json" "$env:USERPROFILE\.claude\settings.json.bak"

Then merge by hand instead of overwriting.

Note. The agents/ folder also contains a CLAUDE.md and an AGENTS-REFERENCE.md. These are reference/instruction docs, not agents — you can skip copying them, or copy them deliberately if you want their guidance.

After installing, restart Claude Code (or start a new session). The agents become available for delegation, and skills trigger automatically based on their descriptions.


🤖 Agents

133 subagents grouped by domain. Each links to its definition file.

Meta / Orchestration

Agent Description
grand-architect Meta-orchestrator that plans complex features, breaks down large tasks, and coordinates multiple agents.
tech-lead-orchestrator Senior tech lead that analyzes projects and returns structured task breakdowns for agent coordination.
project-analyst Analyzes unfamiliar codebases to detect frameworks, tech stacks, and architecture for routing.
code-archaeologist Explores and documents unfamiliar, legacy, or complex codebases with full risk/action reports.

Languages & Runtimes

Agent Description
python-pro Type-safe, production-ready Python with modern async patterns and extensive typing.
typescript-pro Advanced TypeScript type system, full-stack development, and build optimization.
javascript-pro Modern ES2023+ JavaScript for browser, Node.js, and full-stack apps.
golang-pro Idiomatic Go for concurrent, high-performance, cloud-native systems.
rust-engineer Rust systems programming with memory safety and zero-cost abstractions.
cpp-pro High-performance modern C++20/23 and template metaprogramming.
java-pro Modern Java 21+ with virtual threads, pattern matching, and Spring Boot 3.x.
java-architect Enterprise Java architecture across the Spring ecosystem and microservices.
csharp-developer ASP.NET Core APIs and cloud-native .NET with clean architecture.
dotnet-core-expert Cloud-native .NET Core microservices with minimal APIs.
dotnet-framework-4.8-expert Legacy .NET Framework 4.8 maintenance and modernization.
php-pro Modern PHP 8.3+ with strong typing and enterprise frameworks.
kotlin-specialist Kotlin coroutines, multiplatform, and Android development.
swift-expert Native iOS/macOS/server-side Swift with advanced concurrency.
elixir-expert Fault-tolerant concurrent systems with OTP and Phoenix.
sql-pro Complex SQL query optimization and schema design across major engines.

Frameworks (Frontend / Backend / Mobile)

Agent Description
react-specialist React 18+ patterns, performance optimization, and server components.
react-coder Simplicity-first React 19 components using internal UI packages.
vue-expert Vue 3 Composition API, reactivity, and Nuxt 3 development.
angular-architect Enterprise Angular 15+ with complex state and micro-frontends.
nextjs-developer Production Next.js 14+ with App Router and server components.
frontend-developer Robust, scalable React frontend components and UX.
fullstack-developer End-to-end feature delivery from database to UI.
backend-developer Scalable API development and microservices.
django-developer Django 4+ apps and REST APIs with async views.
rails-expert Rails apps with Hotwire reactivity and idiomatic patterns.
laravel-specialist Laravel 10+ with Eloquent, queues, and enterprise features.
laravel-backend-expert Laravel backend controllers, services, and Eloquent models.
laravel-eloquent-expert Laravel Eloquent schemas, relationships, and query tuning.
spring-boot-engineer Enterprise Spring Boot 3+ microservices and reactive patterns.
wordpress-master WordPress themes, plugins, headless APIs, and scaling.
mobile-developer Cross-platform mobile with React Native and Flutter.
mobile-app-developer Native and cross-platform iOS/Android development.
flutter-expert Cross-platform Flutter 3+ with custom UI and state management.
electron-pro Electron desktop apps with native OS integration and distribution.
cli-developer Command-line tools with intuitive design and cross-platform support.

Architecture & API Design

Agent Description
architect-reviewer System design validation, architectural patterns, and scalability analysis.
api-designer Scalable, developer-friendly REST and GraphQL API design.
graphql-architect GraphQL schema design, federation, and query performance.
microservices-architect Distributed microservice ecosystems and communication patterns.
websocket-engineer Scalable real-time WebSocket architectures and low-latency messaging.
database-architect Data layer design, technology selection, and schema modeling.

Data & Databases

Agent Description
database-administrator High-availability DBs, performance tuning, and disaster recovery.
database-optimizer Query optimization, indexing, caching, and partitioning.
postgres-pro PostgreSQL performance, replication, and advanced features.
data-engineer Scalable data pipelines, ETL/ELT, and data infrastructure.
data-analyst Business data insights, dashboards, and statistical analysis.
data-scientist Statistical analysis, ML, and data storytelling.
data-researcher Discover, collect, and validate data from multiple sources.

AI / ML

Agent Description
ai-engineer AI system design, model implementation, and production deployment.
ml-engineer Production ML training pipelines, serving, and retraining.
machine-learning-engineer Model deployment, serving infrastructure, and edge inference.
mlops-engineer ML infrastructure, CI/CD, versioning, and experiment tracking.
llm-architect Production LLM systems, fine-tuning, RAG, and inference serving.
nlp-engineer NLP/NLU/NLG with transformer models and production pipelines.
prompt-engineer Design, optimize, and evaluate prompts for production LLMs.
mcp-developer Model Context Protocol server and client development.

Infrastructure / DevOps / Cloud

Agent Description
cloud-architect Multi-cloud (AWS/Azure/GCP) IaC, FinOps, and architecture.
devops-engineer CI/CD, containerization, monitoring, and automation.
deployment-engineer CI/CD pipelines and zero-downtime deployment strategies.
platform-engineer Internal developer platforms, golden paths, and self-service.
kubernetes-architect Cloud-native K8s, GitOps, service mesh, and multi-tenancy.
kubernetes-specialist Production-grade K8s deployments and cluster management.
docker-expert Container image building, optimization, and orchestration.
terraform-engineer Multi-cloud Terraform IaC and state management.
terragrunt-expert Terragrunt orchestration and DRY multi-environment IaC.
azure-infra-engineer Azure infrastructure, Entra ID, Bicep, and PowerShell automation.
network-engineer Cloud/hybrid network design, security, and troubleshooting.
cost-optimizer Cloud cost analysis, resource optimization, and scaling plans.
windows-infra-admin Windows Server, Active Directory, DNS, DHCP, and Group Policy.
iot-engineer Connected device architectures, edge computing, and IoT platforms.

PowerShell / Windows Automation

Agent Description
powershell-5.1-expert PowerShell 5.1 Windows automation with RSAT modules.
powershell-7-expert Cross-platform PowerShell 7+ cloud automation and CI/CD.
powershell-module-architect PowerShell module architecture and reusable automation libraries.
powershell-security-hardening Hardening PowerShell automation and remoting security.
powershell-ui-architect WinForms/WPF/TUI interfaces for PowerShell tools.

Reliability / Operations / Incident Response

Agent Description
sre-engineer SLOs, automation, and resilient self-healing systems.
observability-engineer Monitoring, logging, tracing, and SLI/SLO management.
incident-responder Active security breach and outage response and recovery.
devops-incident-responder Production incident diagnosis and postmortems.
chaos-engineer Controlled failure experiments and resilience validation.
error-detective Diagnose errors, correlate across services, and find root causes.
debugger Diagnose and fix bugs from error logs and stack traces.

Security

Agent Description
security-engineer DevSecOps, cloud security, and zero-trust architecture.
security-auditor Security assessments, compliance validation, and risk management.
security-specialist Mobile (RN/Expo) security audits and OWASP Mobile Top 10.
penetration-tester Authorized offensive testing and vulnerability exploitation.
ad-security-reviewer Active Directory security posture and privilege escalation audit.
compliance-auditor GDPR, HIPAA, PCI DSS, SOC 2, and ISO compliance.

Quality / Review / Testing

Agent Description
code-reviewer Code quality, security, and best-practice review across languages.
senior-code-reviewer Comprehensive senior-level fullstack code review.
qa-expert Test strategy, manual/automated testing, and quality metrics.
test-automator Automated test frameworks and CI/CD test integration.
test-generator Smart test generation for RN/Expo with ROI prioritization.
refactoring-specialist Transform complex/duplicated code while preserving behavior.
legacy-modernizer Incremental legacy migration and technical-debt reduction.
dependency-manager Dependency auditing, conflict resolution, and bundle optimization.

Performance & Build

Agent Description
performance-engineer System optimization, profiling, and scalability engineering.
performance-optimizer Bottleneck identification and workload optimization.
performance-enforcer Bundle size and performance budget tracking for RN/Expo.
performance-prophet Predictive performance analysis for RN/Expo before deployment.
build-engineer Build performance optimization and faster compilation.
dx-optimizer Developer workflow, feedback loops, and DX metrics.
tooling-engineer Developer tools, CLIs, code generators, and IDE extensions.
git-workflow-manager Git workflows, branching strategies, and merge management.

UI / UX / Accessibility / Design

Agent Description
ui-designer Visual interfaces, design systems, and component libraries.
ux-researcher User research, usability testing, and persona development.
accessibility-tester WCAG compliance and assistive-technology testing.
a11y-enforcer WCAG 2.2 accessibility enforcement for RN/Expo apps.
design-token-guardian Detect hardcoded styles and enforce design tokens in RN/Expo.

Documentation

Agent Description
documentation-engineer Documentation-as-code systems and automated generation.
documentation-specialist READMEs, API specs, architecture guides, and user manuals.
technical-writer API references, user guides, and SDK documentation.

Specialized Engineering

Agent Description
fintech-engineer Financial systems, payments, and regulatory compliance.
slack-expert Slack apps, API integrations, and bot security review.

Product / Business / Research

Agent Description
product-manager Product strategy, feature prioritization, and roadmaps.
project-manager Project plans, risk management, and stakeholder coordination.
scrum-master Agile facilitation, ceremonies, and velocity improvement.
business-analyst Business process analysis and requirements gathering.
customer-success-manager Customer health, retention, and lifetime value.
sales-engineer Technical pre-sales, solution architecture, and POCs.
content-marketer SEO content strategy and multi-channel campaigns.
legal-advisor Contracts, compliance, IP strategy, and legal risk.
market-researcher Market analysis, consumer behavior, and opportunity sizing.
competitive-analyst Competitor analysis and competitive positioning.
research-analyst Multi-source research synthesis and trend identification.
trend-analyst Emerging patterns, industry shifts, and future scenarios.
search-specialist Advanced search strategies and targeted information retrieval.
scientific-literature-researcher Evidence-grounded answers from full-text research papers.

🧩 Skills

197 skills, each packaged as a directory containing a SKILL.md (and supporting scripts/templates). Skills trigger automatically based on their descriptions. Grouped below by domain.

Skill Description
caveman Ultra-compressed communication mode (~75% token reduction). Lite / full / ultra / wenyan variants. Trigger: /caveman.
caveman-commit Terse Conventional Commits messages. ≤50-char subject, body only when "why" isn't obvious. Trigger: /caveman-commit.
caveman-compress Compress .md memory files to caveman prose (~46% input-token savings). Backs up originals. Trigger: /caveman-compress <file>.
caveman-help Quick-reference card for all caveman modes, skills, and commands. One-shot display. Trigger: /caveman-help.
caveman-review Ultra-compressed PR review: one line per finding — location, problem, fix. Trigger: /caveman-review.
caveman-stats Show real token usage and estimated savings for the current session via hook. Trigger: /caveman-stats.
cavecrew Decision guide for delegating to caveman-style subagents (~60% smaller tool results vs vanilla agents).
Skill Description
brainstorming Explore intent, requirements, and design before any creative/build work.
writing-plans Turn a spec into a multi-step implementation plan before coding.
executing-plans Execute a written plan in a separate session with review checkpoints.
subagent-driven-development Execute plans with independent tasks in the current session.
dispatching-parallel-agents Handle 2+ independent tasks with no shared state in parallel.
test-driven-development TDD before writing implementation code for features/bugfixes.
systematic-debugging Structured debugging before proposing fixes.
verification-before-completion Require verification commands before claiming work is done.
requesting-code-review Verify work meets requirements before merging.
receiving-code-review Rigorously evaluate review feedback before implementing.
finishing-a-development-branch Decide how to integrate completed work (merge/PR/cleanup).
using-git-worktrees Create isolated workspaces via git worktrees.
using-superpowers Establish how to find and use skills at conversation start.
writing-skills Create, edit, and verify skills before deployment.
skill-creator Create, improve, eval, and benchmark skills.
autoskill Observe workflows via screenpipe and draft new skills.
pi-agent Build with and use the Pi minimal terminal coding harness.
mcp-builder Build high-quality MCP servers (Python FastMCP / TS SDK).
claude-api Reference for the Claude API / Anthropic SDK: model IDs, pricing, params, streaming, tool use.
Skill Description
building-native-ui Build apps with Expo Router: styling, navigation, animations.
native-data-fetching Network requests, React Query/SWR, caching, and offline support.
add-app-clip Add an iOS App Clip target to an Expo app.
expo-api-routes Create API routes in Expo Router with EAS Hosting.
expo-brownfield Integrate Expo/React Native into existing native apps.
expo-cicd-workflows Author EAS workflow YAML for build/deploy pipelines.
expo-deployment Deploy Expo apps to App Store, Play Store, and web.
expo-dev-client Build and distribute Expo development clients.
expo-module Build Expo native modules/views (Swift, Kotlin, TS).
expo-observe Add and query EAS Observe performance metrics.
expo-tailwind-setup Set up Tailwind v4 / NativeWind v5 in Expo.
expo-ui-jetpack-compose Use Jetpack Compose views via @expo/ui.
expo-ui-swift-ui Use SwiftUI views via @expo/ui.
eas-update-insights Check EAS Update health: crash rates, installs, payload size.
upgrading-expo Upgrade Expo SDK versions and fix dependency issues.
use-dom Run web code in a webview via Expo DOM components.
Skill Description
frontend-design Distinctive, intentional visual design for new/existing UI.
web-artifacts-builder Build complex multi-component HTML artifacts (React/Tailwind/shadcn).
web-asset-generator Generate favicons, app icons (PWA), and Open Graph images.
canvas-design Create visual art in PNG/PDF using design philosophy.
algorithmic-art Generative/algorithmic art with p5.js.
theme-factory Style artifacts (slides, docs, HTML) with preset/custom themes.
brand-guidelines Apply Anthropic brand colors and typography to artifacts.
generate-image Generate/edit images with AI (FLUX, Nano Banana 2).
infographics Create professional infographics with AI and iterative refinement.
slack-gif-creator Create animated GIFs optimized for Slack.
[playwright-test-automation](https://github.com/tassiovale/claude-code-kit/blob/main/skills/playwright-t