speckit-checklist

Generate requirement-quality checklists for spec-kit feature folders.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/misadecastro/imperial-soccer --skill speckit-checklist-misadecastro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-checklist
Source: https://github.com/misadecastro/imperial-soccer/tree/main/.claude/skills/speckit-checklist
Command: npx skills add https://github.com/misadecastro/imperial-soccer --skill speckit-checklist-misadecastro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns written feature requirements into structured, requirement-quality checklists that surface gaps, ambiguities, and missing acceptance criteria so authors and reviewers can validate specs before implementation.

Core Features & Use Cases

  • Checklist generation and safe file handling: Creates or appends domain-named checklist markdown files under FEATURE_DIR/checklists/, preserving existing content and continuing CHK ID sequencing.
  • Clarifying-question driven focus: Produces up to three targeted clarifying questions derived from user input and spec signals to narrow scope, depth, and audience for the checklist.
  • Requirements-quality scaffolding: Emits items grouped by qualities like Completeness, Clarity, Consistency, Measurability, Coverage, Edge Cases, and Traceability to prioritize high-risk gaps.
  • Use Case: During a PR review for a payments feature, run the Skill to generate an "api.md" checklist that highlights missing acceptance criteria, non-functional targets, and traceability gaps for reviewers.

Quick Start

Generate a requirements-quality checklist for the checkout domain using speckit-checklist with the repository's .specify feature folder available.

Frequently Asked Questions about speckit-checklist

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

FAQPage Schema
How do I generate a requirements quality checklist from a spec.md file?

To generate a requirements quality checklist from a spec.md file, use a tool that parses your feature folder and groups validation items by completeness, clarity, consistency, and measurability. It creates or appends domain-named markdown files under the feature directory's checklists folder.

What is requirement traceability in feature specs and how is it validated?

Requirement traceability in feature specs links requirements to their implementation and tests. It is validated by generating a checklist that enforces traceability markers, ensuring every written feature requirement has corresponding acceptance criteria and coverage before implementation begins.

How do I validate the completeness and clarity of written feature requirements for PR review?

To validate the completeness and clarity of written feature requirements for PR review, generate a domain-specific checklist that highlights missing acceptance criteria, non-functional targets, and traceability gaps. This surfaces ambiguities and high-risk gaps so reviewers can assess spec quality.

Can I append new checklist items to an existing markdown file without losing previous content?

Yes, you can append new checklist items to an existing markdown file without losing previous content. The checklist generation process preserves existing checklist content, continues the CHK ID sequencing, and safely appends new validation items to the domain-named file.

Do I need a .specify directory to create unit-test style checklists for feature folders?

Yes, you need a .specify directory containing feature folders with spec.md, plan.md, or tasks.md files to create unit-test style checklists. The generation process parses a prerequisites JSON produced by the check-prerequisites script within this directory structure.

What are the limitations of using automated requirement quality scaffolding for spec validation?

The limitation of automated requirement quality scaffolding is that it relies entirely on the presence of a .specify directory and valid prerequisites JSON. It cannot validate requirements outside this structure and focuses solely on generating checklists for gaps, edge cases, and traceability without executing tests.