How can I verify which hooks are currently active?

Use the internal '/hooks' command within the Claude Code interface to view a list of all registered hooks and their current status.

What should I do if my custom agent isn't being delegated tasks?

Ensure the agent's description includes keywords like 'Use for:' or 'Use proactively' and verify the file is placed in the correct .claude/agents/ directory.

How do I enable debug mode in Claude Code?

You can run the command 'claude --debug' to see detailed logs regarding hook execution, skill loading status, and tool permission decisions.

Why isn't my custom skill loading in the CLI?

Check that your skill directory contains a SKILL.md file with valid YAML frontmatter and ensure the 'name' field in the metadata matches the directory name.

Claude Code Debug

Name: Claude Code Debug
Author: 0xDarkMatter

by0xDarkMatter

•

Developer Tools

Troubleshoots and resolves configuration issues with Claude Code extensions, hooks, and custom agents.

Claude Code Debug is a specialized utility designed to diagnose and fix common environment and configuration errors within the Claude Code CLI. It provides developers with actionable patterns for resolving issues such as non-responsive hooks, missing agents, and skill loading failures by validating YAML frontmatter, checking file permissions, and interpreting debug mode output. Whether you are debugging MCP server connections or verifying tool permission decisions, this skill ensures your custom AI workflow remains stable and functional.

Key Features

01Permission and execution fix guides for shell-based hooks

024 GitHub stars

03Step-by-step diagnostic workflows for CLI hooks and agents

04Validation patterns for SKILL.md YAML frontmatter and directory structures

05Quick-reference commands for inspecting internal CLI configuration state

06Debug mode interpretation for tool permissions and MCP connections

Use Cases

01Identifying why a custom-built agent or hook isn't triggering in the CLI

02Fixing 'Permission Denied' errors and shell script execution failures

03Validating the structural integrity of new skills before deployment

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add 0xdarkmatter/claude-mods claude-code-debug

For use in Claude.ai and ChatGPT

Download Skill