skills.rest
lossyrob
lossyrobCOMMUNITY
Explore all skills by this author →
𝕏@lossyrobGitHub

paw-spec-review

Review Spec.md for quality, completeness, and clarity with pass/fail feedback.

39|6|Updated Oct 8, 2025
Search Tags:#planning#feedback#documentation#quality-check#spec-review#Spec.md#PAW
One-click install
npx skills add https://github.com/lossyrob/phased-agent-workflow --skill paw-spec-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: paw-spec-review
Source: https://github.com/lossyrob/phased-agent-workflow/tree/main/skills/paw-spec-review
Command: npx skills add https://github.com/lossyrob/phased-agent-workflow --skill paw-spec-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps QA and planning teams ensure Spec.md quality before proceeding to planning by providing a structured feedback mechanism that can be acted on by the PAW orchestrator.

Core Features & Use Cases

  • Quality review: Checks Spec.md for clarity, completeness, and alignment with user needs.
  • Feedback generation: Produces structured pass/fail status with issue-by-criterion notes for targeted revisions.
  • Planning readiness assessment: Signals readiness to move from specification to planning stage or highlights required polish.

Quick Start

Run the Spec Review skill in a subagent session and point it to the Spec.md at .paw/work/<work-id>/Spec.md. The skill returns a structured feedback payload to the orchestrator.

Frequently Asked Questions about paw-spec-review

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

FAQPage Schema
How do I check if my Spec.md is ready for the planning phase?▼

Spec quality review checks Spec.md against criteria for completeness, clarity, and requirement traceability. It returns a structured pass/fail feedback payload to the orchestrator, signaling planning readiness or highlighting required revisions.

What is a spec review quality check for PAW planning?▼

A spec review evaluates the Spec.md file during the PAW planning phase, applying quality checks covering content quality, narrative flow, ambiguity controls, and risk considerations. It generates structured issue-by-criterion notes for targeted revisions.

How do I review specification completeness and requirement traceability in a Spec.md file?▼

Run the spec review skill in a subagent session targeting the Spec.md located at .paw/work/<work-id>/Spec.md. It evaluates content quality, requirement traceability, and ambiguity controls, returning structured pass/fail feedback to the orchestrator.

Can I use the spec review skill without additional dependencies?▼

Yes, the spec review skill operates with no external dependencies. It functions independently within a subagent session to review the Spec.md file and return structured feedback to the orchestrator.

Does the spec review skill support feedback generation for targeted revisions?▼

Yes, the spec review produces structured pass/fail status with issue-by-criterion notes. This feedback mechanism provides QA and planning teams with specific areas requiring polish before proceeding from specification to the planning stage.

When should I run a spec quality check before planning?▼

Run the spec quality check during the PAW planning phase before transitioning from specification to the planning stage. It ensures Spec.md quality, completeness, and alignment with user needs, signaling readiness or highlighting required polish.

Related Skills

Explore More Education & Research Skills→
lossyroblossyrob
39

paw-workflow

Reference PAW workflow rules and artifact structures across implementation phases.

Community
Basic
lossyroblossyrob
39

paw-plan-review

Review ImplementationPlan.md for feasibility, completeness, and spec alignment.

Community
Basic
lossyroblossyrob
39

paw-review-workflow

Orchestrate PAW activity skills to generate structured PR review feedback.

Community
Advanced
danfrdndanfrdn

document-review

Assess brainstorm and plan documents for clarity, completeness, and specificity.

Community
Intermediate