skills.rest
FerroxLabs
FerroxLabsCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

ferrox-health

Diagnose broken or inconsistent .planning directory state in Ferrox Factory projects.

21|9|Updated Jul 21, 2026
Search Tags:#workflow#planning#context#diagnostics#repair
One-click install
npx skills add https://github.com/FerroxLabs/ferrox-factory --skill ferrox-health
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ferrox-health
Source: https://github.com/FerroxLabs/ferrox-factory/tree/main/skills/ferrox-health
Command: npx skills add https://github.com/FerroxLabs/ferrox-factory --skill ferrox-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly identify why a project’s .planning/ state is broken, incomplete, or inconsistent, so you can recover from stalled or unreliable factory workflows before more work is lost.

Core Features & Use Cases

  • Planning Integrity Checks: Validates the structure and contents of .planning/ for missing files, invalid configuration, inconsistent state, and orphaned plans.
  • Repair Guidance: When requested, surfaces actionable repair steps to restore a healthy planning setup.
  • Context Health Check: Optionally evaluates session context utilization to warn when reasoning quality may start to degrade.
  • Use Case: A build line suddenly stops behaving as expected after a session break; this Skill inspects the planning layer, explains what is wrong, and helps you decide whether to repair or restart.

Quick Start

Ask the skill to inspect the current project’s .planning/ directory and report any integrity issues, or include --repair if you want suggested fixes.

Frequently Asked Questions about ferrox-health

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

FAQPage Schema
How do I fix a broken .planning directory state in Ferrox Factory?▼

To fix a broken .planning directory state, run a diagnostic inspection to validate planning files, identify missing or invalid configuration, and apply suggested repair steps to restore workflow consistency.

Why does my build line workflow stall after a session break?▼

A build line workflow stalls after a session break when the .planning directory enters an inconsistent state. Inspecting the planning layer integrity identifies the invalid configuration or orphaned plans causing the interruption.

How do I check planning integrity for orphaned plans and invalid configuration?▼

You check planning integrity by validating the structure and contents of the .planning directory. This process detects missing files, invalid configuration, and orphaned plans to ensure reliable factory workflows.

What is a context health check for session recovery in factory workflows?▼

A context health check for session recovery evaluates session context utilization to warn when reasoning quality may degrade. It helps determine if a stalled factory workflow needs repair or a full restart.

When should I repair versus restart a stalled planning workflow?▼

You should repair a stalled planning workflow when validation identifies fixable missing files or invalid configuration. Restart when the context health check reveals severe context degradation affecting reasoning quality.

Related Skills

Explore More Software Engineering Skills→
nnexainnexai
1

gsd-health

Validate .planning directory integrity and monitor session context utilization.

Community
Advanced
dobrinz123dobrinz123

gsd-health

Diagnose and repair issues in the .planning directory with --repair flag.

Community
Intermediate
onelee85onelee85

gsd-health

Validate and repair inconsistencies in the .planning/ directory.

Community
Advanced
GenproMMGenproMM

gsd-health

Validate and repair planning directory integrity with the --repair flag.

Official
Intermediate