Skip to content

Tibsfox/gsd-skill-creator / examples/skills/gsd/gsd-preflight

gsd-preflight

Verified

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.

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

LevelDefinitionAction
BLOCKERWill cause workflow failureMust fix first
WARNINGMay cause confusionShould fix
INFOInformationalNo 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
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall