Gsd-skill-creator gsd-preflight

Use when GSD commands are failing or .planning/ artifacts look inconsistent. Run before any GSD execute-phase or verify-work attempt to catch cross-artifact mismatches early.

install

source · Clone the upstream repo

git clone https://github.com/Tibsfox/gsd-skill-creator

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/Tibsfox/gsd-skill-creator "$T" && mkdir -p ~/.claude/skills && cp -r "$T/examples/skills/gsd/gsd-preflight" ~/.claude/skills/tibsfox-gsd-skill-creator-gsd-preflight && rm -rf "$T"

manifest: examples/skills/gsd/gsd-preflight/SKILL.md

source content

GSD Preflight Validator

Pre-flight checks on

.planning/

artifacts to catch issues before workflows fail.

Core Artifact Checks

PROJECT.md — Sections: What This Is, Requirements, Constraints, Key Decisions ROADMAP.md — Sequential phase numbers, each with Goal/Deliverables/Success Criteria STATE.md — Current Position matches ROADMAP status, reasonable progress % config.json — Valid JSON, valid enum values (mode, model_profile, depth)

Cross-Artifact Consistency

STATE.md phase exists in ROADMAP.md
Completed phases have matching SUMMARY files for each PLAN
Phase directories exist for all ROADMAP phases
No orphaned files (PLAN without phase, SUMMARY without PLAN)

Severity

Level	Definition	Action
BLOCKER	Will cause workflow failure	Must fix first
WARNING	May cause confusion	Should fix
INFO	Informational	No action needed

Common Fixes

STATE/ROADMAP out of sync: Run /gsd:progress
Missing SUMMARY for completed plan: Re-execute or mark incomplete
Invalid config.json: Check for trailing commas, invalid values
Orphaned directories: Add to ROADMAP or remove