---
name: GSD Health
slug: gsd-health
category: AI Engineering
description: "GSD Health validates .planning/ directory integrity and reports actionable issues. Use --repair to fix problems and --context to check the current session's context utilization."
github: "https://github.com/open-gsd/gsd-core/tree/next/skills/gsd-health"
language: JavaScript
stars: 8257
forks: 573
install: "npx degit https://github.com/open-gsd/gsd-core/tree/next/skills/gsd-health ~/.claude/skills/gsd-health"
installs_to: ~/.claude/skills/gsd-health
source_path: skills/gsd-health/SKILL.md
collection_size: 25
category_size: 2451
collection_url: "https://dirskills.com/collections/open-gsd/gsd-core"
added: 2026-08-15T06:51:03.883Z
last_synced: 2026-08-15T06:51:03.883Z
canonical_url: "https://dirskills.com/skills/gsd-health"
---

# GSD Health

GSD Health validates .planning/ directory integrity and reports actionable issues. Use --repair to fix problems and --context to check the current session's context utilization.

**Install:**

```bash
npx degit https://github.com/open-gsd/gsd-core/tree/next/skills/gsd-health ~/.claude/skills/gsd-health
```

## README

<objective>
Validate `.planning/` directory integrity and report actionable issues. Checks for missing files, invalid configurations, inconsistent state, and orphaned plans.

`--context` runs an orthogonal check: the running session's context utilization. The workflow asks for the model's tokensUsed + contextWindow, calls `gsd-tools query validate.context`, and renders one of three states:

| Utilization | State    | Action                                                |
|-------------|----------|-------------------------------------------------------|
| < 60%       | healthy  | no action — context is comfortable                    |
| 60% – 70%   | warning  | recommend `/gsd-thread` to start fresh                |
| ≥ 70%       | critical | reasoning quality may degrade past the fracture point |
</objective>

<execution_context>
@~/.claude/gsd-core/workflows/health.md
</execution_context>

<process>
Execute end-to-end.
Parse `--repair` and `--context` flags from arguments and pass to workflow.
</process>