reversa-reviewer

Reviews reverse-engineering specifications for inconsistencies and reclassifies confidence levels.

Updated May 22, 2026
One-click install
npx skills add https://github.com/GleisonOliveira/dockerpilot-mcp --skill reversa-reviewer-gleisonoliveira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-reviewer
Source: https://github.com/GleisonOliveira/dockerpilot-mcp/tree/main/.agents/skills/reversa-reviewer
Command: npx skills add https://github.com/GleisonOliveira/dockerpilot-mcp --skill reversa-reviewer-gleisonoliveira

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reverse-engineered specifications often contain contradictions, unverified inferences, and gaps that undermine reimplementation efforts. This Skill critically audits the specs produced by the reversa-writer, finds inconsistencies within and across units, reclassifies confidence levels, and generates targeted questions for human validation. ## Core Features & Use Cases - Spec Auditing: Checks each unit's requirements.md, design.md, and tasks.md for internal consistency, cross-unit contradictions, and missing behaviors. - Confidence Reclassification: Upgrades or downgrades 🟢/🟡/🔴 confidence markers based on code evidence, following defined classification rules. - Human Validation Workflow: Generates questions.md for unresolved gaps, processes user answers, and produces a final confidence-report.md with per-spec percentages. - Optional Cross-Review: When the Codex plugin is available, delegates an independent second-opinion review and merges its findings. - Use Case: After running a reverse-engineering analysis on a legacy codebase, invoke this Skill to validate the generated specs, resolve critical gaps with stakeholder input, and obtain a quantified confidence report before reimplementation. ## Quick Start Ask the agent to review the specifications generated in the reversa output folder and produce a confidence report with validation questions.

Frequently Asked Questions about reversa-reviewer

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

FAQPage Schema
How do I validate reverse-engineered specifications before reimplementation?▼

Run this Skill during the review phase of a reversa analysis. It audits each unit's requirements.md, design.md, and tasks.md for consistency, reclassifies confidence markers against the source code, and produces a confidence report with quantified percentages.

What do the confidence levels in reverse-engineering specs mean?▼

Green (CONFIRMADO) means directly evidenced in code with file and line citation, yellow (INFERIDO) means deduced from patterns or conventions, and red (LACUNA) means undeterminable from code and requiring human validation. When in doubt, the rules mandate using the lower level.

Can this Skill use a second AI model for cross-review?▼

Yes. When the Codex plugin is active in the session, the Skill can delegate an independent review to Codex and merge its findings, marking each accepted item with a cross-review origin note. This is optional at the completo doc level and mandatory at detalhado.

How are unresolved specification gaps handled?▼

Gaps that only a human can resolve are written to questions.md with context, affected spec, and impact. Depending on answer_mode, questions are asked in chat or collected in the file for the user to fill in, then answers are processed to update specs and reclassify items.

What outputs does the specification review produce?▼

It always produces confidence-report.md with per-spec confidence percentages and questions.md for critical gaps. At completo or detalhado doc levels it also produces gaps.md for unanswered items and cross-review-result.md when a Codex cross-review was performed.