Agent skill
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 this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/gsd-preflight-tibsfox-gsd-skill-creator
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?