Agent skill · software engineering · aiskillstore
claude-code-debug
Troubleshoot Claude Code extensions and behavior. Triggers on: debug, troubleshoot, not working, skill not loading, hook not running, agent not found.
Why this skill is useful
Provides specific commands and troubleshooting steps for debugging Claude Code extensions that the AI wouldn't reliably generate on its own.
What it needs
Requires jq installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Claude Code Debug Troubleshoot extensions, hooks, and unexpected behavior. Quick Diagnostics Common Issues Symptom Quick Check --------- ------------- Skill not activating Verify description has trigger keywords Hook not running Check chmod +x, run /hooks Agent not delegating Add "Use proactively" to description MCP connection fails Test server manually with npx Permission denied Check settings.json allow rules Debug Mode Output Quick Fixes Skill Not Loading Hook Not Executing Agent Not Being Used Validation Official Documentation https://code.claude.com/docs/en/hooks - Hooks reference https://code.claude.com/docs/en/skills - Skills reference https://code.claude.com/docs/en/sub-agents - Custom subagents https://code.claude.com/docs/en/settings - Settings configuration Additional Resources ./references/common-issues.md - Issue → Solution lookup table ./references/debug-commands.md - All inspection commands ./references/troubleshooting-flow.md - Decision tree --- See Also: claude-code-hooks for hook debugging, claude-code-templates for correct structure
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/claude-code-debug