skills.rest
juanandresgs
juanandresgsCOMMUNITY
Explore all skills by this author →
Website𝕏@juanandres_gsGitHub

diagnose

Validates hook integrity, state files, and Git health for Claude Code configuration.

191|29|Updated Sep 2, 2025
Search Tags:#state management#troubleshooting#validation#hooks#diagnostics#system health
One-click install
npx skills add https://github.com/juanandresgs/claude-ctrl --skill diagnose-juanandresgs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/juanandresgs/claude-ctrl/tree/main/skills/diagnose
Command: npx skills add https://github.com/juanandresgs/claude-ctrl --skill diagnose-juanandresgs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a comprehensive health check for the Claude Code hook and state management system, ensuring all components are functioning correctly and catching potential issues before they impact workflows.

Core Features & Use Cases

  • Hook Integrity Validation: Verifies that all scripts referenced in settings.json exist and are executable.
  • State File Consistency: Checks the format and integrity of various state files like .plan-drift, .proof-status, and .test-status.
  • System Health Check: Assesses the overall health of the Claude Code environment, including Git status and plan file consistency.
  • Use Case: Run this skill after making configuration changes or when experiencing unexpected behavior in your Claude Code hooks to quickly identify and resolve problems.

Quick Start

Run the diagnostic script to check the integrity of your hooks and state files.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I validate Claude Code hook integrity and state file consistency?▼

To validate Claude Code hook integrity, run a diagnostic script that checks hook script existence, executability, shared library syntax, and state file formats within the ~/.claude configuration directory.

What does a system health check for the ~/.claude configuration directory include?▼

A system health check for the ~/.claude directory includes verifying settings consistency, MASTER_PLAN.md status, Git health, and the structural integrity of state files like .plan-drift and .proof-status.

Why does my Claude Code hook script fail to execute properly?▼

Your Claude Code hook script might fail if the referenced file in settings.json lacks executability, contains shared library syntax errors, or if associated state files have corrupted formats.

When should I run a diagnostic check on my Claude Code state management system?▼

You should run a diagnostic check on your state management system after making configuration changes or when experiencing unexpected behavior in your Claude Code hooks to quickly identify and resolve problems.

Can I check Git status and MASTER_PLAN.md consistency with a single diagnostic script?▼

Yes, you can check Git status and MASTER_PLAN.md consistency simultaneously by running a comprehensive diagnostic script that assesses the overall health of your Claude Code environment.

Related Skills

Explore More Software Engineering Skills→
yoshisadayoshisada

wheel-init

Scaffold the wheel runtime with workflows and hook configuration.

Community
Intermediate
mengsi16mengsi16
1

crystallize-lint

Audit crystallized index and skill markdowns for health and consistency.

Community
Advanced
pextacypextacy

hud

Display and configure OMX HUD status from .omx/state files.

Community
Intermediate
NominexHQNominexHQ
15

pmm-status

Report PMM memory repository health with git logs, config data, and file stats.

Official
Intermediate