skills.rest
0xDarkMatter
0xDarkMatterCOMMUNITY
Explore all skills by this author →
GitHub

claude-code-debug

Diagnose Claude Code extension activation, hooks, agents, and MCP connectivity.

29|6|Updated Nov 27, 2025
Search Tags:#debugging#hooks#agents#extensions#claude-code
One-click install
npx skills add https://github.com/0xDarkMatter/claude-mods --skill claude-code-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-code-debug
Source: https://github.com/0xDarkMatter/claude-mods/tree/main/skills/claude-code-debug
Command: npx skills add https://github.com/0xDarkMatter/claude-mods --skill claude-code-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and fix common Claude Code extension issues, including activation, hooks, and agent loading problems.

Core Features & Use Cases

  • Diagnostics workflow for loading, hooks, and agent delegation
  • Quick fixes and validation steps for common misconfigurations
  • Validation commands and official docs references for deeper troubleshooting

Quick Start

Run claude-code-debug and follow the recommended checks to identify the failing area (skill, hook, agent, or MCP).

Frequently Asked Questions about claude-code-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot Claude Code extensions that aren't loading or activating?▼

Troubleshooting Claude Code extensions involves running diagnostic commands to identify activation failures in skills, hooks, agents, or MCP components. The debug workflow validates configuration, checks permissions, and provides remediation steps specific to each failing area.

What should I check if my Claude Code hooks aren't executing?▼

Hook execution failures often stem from misconfiguration or permission issues. Run the diagnostics workflow to validate hook setup, verify agent delegation paths, and confirm MCP connectivity across your Claude Code CLI workflow.

Can I diagnose MCP connectivity problems in Claude Code?▼

Yes, the debugging workflow includes validation checks and diagnostic commands for MCP components. It identifies connectivity failures, configuration errors, and permission issues, then provides structured remediation steps tied to official documentation.

How do I validate that my Claude Code skills and agents are configured correctly?▼

Use the diagnostics workflow to run validation commands across skills, hooks, agents, and MCP components. It checks for activation problems, loading failures, and configuration mismatches, then recommends quick fixes.

What's the fastest way to fix a failing Claude Code extension?▼

Run the debug workflow to identify which component is failing—skill, hook, agent, or MCP—then apply the recommended validation checks and quick fixes. The structured flow pinpoints the root cause and provides remediation steps.

Related Skills

Explore More Software Engineering Skills→
kivo360kivo360
1

moai-cc-settings-privacy

Configure Claude Code settings.json with permission controls and environment variables.

Community
Advanced
huivrotikihuivrotiki

circleci-automation

Trigger CircleCI pipelines, monitor workflows, and retrieve artifacts via Rube MCP.

Community
Intermediate
ChrisWu0318ChrisWu0318
4

Hooks Automation

Automate pre/post task hooks and memory coordination for Claude Code operations.

Community
Advanced
11547613341154761334

debug

Configure namespace-specific debug logging in JavaScript or TypeScript projects.

Community
Basic