Compétences claude-code-debug
🔧
claude-code-debug
Sûr ⚙️
Commandes externes📁
Accès au système de fichiers🔑
Variables d’environnement🌐
Accès réseau
Depurar problemas de Claude Code
Également disponible depuis: 0xDarkMatter
Las extensiones, hooks y agentes de Claude Code a veces dejan de funcionar. Esta skill proporciona guías de solución de problemas paso a paso y comandos de diagnóstico para identificar y corregir rápidamente problemas comunes. Úsala cuando las skills no se carguen, los hooks no se ejecuten o los agentes no se estén utilizando.
Prend en charge: Code(CC)
1
Télécharger le ZIP du skill
2
Importer dans Claude
Allez dans Paramètres → Capacités → Skills → Importer un skill
3
Activez et commencez à utiliser
Tester
Utilisation de "claude-code-debug". My skill is not activating
Résultat attendu:
- Comprueba si el directorio de la skill existe en .claude/skills/skill-name/
- Verifica que SKILL.md existe con la capitalización exacta
- Confirma que el frontmatter YAML comienza y termina con ---
- Asegúrate de que el campo name: coincida exactamente con el nombre del directorio
- Añade palabras clave de activación: Triggers on: keyword1, keyword2
- Run: claude --debug and look for skill loading errors
Utilisation de "claude-code-debug". My hook is not running
Résultat attendu:
- Comprueba si el script es ejecutable: chmod +x script.sh
- Valida settings.json con: jq '.' ~/.claude/settings.json
- Verifica que el matcher distingue mayúsculas y minúsculas: use Bash not bash
- Prueba el script manualmente: echo '{"tool_name":"Test"}' | ./hook.sh
- Run /hooks to see registered hooks
Audit de sécurité
Sûrv3 • 1/16/2026
This skill is a pure documentation resource containing troubleshooting guides, diagnostic command references, and decision trees for Claude Code. All 219 static findings are FALSE POSITIVES - they represent bash command examples in markdown documentation, not executable code. The skill contains no JavaScript/TypeScript code, makes no network calls, and performs no file system operations beyond reading its own markdown files. The allowed-tools field explicitly limits the skill to Bash and Read tools for helping users run diagnostic commands.
5
Fichiers analysés
1,022
Lignes analysées
4
résultats
3
Total des audits
Facteurs de risque
⚙️ Commandes externes (133)
references/common-issues.md:12 references/common-issues.md:13 references/common-issues.md:13 references/common-issues.md:14 references/common-issues.md:15 references/common-issues.md:18-28 references/common-issues.md:28-35 references/common-issues.md:35-44 references/common-issues.md:44-45 references/common-issues.md:45-46 references/common-issues.md:46 references/common-issues.md:46-47 references/common-issues.md:47-51 references/common-issues.md:51-64 references/common-issues.md:64-70 references/common-issues.md:70-71 references/common-issues.md:71-78 references/common-issues.md:78-79 references/common-issues.md:79-89 references/common-issues.md:89 references/common-issues.md:89-90 references/common-issues.md:90 references/common-issues.md:90-94 references/common-issues.md:94-107 references/common-issues.md:107-113 references/common-issues.md:113 references/common-issues.md:113-115 references/common-issues.md:115-123 references/common-issues.md:123-124 references/common-issues.md:124 references/common-issues.md:124-125 references/common-issues.md:125-126 references/common-issues.md:126-129 references/common-issues.md:129-138 references/common-issues.md:138-144 references/common-issues.md:144 references/common-issues.md:144-145 references/common-issues.md:145-154 references/common-issues.md:154 references/common-issues.md:154-155 references/common-issues.md:155-159 references/common-issues.md:159-168 references/common-issues.md:168-174 references/common-issues.md:174-175 references/common-issues.md:175-184 references/common-issues.md:184-185 references/common-issues.md:185-189 references/common-issues.md:189-198 references/common-issues.md:198-202 references/common-issues.md:202-203 references/common-issues.md:203 references/common-issues.md:203-204 references/common-issues.md:204-205 references/common-issues.md:205-208 references/common-issues.md:208 references/common-issues.md:208 references/common-issues.md:208 references/common-issues.md:26 references/common-issues.md:18-28 references/debug-commands.md:7-14 references/debug-commands.md:14-33 references/debug-commands.md:33-43 references/debug-commands.md:43-49 references/debug-commands.md:49-65 references/debug-commands.md:65-77 references/debug-commands.md:77-89 references/debug-commands.md:89-97 references/debug-commands.md:97-111 references/debug-commands.md:111-117 references/debug-commands.md:117-128 references/debug-commands.md:128-134 references/debug-commands.md:134-153 references/debug-commands.md:153-157 references/debug-commands.md:157-166 references/debug-commands.md:166-170 references/debug-commands.md:170-179 references/debug-commands.md:179-185 references/debug-commands.md:185-194 references/debug-commands.md:194-198 references/debug-commands.md:198-207 references/debug-commands.md:207-213 references/debug-commands.md:213-222 references/debug-commands.md:222-226 references/debug-commands.md:226-232 references/debug-commands.md:232-236 references/debug-commands.md:236-248 references/debug-commands.md:248-252 references/debug-commands.md:252-264 references/debug-commands.md:264-270 references/debug-commands.md:270-271 references/debug-commands.md:271-272 references/debug-commands.md:272-273 references/debug-commands.md:273-274 references/debug-commands.md:274-275 references/debug-commands.md:275-276 references/debug-commands.md:231 references/debug-commands.md:226-232 references/troubleshooting-flow.md:7-17 references/troubleshooting-flow.md:17-21 references/troubleshooting-flow.md:21-50 references/troubleshooting-flow.md:50-54 references/troubleshooting-flow.md:54-83 references/troubleshooting-flow.md:83-87 references/troubleshooting-flow.md:87-113 references/troubleshooting-flow.md:113-117 references/troubleshooting-flow.md:117-134 references/troubleshooting-flow.md:134-138 references/troubleshooting-flow.md:138-165 references/troubleshooting-flow.md:165-169 references/troubleshooting-flow.md:169-198 references/troubleshooting-flow.md:198-204 references/troubleshooting-flow.md:204-206 references/troubleshooting-flow.md:206-209 references/troubleshooting-flow.md:209-213 SKILL.md:16-25 SKILL.md:25-32 SKILL.md:32 SKILL.md:32-34 SKILL.md:34-39 SKILL.md:39-47 SKILL.md:47-53 SKILL.md:53-64 SKILL.md:64-68 SKILL.md:68-78 SKILL.md:78-82 SKILL.md:82-92 SKILL.md:92-96 SKILL.md:96-105 SKILL.md:105-116 SKILL.md:116-117 SKILL.md:117-118 SKILL.md:118-122 SKILL.md:122
📁 Accès au système de fichiers (48)
references/common-issues.md:13 references/common-issues.md:60 references/common-issues.md:89 references/common-issues.md:99 references/common-issues.md:191 references/common-issues.md:203 references/common-issues.md:13 references/common-issues.md:60 references/common-issues.md:89 references/common-issues.md:99 references/common-issues.md:154 references/common-issues.md:191 references/common-issues.md:203 references/common-issues.md:164 references/common-issues.md:194 references/debug-commands.md:82 references/debug-commands.md:137 references/debug-commands.md:141 references/debug-commands.md:145 references/debug-commands.md:149 references/debug-commands.md:159 references/debug-commands.md:228 references/debug-commands.md:231 references/debug-commands.md:231 references/debug-commands.md:82 references/debug-commands.md:84 references/debug-commands.md:109 references/debug-commands.md:110 references/debug-commands.md:137 references/debug-commands.md:141 references/debug-commands.md:145 references/debug-commands.md:149 references/debug-commands.md:159 references/debug-commands.md:228 references/debug-commands.md:231 references/debug-commands.md:231 references/troubleshooting-flow.md:91 references/troubleshooting-flow.md:121 references/troubleshooting-flow.md:173 references/troubleshooting-flow.md:179 references/troubleshooting-flow.md:91 references/troubleshooting-flow.md:121 references/troubleshooting-flow.md:173 references/troubleshooting-flow.md:179 SKILL.md:77 SKILL.md:84 SKILL.md:77 SKILL.md:84
🔑 Variables d’environnement (2)
🌐 Accès réseau (5)
Audité par: claude Voir l’historique des audits →
Score de qualité
45
Architecture
100
Maintenabilité
85
Contenu
21
Communauté
100
Sécurité
83
Conformité aux spécifications
Ce que vous pouvez construire
Skill no se carga
Cuando una skill instalada recientemente no se activa a pesar de la estructura de archivos correcta y el frontmatter YAML
Hook no se ejecuta
Cuando los hooks configurados en settings.json no se ejecutan o no bloquean herramientas como se espera
Problemas del servidor MCP
Cuando los servidores Model Context Protocol no se conectan o las herramientas no están disponibles
Essayez ces prompts
Solicitud básica de depuración
My Claude Code skill is not activating. How do I troubleshoot this?
Problema de hook
My hook script is not executing when tools are used. What diagnostic steps should I follow?
Problema de agente
Claude Code is not using my custom agent. How do I verify it is configured correctly?
Depuración de MCP
My MCP server is not connecting. Walk me through the debugging flow to identify the issue.
Bonnes pratiques
- Run 'claude --debug' to see detailed loading and permission information
- Valida todos los archivos JSON con 'jq .' antes de guardar
- Prueba los scripts de hooks manualmente antes de confiar en ellos
Éviter
- Omitir el paso de validación del frontmatter YAML
- Usar rutas relativas en configuraciones de hooks sin $CLAUDE_PROJECT_DIR
- Asumir que una skill se activa sin añadir palabras clave de activación específicas
Foire aux questions
¿Qué herramientas usa esta skill?
La skill usa herramientas Bash y Read para ayudarte a ejecutar comandos de diagnóstico y ver archivos de configuración.
¿Cuáles son los límites de esta skill?
Esta skill solo proporciona orientación. No puede ejecutar comandos en tu sistema ni modificar tus archivos de configuración.
¿Cómo se integra con Claude Code?
La skill se activa cuando describes escenarios de depuración. Proporciona comandos documentados que tú ejecutas.
¿Mis datos están seguros?
Sí. Esta skill solo lee documentación y sugiere comandos. Nunca accede a tus archivos ni envía datos a ningún lugar.
¿Por qué mi hook no se ejecuta?
Causas comunes: script no ejecutable (chmod +x), matcher de nombre de herramienta incorrecto (distingue mayúsculas y minúsculas), JSON inválido en settings.json.
¿En qué se diferencia de la depuración incorporada?
Esta skill proporciona árboles de decisión completos y ejemplos más allá de los comandos básicos /hooks y /agents.