skills.rest
deerawan
deerawanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gsd-health

Validate .planning directory integrity and optionally repair detected issues.

1|Updated Sep 6, 2015
Search Tags:#diagnostics#context utilization#integrity validation#planning directory#workflow repair#orphaned plans#configuration checking
One-click install
npx skills add https://github.com/deerawan/dotfiles --skill gsd-health-deerawan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/deerawan/dotfiles/tree/main/claude/skills/gsd-health
Command: npx skills add https://github.com/deerawan/dotfiles --skill gsd-health-deerawan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gaps, invalid configuration, or inconsistent state inside your .planning/ directory can break planning workflows and waste time on avoidable failures.

Core Features & Use Cases

  • Integrity diagnosis: Detects missing files, invalid configurations, inconsistent state, and orphaned plans in the planning directory.
  • Actionable repair support: Optionally applies targeted fixes when run with repair enabled.
  • Context utilization check: Performs an orthogonal validation of the running session’s context utilization and reports whether it is healthy, warning, or critical.

Quick Start

Run gsd-health to diagnose .planning/ integrity and get a clear list of actionable issues.

Frequently Asked Questions about gsd-health

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

FAQPage Schema
How do I validate my planning directory for missing files and inconsistent state?▼

To validate planning directory integrity, run a diagnostic check that detects missing files, invalid configurations, and orphaned plans. This identifies workflow issues in your .planning directory and provides a clear list of actionable items to resolve.

What is context utilization validation in a planning workflow?▼

Context utilization validation is an orthogonal check that classifies the running session's context state as healthy, warning, or critical. It uses a query interface to assess and report whether the active context utilization is operating within acceptable parameters.

Can I automatically repair invalid configurations and orphaned plans in my planning directory?▼

Yes, you can automatically repair invalid configurations and orphaned plans by enabling the repair flag. This applies targeted fixes to resolve detected workflow issues and restore consistent state within the .planning directory.

What causes orphaned plans and broken planning workflows during automated runs?▼

Orphaned plans and broken workflows are caused by gaps, invalid configuration, or inconsistent state inside the .planning directory. These issues accumulate across automated runs and lead to avoidable planning failures if left unresolved.

Are there limitations to troubleshooting planning directory issues automatically?▼

Troubleshooting planning directory issues automatically requires parsing specific arguments for repair and context validation. Without passing the correct flags, the process only diagnoses problems and lists actionable issues without applying targeted fixes.

Related Skills

Explore More Software Engineering Skills→
MakisuoMakisuo
1.6k

clickhousectl-local-dev

Install and configure a local ClickHouse environment with clickhousectl.

Community
Intermediate
thecomputer07thecomputer07

qsd-health

Diagnose and repair .planning directory issues for healthy qsd workflows.

Community
Intermediate
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