reversa-requirements

Converts natural-language feature ideas into structured requirements documents anchored in reverse-engineering artifacts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing requirements for a new feature on top of an existing legacy system is slow and error-prone because context is scattered. This Skill turns a free-form feature idea into a complete requirements.md document grounded in the artifacts already extracted from the legacy codebase by the Reversa pipeline. ## Core Features & Use Cases - Context-grounded drafting: Reads architecture, domain, inventory, and code-analysis artifacts from the reverse-engineering output folder and cites them inside the requirements document. - In-progress feature detection: Inspects physical artifacts (requirements.md, roadmap.md, actions.md checkboxes) to detect an unfinished feature and asks the user whether to continue, pause, or abandon it before writing anything. - Doubt marking and self-validation: Flags ambiguous points with [DÚVIDA] markers (max three) and iterates the document against a quality checklist up to three times. - Use Case: A developer types a one-paragraph idea for a new OCR export feature; the Skill creates _reversa_forward/002-export-email/requirements.md with sections filled from the legacy analysis and suggests the next pipeline step. ## Quick Start Invoke the reversa-requirements skill with a short natural-language description of the feature you want to specify, and it will generate the requirements document in the feature folder.

Frequently Asked Questions about reversa-requirements

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

FAQPage Schema
How do I generate a requirements document from a feature idea?▼

Invoke the skill with a free-form sentence or paragraph describing the feature goal. It reads the reverse-engineering artifacts, fills a requirements template, and writes requirements.md into a new numbered feature folder under the forward directory.

What happens if a previous feature is still in progress?▼

The skill detects the physical stage of the prior feature by checking which artifacts exist and whether action checkboxes are open. It then asks you to continue the old feature, pause it and start a new one in parallel, or abandon it, never choosing on its own.

Does the skill work without the reverse-engineering extraction artifacts?▼

It is designed to read architecture.md, domain.md, inventory.md, and addenda from the extraction folder, skipping any that do not exist. Without those artifacts the requirements will lack source citations and contain more doubt markers.

What are [DÚVIDA] markers in the generated requirements?▼

They flag points where information is missing or ambiguous, limited to three per document and prioritized by scope, security, user experience, and technical concerns. Their presence determines whether the next suggested step is the clarify skill or the plan skill.

Which AI coding agents are compatible with this skill?▼

The frontmatter declares compatibility with Claude Code, Codex, Cursor, Gemini CLI, and other agents supporting the Agent Skills format. Model invocation is disabled, so it runs only when explicitly invoked by the user.