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

•

开发者工具

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.

主要功能

Permission and execution fix guides for shell-based hooks
4 GitHub stars
Step-by-step diagnostic workflows for CLI hooks and agents
Validation patterns for SKILL.md YAML frontmatter and directory structures
Quick-reference commands for inspecting internal CLI configuration state
Debug mode interpretation for tool permissions and MCP connections

使用场景

Identifying why a custom-built agent or hook isn't triggering in the CLI
Fixing 'Permission Denied' errors and shell script execution failures
Validating the structural integrity of new skills before deployment

关于

主要功能

Permission and execution fix guides for shell-based hooks
4 GitHub stars
Step-by-step diagnostic workflows for CLI hooks and agents
Validation patterns for SKILL.md YAML frontmatter and directory structures
Quick-reference commands for inspecting internal CLI configuration state
Debug mode interpretation for tool permissions and MCP connections

使用场景

Identifying why a custom-built agent or hook isn't triggering in the CLI
Fixing 'Permission Denied' errors and shell script execution failures
Validating the structural integrity of new skills before deployment