requirement-refine

Convert raw requirements into ISO/IEC/IEEE 29148-aligned software requirements specifications.

Updated May 8, 2026
One-click install
npx skills add https://github.com/juanca202/sdd-devkit --skill requirement-refine-juanca202
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: requirement-refine
Source: https://github.com/juanca202/sdd-devkit/tree/main/skills/requirement-refine
Command: npx skills add https://github.com/juanca202/sdd-devkit --skill requirement-refine-juanca202

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Raw requirements arrive as vague ideas, tickets, emails, or meeting transcripts that cannot be handed to a development team. This Skill structures them into a formal Software Requirements Specification (SRS-XXX) with prioritized, verifiable functional and non-functional requirements, closing gaps through a structured interview before any user stories are written. ## Core Features & Use Cases - Structured SRS generation: Produces an ISO/IEC/IEEE 29148-aligned document with FR-XXX/NFR-XXX requirements using RFC 2119 keywords, priorities, verification methods, traceability, risks, external interfaces, data requirements, and regulatory compliance sections. - Three-wave role-based interview: Conducts Discovery, Definition, and Validation waves addressed to Product Owner, UI/UX, and Architect roles, including a final validation by a context-free subagent that checks the document is implementable without further questions. - UI wireframe support: Reads attached images and diagrams, and when the requirement involves a UI, generates linked low-fidelity SVG wireframes per capability for user review before closing the SRS. - Use Case: Paste a raw feature request from a stakeholder email; the Skill preserves the original input, interviews you in batches to close functional gaps, optionally delegates stack research, and delivers a Ready-state SRS ready for decomposition into user stories. ## Quick Start Refine this raw requirement into a software requirements specification: [paste your idea, ticket, or transcript].

Frequently Asked Questions about requirement-refine

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

FAQPage Schema
How do I turn a raw feature idea into a software requirements specification?▼

Provide the raw input in any form—text, ticket, email, transcript, or design files—and the Skill preserves it in a references folder, then runs a structured interview to close gaps. It outputs an SRS document with prioritized FR-XXX and NFR-XXX requirements, verification criteria, and a Draft or Ready status.

What standard does a software requirements specification follow?▼

This Skill follows ISO/IEC/IEEE 29148 for the SRS structure and uses RFC 2119 normative keywords for requirement statements. Non-functional requirements are categorized using ISO/IEC 25010 characteristics such as security, performance efficiency, and reliability.

Does the requirements skill create user stories or acceptance criteria?▼

No. It deliberately stops at the SRS level and hands off to the work-define skill, which decomposes the requirements into user stories with AC-XXX acceptance criteria. Technical design artifacts like data models and API contracts belong to design-define.

Can it process wireframes or images attached to a requirement?▼

Yes. Attached images, diagrams, mockups, and existing wireframes are read and interpreted before drafting, never assumed. If the requirement involves a UI, the Skill also generates new low-fidelity SVG wireframes per screen for user review.

When is an SRS marked Ready instead of Draft?▼

Ready requires all Definition of Ready criteria: resolved stack, identified repositories with type, complete prioritized requirements, verification and traceability for every requirement, reviewed wireframes if UI applies, identified risks, clear scope, no open observations, and a passed validation wave including a context-free subagent review.