source-command-verify-setup

Runs the infrastructure health check script and repairs reported failures.

10.0k|1.2k|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/diet103/claude-code-infrastructure-showcase --skill source-command-verify-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: source-command-verify-setup
Source: https://github.com/diet103/claude-code-infrastructure-showcase/tree/main/.agents/skills/source-command-verify-setup
Command: npx skills add https://github.com/diet103/claude-code-infrastructure-showcase --skill source-command-verify-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After migrating Claude Code infrastructure (hooks, skills, settings) into a project, misconfigurations like missing dependencies, non-executable scripts, or invalid JSON silently break automation. This Skill runs the verify-setup health check and fixes every reported failure until the setup is fully green.

Core Features & Use Cases

  • Automated Health Check: Executes the verify-setup.sh script from the project root and parses [FAIL] and [WARN] output lines.
  • Guided Failure Repair: Applies known fixes such as installing hook dependencies with npm, restoring executable permissions with chmod, and repairing JSON syntax errors in settings.json or skill-rules.json.
  • Use Case: After copying the .claude infrastructure into a new project, run this Skill to discover that hook dependencies are missing and a trailing comma broke skill-rules.json, fix both, and confirm zero failures.

Quick Start

Ask the assistant to run the infrastructure health check and fix everything that fails until the setup reports zero errors.

Frequently Asked Questions about source-command-verify-setup

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

FAQPage Schema
How do I verify my Claude Code infrastructure setup is working?

Run the verify-setup.sh script from the project root, which checks hook dependencies, script permissions, and JSON configuration validity. This Skill executes the script, interprets each FAIL line, and applies the printed fix until the check reports zero failures.

How do I fix invalid JSON in settings.json or skill-rules.json?

Read the file, locate the syntax error (usually a trailing comma), and repair it without changing any setting values. The Skill re-runs the health check after each fix to confirm the JSON parses correctly.

Why are my hook scripts not running after migration?

Hook scripts commonly fail because dependencies were not installed or the scripts lost executable permissions during copying. Fix this by running npm install in the hooks directory and chmod +x on the shell scripts.

Should I fix WARN lines from the health check?

WARN lines indicate optional features like session intelligence, jq-based file tracking, or AI classification keys. The Skill does not install API keys or system packages automatically; it summarizes each warning so the user can decide.

What happens when registered hook scripts are missing?

When settings.json registers hook scripts that do not exist, the Skill asks the user whether to copy them from the showcase repository or remove the dead registrations. It does not silently modify the configuration.