How do I install the Spec Health skill?

Run npx skillmds@latest add lennardzuendorf/spec-health in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Spec Health skill do?

Structural health assessor for .spec/ tree — checks staleness, alignment, missing sections, and spec drift beyond what validate.sh covers. It is listed under Coding & Dev Tools on SkillMD.

Is Spec Health safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Spec Health?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Spec Health free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Spec Health?

LennardZuendorf (@lennardzuendorf) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Spec Health by lennardzuendorf — Agent Skill

Name: Spec Health
Author: LennardZuendorf

File contents

spec-health

Structural health assessor. Reads the full .spec/ tree and produces a prioritised list of structural problems beyond what validate.sh catches.

Orders

Run /spec validate (the spec skill's validator) and capture output — include all WARN/ERROR lines in the report
Read root product.md, tech.md, plan.md, lessons.md
Check: are all features in .spec/features/ listed in root plan.md Feature Sequence?
Check: do any feature folders have no corresponding plan entry?
Check: are any feature folder plan.md files missing unit IDs (### <name>/n)?
Check: do any root specs exceed 300 lines (likely over-loaded with feature detail)?
Check: are any updated: dates more than 30 days old on files with recent git activity?

Output format

## Spec Health Report

### CRITICAL
- <issue>: <file> — <what to do>

### WARN
- <issue>: <file> — <what to do>

### INFO
- <issue>: <file> — <what to do>

CRITICAL: validate.sh errors, missing required feature files, orphaned features. WARN: stale dates, oversized root specs, missing plan entries, tagless lessons. INFO: features with no plan.md, very small specs (may be incomplete).

Invariants

MUST run validate.sh and include its output
MUST check: feature-plan sequence alignment, oversized root specs, missing unit IDs
Output MUST use CRITICAL / WARN / INFO levels
MUST NOT modify any files

Frequently asked questions

Spec Health