reversa-requirements

Generates a requirements document from a natural-language feature idea anchored in reverse-engineering artifacts.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill reversa-requirements-helcio-nogueira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-requirements
Source: https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026/tree/main/.agents/skills/reversa-requirements
Command: npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill reversa-requirements-helcio-nogueira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a loose feature idea into a structured requirements document is slow and error-prone, especially when the new feature must respect an existing legacy system. This Skill converts a free-form sentence or paragraph into a complete requirements.md file grounded in artifacts previously extracted from the codebase, while detecting and safely handling features already in progress. ## Core Features & Use Cases - Requirements Generation: Reads reverse-engineering artifacts (architecture.md, domain.md, inventory.md, code-analysis.md) and writes a requirements.md following a project template, with confidence markers and at most three [DÚVIDA] ambiguity flags. - In-Progress Feature Detection: Inspects physical artifacts (requirements.md, roadmap.md, actions.md checkboxes) to determine the real stage of an existing feature and asks the user whether to continue it, pause it in parallel, or abandon it—never overwriting silently. - Hooks and State Management: Executes optional and mandatory before/after hooks from .reversa/hooks.yml and maintains .reversa/active-requirements.json with atomic writes. - Use Case: A developer types "/reversa-requirements add OAuth login to the legacy portal" and receives a fully cited requirements document in _reversa_forward/001-oauth-login/, plus a suggestion for the next pipeline step. ## Quick Start Type "/reversa-requirements" followed by a sentence describing the feature you want, and the Skill will produce a complete requirements document anchored in your project's reverse-engineering artifacts.

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 describing the feature, such as "/reversa-requirements add export to CSV". It reads the reverse-engineering artifacts in the output folder and writes a requirements.md following the project template into a new feature directory.

What happens if a feature is already in progress when I start a new one?▼

The skill detects the existing feature by inspecting physical artifacts like requirements.md, roadmap.md, and actions.md checkboxes. It then asks you to choose: continue the previous feature, pause it in a paused-features list, or abandon it. Nothing is overwritten without your explicit choice.

Which AI coding agents support this requirements skill?▼

The skill declares compatibility with Claude Code, Codex, Cursor, Gemini CLI, and other agents supporting the Agent Skills format. It only requires an agent capable of reading files, following SKILL.md instructions, and writing Markdown documents.

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

[DÚVIDA] markers flag points where information is missing or ambiguous, limited to three per initial document. They are prioritized by scope, security and privacy, user experience, then technical concerns, and signal that the clarify step should run next.

Does the skill modify or delete previous feature folders?▼

No. The skill follows a non-destructive policy: previous feature directories under the forward folder are never deleted or modified. Only the active-requirements.json state file is rewritten, using atomic tempfile-plus-rename writes.