gsd-health

Diagnose planning directory health and identify missing files or invalid configuration.

4|Updated Apr 11, 2026

Search Tags:#planning #health check #repair #workflow validation #context utilization #directory integrity

Ready to run

npx skills add https://github.com/electroheadfx/efx-mux --skill gsd-health-electroheadfx

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/electroheadfx/efx-mux/tree/main/.codex/skills/gsd-health
Command: npx skills add https://github.com/electroheadfx/efx-mux --skill gsd-health-electroheadfx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill checks the health of a planning directory so you can quickly find missing files, broken configuration, inconsistent state, and orphaned plans before they cause workflow failures.

Core Features & Use Cases

Directory Integrity Review: Validates the .planning/ structure and flags missing or unexpected artifacts.
Repair-Oriented Diagnosis: Can guide or perform fixes when repair mode is enabled, helping restore a healthy planning setup.
Context Awareness: Supports a separate context-utilization check to determine whether a session should continue or start fresh.
Use Case: A project team notices that planning updates are no longer syncing correctly; this Skill identifies the root cause and recommends corrective action.

Quick Start

Ask the skill to check the planning directory health for the current project and report any issues.

Frequently Asked Questions about gsd-health

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

FAQPage Schema

How do I check planning directory health and find missing files in my workflow?▼

To check planning directory health, validate the `.planning/` structure to identify missing files, broken configuration, and inconsistent state before they cause workflow failures.

What is the best way to repair orphaned plans and invalid configuration in a planning directory?▼

Repair orphaned plans and invalid configuration by enabling repair mode, which guides or performs fixes to safely restore a healthy planning setup.

How does context utilization validation work for session state?▼

Context utilization validation runs a separate check to determine whether a session should continue or start fresh based on the current planning context.

When do I need to validate workflow artifacts and planning directory integrity?▼

Validate workflow artifacts and directory integrity when planning updates stop syncing correctly, preventing workflow failures by catching inconsistent state and missing files early.

Can I fix inconsistent planning state without risking my existing workflow artifacts?▼

Yes, repair mode safely handles repair and context-related flags, ensuring corrective action for inconsistent state does not damage valid planning artifacts.

Why does my workflow validation fail when planning updates are no longer syncing correctly?▼

Workflow validation fails because the planning directory has missing files, invalid configuration, or orphaned plans that disrupt synchronization and require integrity review.