claude-mods

 ██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗    ███╗   ███╗ ██████╗ ██████╗ ███████╗
██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝    ████╗ ████║██╔═══██╗██╔══██╗██╔════╝
██║     ██║     ███████║██║   ██║██║  ██║█████╗      ██╔████╔██║██║   ██║██║  ██║███████╗
██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝      ██║╚██╔╝██║██║   ██║██║  ██║╚════██║
╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗    ██║ ╚═╝ ██║╚██████╔╝██████╔╝███████║
 ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝    ╚═╝     ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝

A comprehensive extension toolkit that transforms Claude Code into a specialized development powerhouse.

claude-mods is a production-ready plugin that extends Claude Code with 22 expert agents, 42 specialized skills, and modern CLI tools designed for real-world development workflows. Whether you're debugging React hooks, optimizing PostgreSQL queries, or building production CLI applications, this toolkit equips Claude with the domain expertise and procedural knowledge to work at expert level across multiple technology stacks.

Built on Anthropic's Agent Skills standard, claude-mods fills critical gaps in Claude Code's capabilities: persistent session state that survives across machines, on-demand expert knowledge for specialized domains, token-efficient modern CLI tools (10-100x faster than traditional alternatives), and proven workflow patterns for TDD, code review, and feature development. The toolkit implements Anthropic's recommended patterns for long-running agents, ensuring your development context never vanishes when sessions end.

From Python async patterns to Rust ownership models, from AWS Fargate deployments to Craft CMS development - claude-mods provides the specialized knowledge and tools that transform Claude from a general-purpose assistant into a domain expert who understands your stack, remembers your workflow, and ships production code.

22 agents. 42 skills. 3 commands. One install.

Recent Updates

v1.6.0 (February 2026)

• 🚀 NEW: Tech Debt Scanner - Automated detection using parallel subagents (1,520 lines)
  • Always-parallel architecture for fast analysis (2-15s depending on scope)
  • 4 categories: Duplication, Security, Complexity, Dead Code
  • Session-end workflow: catch issues while context is fresh
  • Language-smart: Python, JS/TS, Go, Rust, SQL with AST-based detection
  • Boris Cherny's recommendation: "Build a /techdebt slash command and run it at the end of every session"

v1.5.2 (February 2026)

• 🆕 Added cli-patterns, screenshot, skill-creator skills (+3 skills, now 42 total)
• 📚 Enhanced skill-creator with official Anthropic docs and best practices (+554 lines)
• 🐛 Fixed /sync filesystem scanning issue on Windows (Git Bash compatibility)

View full changelog →

Why claude-mods?

Claude Code is powerful out of the box, but it has gaps. This toolkit fills them:

• Session continuity — Tasks vanish when sessions end. We fix that with /save and /sync, implementing Anthropic's recommended pattern for long-running agents.

• Expert-level knowledge on demand — 22 specialized agents covering React, TypeScript, Python, Go, Rust, AWS, PostgreSQL, and more. Each agent is deeply researched with real-world patterns, not generic advice.

• Modern CLI tools — Stop using grep, find, and cat. Our rules automatically prefer ripgrep, fd, eza, and bat — 10-100x faster and token-efficient.

• Smart web fetching — A fallback hierarchy that actually works: WebFetch → Jina Reader → Firecrawl. No more "I can't access that URL."

• Workflow patterns — TDD cycles, code review, feature development, debugging — all documented with Anthropic's best practices.

Key Benefits

• Persistent task state — Pick up exactly where you left off, even across machines
• Domain expertise — Agents trained on framework docs, not just general knowledge
• Token efficiency — Modern CLI tools produce cleaner output, saving context window
• Team sharing — Git-trackable state files work across your whole team
• Production-ready — Validated test suite, proper plugin format, comprehensive docs
• Extended thinking — Built-in guidance for "think hard" and "ultrathink" triggers
• Zero lock-in — Standard Claude Code plugin format, toggle on/off anytime

Structure

claude-mods/
├── .claude-plugin/     # Plugin metadata
├── agents/             # Expert subagents (22)
├── commands/           # Slash commands (3)
├── skills/             # Custom skills (42)
├── output-styles/      # Response personalities
├── hooks/              # Hook examples & docs
├── rules/              # Claude Code rules
├── tools/              # Modern CLI toolkit installers
├── scripts/            # Plugin install scripts
├── tests/              # Test suites + justfile
├── docs/               # Project docs (PLAN.md, DASH.md)
└── templates/          # Extension templates

Installation

Plugin Install (Recommended)

# Step 1: Add the marketplace
/plugin marketplace add 0xDarkMatter/claude-mods

# Step 2: Install the plugin
/plugin install claude-mods@0xDarkMatter-claude-mods

This installs globally (available in all projects). Toggle on/off with /plugin menu.

Script Install

Linux/macOS:

git clone https://github.com/0xDarkMatter/claude-mods.git
cd claude-mods
./scripts/install.sh

Windows (PowerShell):

git clone https://github.com/0xDarkMatter/claude-mods.git
cd claude-mods
.\scripts\install.ps1

The install scripts:

• Copy commands, skills, agents, rules to ~/.claude/
• Clean up deprecated items (e.g., old /conclave command)
• Handle command→skill migrations (won't create duplicates)

CLI Tools (Optional)

Install modern CLI tools (fd, rg, bat, etc.) for better performance:

# Windows (Admin PowerShell)
.\tools\install-windows.ps1

# Linux/macOS
./tools/install-unix.sh

Skill Architecture

All skills follow Anthropic's official pattern with consistent structure:

skill-name/
├── SKILL.md              # Core workflow (< 500 lines)
├── scripts/              # Executable code (optional)
├── references/           # Documentation loaded as needed (optional)
└── assets/               # Output templates/files (optional)

Progressive Loading:

1. Metadata (name + description) - Always in context (~100 words)
2. SKILL.md body - Loaded when skill triggers (<5k words)
3. Bundled resources - Loaded only when Claude needs them

All skills have the complete directory structure, even if scripts/, references/, or assets/ are currently empty. This ensures consistency and makes it easy to add bundled resources later.

See skill-creator for the complete guide.

What's Included

Commands

| Command | Description | |---------|-------------| | sync | Session bootstrap - read project context, restore saved state, show status. | | save | Save session state - persist tasks, plan content, and git context. | | canvas | Terminal canvas for content drafting with live markdown preview. Requires Warp terminal. (Experimental) |

Skills

Pattern Reference Skills

| Skill | Description | |-------|-------------| | cli-patterns | Production CLI tool patterns - agentic workflows, stream separation, semantic exit codes, OS keyring auth | | rest-patterns | HTTP methods, status codes, REST design patterns | | tailwind-patterns | Tailwind utilities, responsive breakpoints, config | | sql-patterns | CTEs, window functions, JOIN patterns, indexing | | sqlite-ops | SQLite schemas, Python sqlite3/aiosqlite patterns | | mcp-patterns | MCP server structure, tool handlers, resources |

CLI Tool Skills

| Skill | Description | |-------|-------------| | file-search | Find files with fd, search code with rg, select with fzf | | find-replace | Modern find-and-replace with sd | | code-stats | Analyze codebase with tokei and difft | | data-processing | Process JSON with jq, YAML/TOML with yq | | markitdown | Convert PDF, Word, Excel, PowerPoint, images to markdown | | structural-search | Search code by AST structure with ast-grep |

Workflow Skills

| Skill | Description | |-------|-------------| | tool-discovery | Recommend agents and skills for any task | | git-workflow | Enhanced git operations with lazygit, gh, delta | | doc-scanner | Scan and synthesize project documentation | | project-planner | Track stale plans, suggest session commands | | python-env | Fast Python environment management with uv | | task-runner | Run project commands with just | | screenshot | Find and display recent screenshots from common screenshot directories |

Development Skills

| Skill | Description | |-------|-------------| | [skill-creator](skills/skill-creator/