skills.rest
Tibsfox
TibsfoxCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gsd-preflight

Validate GSD planning artifacts and config.json for structural consistency.

69|9|Updated Jan 30, 2026
Search Tags:#consistency#validation#roadmap#preflight#ci#planning-artifacts
One-click install
npx skills add https://github.com/Tibsfox/gsd-skill-creator --skill gsd-preflight
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-preflight
Source: https://github.com/Tibsfox/gsd-skill-creator/tree/main/examples/skills/gsd-preflight
Command: npx skills add https://github.com/Tibsfox/gsd-skill-creator --skill gsd-preflight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GSD projects often suffer from artifact drift between planning files (PROJECT.md, ROADMAP.md, STATE.md) and configuration (config.json). This skill provides automated preflight validation to catch missing sections, mismatches, or malformed frontmatter before a workflow starts.

Core Features & Use Cases

  • Validates core artifacts for structure, presence, and consistency across ROADMAP.md, STATE.md, PROJECT.md, and config.json.
  • Detects cross-artifact drift and prepares actionable remediation guidance.
  • Supports integration into CI and manual review workflows to prevent mid-execution failures.

Quick Start

Activate this skill before running major GSD workflows to perform artifact preflight and surface blockers.

Frequently Asked Questions about gsd-preflight

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate planning artifacts before running a CI workflow?▼

Validate planning artifacts by running preflight checks on PROJECT.md, ROADMAP.md, STATE.md, and config.json to enforce schema structure, flag contradictions, and surface a concise health status before CI execution.

What causes cross-artifact drift between ROADMAP.md and STATE.md?▼

Cross-artifact drift occurs when planning files like ROADMAP.md and STATE.md fall out of sync during modifications. Preflight validation detects these mismatches and provides actionable remediation guidance.

How do I check config.json and PROJECT.md consistency for milestone audits?▼

Check config.json and PROJECT.md consistency by applying preflight structural checks that verify artifact integrity, detect missing sections, and surface blockers during milestone audits.

Does preflight validation support automated CI integration for malformed frontmatter?▼

Preflight validation supports automated CI integration by catching malformed frontmatter and missing sections in planning artifacts, outputting a concise health status suitable for automated pipeline checks.

Can I manually review GSD artifact health status before major workflows?▼

You can manually review GSD artifact health status by activating preflight checks before major workflows, which surface blockers and flag cross-artifact contradictions for manual remediation.

What is the best way to prevent mid-execution failures in GSD projects?▼

Prevent mid-execution failures by running preflight checks that verify the integrity and consistency of GSD artifacts, ensuring cross-artifact coherence and enforcing schema validation before workflows start.

Related Skills

Explore More Product & Management Skills→
ev3rlitev3rlit

gsd-new-project

Create PROJECT.md and initial planning files for new projects.

Community
Advanced
xiongxianfeixiongxianfei
3

verify

Evaluate artifact-code-test coherence, evidence alignment, and release readiness.

Community
Advanced
TibsfoxTibsfox
69

gsd-migrate

Migrate legacy git repositories into a structured GSD workspace with planning artifacts.

Community
Advanced
InverterNetworkInverterNetwork

llm-wiki

Compile and maintain a persistent, interlinked markdown knowledge base.

Official
Advanced