skills.rest
ThiagoVitale
ThiagoVitaleCOMMUNITY
Explore all skills by this author →
GitHub

gsd-health

Diagnose and repair planning directory issues with Codex collaboration tools.

Updated May 3, 2026
Search Tags:#planning#repair#context utilization#directory health#GSD SDK
One-click install
npx skills add https://github.com/ThiagoVitale/endless-crystal --skill gsd-health-thiagovitale
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/ThiagoVitale/endless-crystal/tree/main/.codex/skills/gsd-health
Command: npx skills add https://github.com/ThiagoVitale/endless-crystal --skill gsd-health-thiagovitale

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill diagnoses and optionally repairs issues within planning directories, ensuring directory integrity and operational efficiency.

Core Features & Use Cases

  • Health Assessment: Validates the .planning/ directory for missing files, invalid configurations, and inconsistent states.
  • Repair Functionality: Optionally fixes identified issues within the directory.
  • Context Utilization Check: Evaluates the running session's context utilization, providing insights into the model's tokensUsed + contextWindow.

Quick Start

Run the gsd-health command to diagnose the health of your planning directory.

Frequently Asked Questions about gsd-health

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

FAQPage Schema
How do I diagnose and repair issues within my planning directory?▼

To diagnose and repair a planning directory, run the `gsd-health` command to validate missing files, invalid configurations, and inconsistent states, and optionally fix identified issues.

What does checking context utilization do for a running session?▼

Checking context utilization evaluates the running session's token usage against the context window, providing insights into how much of the model's available context is being consumed.

Do I need the GSD SDK to validate my .planning directory configurations?▼

Yes, validating the `.planning/` directory requires Codex collaboration tools and the GSD SDK to correctly assess missing files and inconsistent states.

Can I automatically fix inconsistent states in a planning directory?▼

Yes, you can automatically repair inconsistent states by enabling the optional repair functionality, which fixes identified directory issues after completing the initial health assessment.

What is the best way to monitor token usage in a running planning session?▼

The best way to monitor token usage is by running a context utilization check, which evaluates the running session's `tokensUsed` against the `contextWindow` limit.

Related Skills

Explore More Software Engineering Skills→
ThiagoVitaleThiagoVitale

gsd-autonomous

Automate milestone workflow phases using Codex collaboration tools.

Community
Advanced
georgeguimaraesgeorgeguimaraes
11

context-degradation

Detect context degradation patterns like lost-in-middle and poisoning in long-context samples.

Community
Advanced
Poom5741Poom5741

gsd-health

Diagnose planning directory health and report actionable issues.

Community
Intermediate
GenproMMGenproMM

gsd-health

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

Official
Intermediate