skills.rest
Pear-Commerce
Pear-CommerceOFFICIAL
Explore all skills by this author →
WebsiteGitHub

gsd-health

Diagnose integrity issues in GSD project `.planning/` directories and optionally repair them.

Updated May 15, 2026
Search Tags:#project-workflow#gsd#milestone-audit#planning-health#workflow-repair#directory-validation
One-click install
npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill gsd-health-pear-commerce
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-health
Source: https://github.com/Pear-Commerce/pear-ai-skills/tree/main/skills/gsd-health
Command: npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill gsd-health-pear-commerce

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GSD (Get Shit Done) project workflows rely on properly structured .planning/ directories to store milestone, phase, and project context. Misconfigured, incomplete, or corrupted planning directories break workflow execution, cause data loss, and force time-consuming manual audits to identify and fix issues.

Core Features & Use Cases

  • Directory Integrity Validation: Checks for missing required files, invalid configuration settings, inconsistent state across planning documents, and orphaned plans no longer tied to active milestones.
  • Optional Auto-Repair: Automatically fixes detected common issues to restore workflow functionality without manual intervention.
  • Use Case: If your GSD project is throwing errors when running phase planning or milestone commands, use this Skill to quickly identify the root cause in your .planning/ directory and resolve it.

Quick Start

Use the gsd-health skill to run a full health check on your current project's .planning/ directory and repair any detected issues.

Frequently Asked Questions about gsd-health

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

FAQPage Schema
How do I repair a corrupted GSD .planning directory?▼

Yes, you can fix missing milestone and phase files in your .planning directory by running a directory integrity validation that detects orphaned plans and optionally applies auto-repair to restore consistent state across planning documents.

Why does my GSD project throw errors when running phase planning commands?▼

GSD project phase planning commands throw errors when the .planning directory has invalid configuration settings, missing required files, or inconsistent state that requires directory validation and workflow repair to resolve.

What does directory integrity validation check for in a GSD planning workflow?▼

Directory integrity validation checks GSD planning workflows for missing required files, invalid configuration settings, inconsistent state across planning documents, and orphaned plans no longer tied to active milestones.

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

Yes, you can automatically fix orphaned plans and invalid configurations in your .planning directory by using the optional auto-repair feature after running a health check to restore functional GSD workflow operation.

Do I need to manually audit .planning directory issues if my GSD milestone commands fail?▼

No, you do not need to manually audit .planning directory issues when GSD milestone commands fail because the health check skill diagnoses integrity issues and optionally repairs detected configuration errors to restore workflow execution.

Related Skills

Explore More Software Engineering Skills→
onelee85onelee85

gsd-new-milestone

Plan and initialize a new milestone cycle by updating planning files and routing to requirements.

Community
Advanced
TruCol270TruCol270
1

gsd-new-milestone

Initialize milestone docs and route planning workflows to the plan phase.

Community
Advanced
Pear-CommercePear-Commerce

gsd-autonomous

Automates GSD milestone workflow phases from discussion to execution.

Official
Advanced
coco-researchcoco-research
264

gsd-health

Diagnose .planning directory health issues and validate workflow integrity.

Community
Intermediate