reversa-spec-sdd

Decompose PRDs into component specs and score their quality from 0 to 100.

Updated Aug 14, 2026
One-click install
npx skills add https://github.com/Ruggery/OCR_Cartorio --skill reversa-spec-sdd-ruggery
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-spec-sdd
Source: https://github.com/Ruggery/OCR_Cartorio/tree/main/.agents/skills/reversa-spec-sdd
Command: npx skills add https://github.com/Ruggery/OCR_Cartorio --skill reversa-spec-sdd-ruggery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Writing implementation-ready specifications from a product requirements document is slow and error-prone, and ambiguous specs turn into bugs and misaligned expectations. This Skill decomposes a PRD into logical components, drafts a structured SDD spec for each one, and scores each spec's quality so gaps are fixed before coding begins. ## Core Features & Use Cases - PRD Decomposition: Reads _reversa_sdd/prd.md and proposes a component breakdown, confirmed with the user before drafting. - Structured Spec Generation: Writes specs from a 15-section RFC-style template with numbered requirements (RF-XX), non-goals, edge cases, and acceptance criteria, all stamped with the 🟡 planned seal. - Automated Quality Scoring: Runs scripts/spec_scorer.py (or a manual rubric fallback) to grade each spec 0-100 across completeness, testability, clarity, scope, and edge cases, iterating up to 3 times per component. - Use Case: After drafting a PRD for a new product, invoke this Skill to produce per-component specs in _reversa_sdd/sdd/, review the consolidated score report, then hand off to /reversa-forward for implementation. ## Quick Start Ask the agent to run /reversa-spec-sdd to decompose the PRD in _reversa_sdd/prd.md into component specs and score each one.

Frequently Asked Questions about reversa-spec-sdd

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

FAQPage Schema
How do I generate specs from a PRD automatically?▼

Place your PRD at _reversa_sdd/prd.md and invoke /reversa-spec-sdd. The Skill proposes a component decomposition, drafts one spec per component from a structured template, scores each spec, and writes the results to _reversa_sdd/sdd/.

How is spec quality scored in spec-driven development?▼

Each spec receives a 0-100 score across five weighted dimensions: completeness (30%), testability (25%), clarity (20%), scope (15%), and edge cases (10%). Specs scoring 80 or above are considered ready; lower scores trigger gap-fixing iterations.

Does the spec scorer work without Python installed?▼

Yes. When python or python3 is unavailable, the Skill switches to a manual scoring mode that applies the same evaluation rubric mentally, computes the weighted score, and renders output in the same format as the script.

Can I evaluate an existing spec without the full pipeline?▼

Yes. Invoking the Skill outside the /reversa-new pipeline with an existing spec triggers a standalone evaluation mode: provide the file path, receive the score with per-dimension analysis and gaps, and optionally have the issues corrected.

What are the limitations of automated spec scoring?▼

The scorer uses heuristics such as section presence, requirement ID counts, and vague-term detection, so it can miss deep logical inconsistencies. It is limited to 3 improvement iterations per component, after which remaining issues are recorded as pending quality items.