skills.rest
electroheadfx
electroheadfxCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/electroheadfx/efx-mux --skill gsd-health-electroheadfx
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
refactory-langrefactory-lang

speckit-workflows.refactor

Initialize a refactoring workflow with specification, testing gaps, and behavioral snapshot.

Official
Advanced
dojoenginedojoengine
37

dojo-debug

Diagnose Torii connection and entity synchronization issues in dojo.js applications.

Official
Advanced
lgwanailgwanai
4

gsd-health

Validate `.planning/` directory integrity and optionally repair detected issues.

Community
Intermediate
MINT-IAMINT-IA

gsd-health

Diagnose planning directory health and repair issues with a --repair argument.

Official
Intermediate