claude-dev-toolkit

Comprehensive guide for optimizing Claude Code workflows and effectiveness. Use when writing or improving CLAUDE.md files, managing context windows, crafting effective prompts, running parallel sessions, debugging workflow issues, or improving Claude Code productivity. Covers the explore-plan-code workflow, verification strategies, context management, prompt engineering, session management, and scaling with parallel sessions. Trigger phrases: "best practices", "CLAUDE.md", "context management", "context window", "prompt engineering", "parallel sessions", "Claude Code tips", "effective workflow", "explore-plan-code", "verification strategies", "session management", "fan out", "headless mode", "subagents", "course correct", "rewind".

Comprehensive troubleshooting guide for diagnosing and fixing Claude Code issues across installation, runtime, and plugin systems. Use when troubleshooting Claude Code issues, fixing installation problems, resolving runtime errors, debugging plugin issues, or diagnosing configuration problems. Trigger phrases: "troubleshoot", "not working", "error", "installation issue", "permission denied", "plugin not loading", "skill not triggering", "hook not firing", "MCP server error", "WSL issue", "npm error", "command not found", "Claude Code problem", "debug", "sandbox error", "socat", "bubblewrap", "authentication issue", "API key", "context window", "search not working", "IDE not detected", "JetBrains", "ripgrep", "doctor", "reset config", "high CPU", "memory usage", "freeze", "hang", "PATH issue", "nvm conflict", "node not found", "Git Bash".

Comprehensive guide for extending Claude Code with custom functionality. Use when deciding how to extend Claude Code, comparing extension mechanisms, creating output styles, or running Claude Code programmatically. Trigger phrases: "extend Claude Code", "which extension", "CLAUDE.md vs skill", "subagent vs team", "output style", "custom output", "programmatic Claude", "Agent SDK", "claude -p", "headless mode", "structured output", "CI/CD integration", "MCP vs skill", "hook vs skill", "plugin packaging".

Comprehensive guide to Claude Code hooks — the system for running shell commands, LLM prompts, or subagents automatically at specific points in Claude Code's lifecycle. Use when creating, configuring, debugging, or understanding Claude Code hooks. Trigger phrases: "create a hook", "hook configuration", "hooks.json", "PreToolUse", "PostToolUse", "SessionStart", "hook events", "hook matchers", "automate with hooks", "prompt hooks", "agent hooks", "hook lifecycle", "UserPromptSubmit", "PermissionRequest", "PostToolUseFailure", "SubagentStart", "SubagentStop", "Stop hook", "TeammateIdle", "TaskCompleted", "PreCompact", "SessionEnd", "Notification hook". Also for blocking dangerous commands, auto-formatting code, desktop notifications, file protection, context re-injection after compaction, async hooks, MCP tool hooks, and hook debugging.

Comprehensive guide for setting up and managing MCP (Model Context Protocol) servers in Claude Code. Use when configuring MCP servers, connecting external services via MCP, setting up .mcp.json files, choosing between stdio/HTTP/SSE transports, authenticating with remote MCP servers, bundling MCP servers in plugins, managing MCP scopes (local/project/user), using MCP resources and prompts, configuring managed MCP for organizations, or troubleshooting MCP connections. Trigger phrases: "MCP server", "Model Context Protocol", ".mcp.json", "connect external service", "MCP in plugin", "stdio transport", "SSE transport", "HTTP transport", "remote MCP", "MCP authentication", "MCP tools", "claude mcp add", "MCP OAuth", "MCP scope", "managed MCP", "MCP tool search", "MCP resources", "MCP prompts".

Comprehensive guide for creating, modifying, testing, releasing, and maintaining Claude Code plugins. Use when creating a plugin, defining plugin structure, writing plugin.json manifests, publishing to marketplaces, installing plugins, setting up plugin directories, distributing plugins to teams, migrating standalone configurations to plugin format, or working with plugin components like skills, agents, hooks, MCP servers, and LSP servers. Trigger phrases: "create a plugin", "plugin structure", "plugin.json", "marketplace", "install plugin", "plugin directory", "distribute plugin", "plugin manifest", "plugin marketplace", "migrate to plugin", "plugin components", "LSP plugin".

Guide for creating, configuring, and distributing Claude Code skills. Use when the user asks about writing skills, creating custom slash commands, building SKILL.md files, skill frontmatter, skill configuration, skill arguments, skill invocation control, skill supporting files, skill templates, skill directory structure, dynamic context injection in skills, subagent skills, context fork, sharing skills via plugins, skill troubleshooting, disable-model-invocation, user-invocable settings, allowed-tools in skills, or extending Claude with custom capabilities. Also triggers for: "create a skill", "write a skill", "new slash command", "custom command", "how do skills work", "skill not triggering", "skill triggers too often", "$ARGUMENTS", "pass arguments to skill".

Comprehensive guide to creating custom subagents and orchestrating agent teams in Claude Code. Use when creating custom subagents, configuring agent teams, understanding built-in subagents, or choosing between subagents and teams. Trigger phrases: "create a subagent", "custom agent", "agent teams", "built-in subagents", "Explore agent", "Plan agent", "agent configuration", "subagent tools", "permission modes", "agent frontmatter", "team coordination", "parallel agents", "delegate mode", "subagent hooks", "agent memory", "Task tool", "spawn teammates", "subagent vs team", "agent team display mode", "tmux agents", "agent team tasks".