planning-validate
Validates planning artifacts (spec.md, plan.md, data-model.md, contracts/) for quality, completeness, and consistency. Checks for mandatory sections, cross-artifact consistency, and constitution compliance. Always run after /speckit.plan completes.
How do I install this agent skill?
npx skills add https://github.com/drillan/speckit-gates --skill planning-validateIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The 'planning-validate' skill is designed to perform quality assurance on project planning artifacts such as specification and plan files. It verifies that required sections are present and consistent across documents. No malicious code, unauthorized data exfiltration, or credential exposure patterns were found. The skill has a low-risk surface for indirect prompt injection because it processes content from external files that could potentially contain adversarial instructions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
2/2 files flagged
What does this agent skill do?
planning-validate
Validates planning artifacts for quality and consistency after /speckit.plan completes.
Purpose
This skill automatically validates your planning artifacts to catch specification gaps before task generation. It checks:
- spec.md completeness: All mandatory sections present with content
- plan.md executability: Technical context, project structure, and constitution check completed
- data-model.md consistency: Entities align with spec requirements (if exists)
- Contract coverage: API contracts defined for required endpoints (if contracts/ exists)
- Constitution compliance: Plan follows project constitution rules (if constitution.md exists)
Output
The skill outputs a Quality Assessment with:
- GREEN: All checks pass - proceed to
/speckit.tasks - YELLOW: Minor warnings - review but can proceed
- RED: Blockers found - must resolve before proceeding
Usage
This skill runs automatically after /speckit.plan. You can also run it manually:
npx skills run planning-validate
Exit Codes
| Code | Status | Meaning |
|---|---|---|
| 0 | GREEN | All checks pass |
| 1 | YELLOW | Warnings present |
| 2 | RED | Blockers present |
| 3 | Error | Required files missing |
Checks Performed
spec.md Checks
- File exists and is readable
- Summary section present with content
- User Stories section present with at least one story
- Functional Requirements section present with FR-XXX items
- Success Criteria section present
plan.md Checks
- File exists and is readable
- Technical Context section present
- Project Structure section present
- Constitution Check section present (unless skipped)
- Gate Result shows PASS status
data-model.md Checks (if exists)
- Entities section present
- At least one entity defined
- Entity names are consistent with spec.md terminology
contracts/ Checks (if exists)
- At least one contract file present
- Contract files are valid markdown
- Contract endpoints match spec.md requirements
constitution.md Checks (if exists)
- Plan.md references constitution principles
- No constitution violations in Gate Result
Blocker Examples
- "spec.md: Missing User Stories section"
- "plan.md: Constitution Check section shows FAIL status"
- "data-model.md: Entity 'UserAccount' not referenced in spec.md"
Recommendations
After receiving a RED or YELLOW status:
- Review the specific blockers or warnings listed
- Update the affected artifacts to address issues
- Re-run
/speckit.planto regenerate plan.md - Run
planning-validateagain to verify fixes
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/drillan/speckit-gates/planning-validate">View planning-validate on skillZs</a>