fh:health — for Claude Code fh:health, fhhs-skills, community, for Claude Code, ide skills, repair, Parse JSON output, "healthy" | "degraded" | "broken", warnings[], info[]

v1.0.0
GitHub

Acerca de este Skill

Escenario recomendado: Ideal for AI agents that need read all files referenced by the invoking prompt's execution context before starting. Resumen localizado: <required reading Read all files referenced by the invoking prompt's execution context before starting. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

Características

Read all files referenced by the invoking prompt's execution context before starting.
</required reading
<step name="parse args"
Check if --repair flag is present in the command arguments.
if arguments contain "--repair"; then

# Core Topics

for Claude Code repair Parse JSON output "healthy" | "degraded" | "broken" warnings[] info[]
cinjoff cinjoff
[1]
[1]
Updated: 4/2/2026

Killer-Skills Review

Decision support comes first. Repository text comes second.

Reference-Only Page Review Score: 10/11

This page remains useful for operators, but Killer-Skills treats it as reference material instead of a primary organic landing page.

Original recommendation layer Concrete use-case guidance Explicit limitations and caution Quality floor passed for review
Review Score
10/11
Quality Score
52
Canonical Locale
en
Detected Body Locale
en

Escenario recomendado: Ideal for AI agents that need read all files referenced by the invoking prompt's execution context before starting. Resumen localizado: <required reading Read all files referenced by the invoking prompt's execution context before starting. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

¿Por qué usar esta habilidad?

Recomendacion: fh:health helps agents read all files referenced by the invoking prompt's execution context before starting. <required reading Read all files referenced by the invoking prompt's execution context before

Mejor para

Escenario recomendado: Ideal for AI agents that need read all files referenced by the invoking prompt's execution context before starting.

↓ Casos de uso accionables for fh:health

Caso de uso: Applying Read all files referenced by the invoking prompt's execution context before starting
Caso de uso: Applying </required reading
Caso de uso: Applying <step name="parse args"

! Seguridad y limitaciones

  • Limitacion: [W001] STATE.md references phase 5, but only phases 1-3 exist
  • Limitacion: Requires repository-specific context from the skill documentation
  • Limitacion: Works best when the underlying tools and dependencies are already configured

Why this page is reference-only

  • - Current locale does not satisfy the locale-governance contract.

Source Boundary

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

After The Review

Decide The Next Action Before You Keep Reading Repository Material

Killer-Skills should not stop at opening repository instructions. It should help you decide whether to install this skill, when to cross-check against trusted collections, and when to move into workflow rollout.

Install Path

Start With Installation And Validation

If this skill is worth continuing with, the next step is to confirm the install command, CLI write path, and environment validation.
Trusted Recheck

Cross-Check Against Trusted Picks

If you are still comparing multiple skills or vendors, go back to the trusted collection before amplifying repository noise.
Workflow

Move To Workflow Collections For Team Rollout

When the goal shifts from a single skill to team handoff, approvals, and repeatable execution, move into workflow collections.
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is fh:health?

Escenario recomendado: Ideal for AI agents that need read all files referenced by the invoking prompt's execution context before starting. Resumen localizado: <required reading Read all files referenced by the invoking prompt's execution context before starting. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

How do I install fh:health?

Run the command: npx killer-skills add cinjoff/fhhs-skills. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for fh:health?

Key use cases include: Caso de uso: Applying Read all files referenced by the invoking prompt's execution context before starting, Caso de uso: Applying </required reading, Caso de uso: Applying <step name="parse args".

Which IDEs are compatible with fh:health?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for fh:health?

Limitacion: [W001] STATE.md references phase 5, but only phases 1-3 exist. Limitacion: Requires repository-specific context from the skill documentation. Limitacion: Works best when the underlying tools and dependencies are already configured.

↓ How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add cinjoff/fhhs-skills. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use fh:health immediately in the current project.

! Reference-Only Mode

This page remains useful for installation and reference, but Killer-Skills no longer treats it as a primary indexable landing page. Read the review above before relying on the upstream repository instructions.

Upstream Repository Material

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

Upstream Source

fh:health

<required reading Read all files referenced by the invoking prompt's execution context before starting. This AI agent skill supports Claude Code, Cursor, and

SKILL.md
Readonly
Upstream Repository Material
The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.
Supporting Evidence

<required_reading> Read all files referenced by the invoking prompt's execution_context before starting. </required_reading>

<process> <step name="parse_args"> **Parse arguments:**

Check if --repair flag is present in the command arguments.

REPAIR_FLAG=""
if arguments contain "--repair"; then
  REPAIR_FLAG="--repair"
fi
</step> <step name="run_health_check"> **Run health validation:** 
bash
1node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" validate health $REPAIR_FLAG

Parse JSON output:

  • status: "healthy" | "degraded" | "broken"
  • errors[]: Critical issues (code, message, fix, repairable)
  • warnings[]: Non-critical issues
  • info[]: Informational notes
  • repairable_count: Number of auto-fixable issues
  • repairs_performed[]: Actions taken if --repair was used </step>
<step name="format_output"> **Format and display results:** 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Health Check
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Status: HEALTHY | DEGRADED | BROKEN
Errors: N | Warnings: N | Info: N

If repairs were performed:

## Repairs Performed

- ✓ config.json: Created with defaults
- ✓ STATE.md: Regenerated from roadmap

If errors exist:

## Errors

- [E001] config.json: JSON parse error at line 5
  Fix: Run health --repair to reset to defaults

- [E002] PROJECT.md not found
  Fix: Run /fh:new-project to create

If warnings exist:

## Warnings

- [W001] STATE.md references phase 5, but only phases 1-3 exist
  Fix: Run health --repair to regenerate

- [W005] Phase directory "1-setup" doesn't follow NN-name format
  Fix: Rename to match pattern (e.g., 01-setup)

If info exists:

## Info

- [I001] 02-implementation/02-01-PLAN.md has no SUMMARY.md
  Note: May be in progress

Footer (if repairable issues exist and --repair was NOT used):

---
N issues can be auto-repaired. Run: health --repair
</step> <step name="offer_repair"> **If repairable issues exist and --repair was NOT used:**

Ask user if they want to run repairs:

Would you like to run health --repair to fix N issues automatically?

If yes, re-run with --repair flag and display results. </step>

<step name="verify_repairs"> **If repairs were performed:**

Re-run health check without --repair to confirm issues are resolved:

bash
1node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" validate health

Report final status. </step>

</process>

<error_codes>

CodeSeverityDescriptionRepairable
E001error.planning/ directory not foundNo
E002errorPROJECT.md not found or has no recognizable structureNo
E003errorROADMAP.md not foundNo
E004errorSTATE.md not foundYes
E005errorconfig.json parse errorYes
W001warningPROJECT.md missing required sectionNo
W002warningSTATE.md references invalid phaseYes
W003warningconfig.json not foundYes
W004warningconfig.json invalid field valueNo
W005warningPhase directory naming mismatchNo
W006warningPhase in ROADMAP but no directoryNo
W007warningPhase on disk but not in ROADMAPNo
W008warningconfig.json: workflow.nyquist_validation absent (defaults to enabled but agents may skip)Yes
W009warningPhase has Validation Architecture in RESEARCH.md but no VALIDATION.mdNo
I001infoPlan without SUMMARY (may be in progress)No

</error_codes>

<repair_actions>

ActionEffectRisk
createConfigCreate config.json with defaultsNone
resetConfigDelete + recreate config.jsonLoses custom settings
regenerateStateCreate STATE.md from ROADMAP structureLoses session history
addNyquistKeyAdd workflow.nyquist_validation: true to config.jsonNone — matches existing default

Not repairable (too risky):

  • PROJECT.md, ROADMAP.md content
  • Phase directory renaming
  • Orphaned plan cleanup

</repair_actions>

Habilidades relacionadas

Looking for an alternative to fh:health or another community skill for your workflow? Explore these related open-source skills.

Ver todo

openclaw-release-maintainer

Logo of openclaw
openclaw

Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞

★ 333.8k
⑂ 0
Inteligencia Artificial

widget-generator

Logo of f
f

Generar complementos de widgets personalizables para el sistema de feeds de prompts.chat

★ 149.6k
⑂ 0
Inteligencia Artificial

flags

Logo of vercel
vercel

El Marco de React

★ 138.4k
⑂ 0
Navegador

pr-review

Logo of pytorch
pytorch

Tensores y redes neuronales dinámicas en Python con fuerte aceleración de GPU

★ 98.6k
⑂ 0
Desarrollador