Agent skill · software engineering · aradotso
reversa-legacy-spec
reversa-legacy-spec — an agent skill for coding agents.
Why this skill is useful
Adds a comprehensive set of CLI commands and a multi-agent pipeline for reverse-engineering legacy code into AI-ready specifications, which the AI cannot generate on its own.
What it needs
Requires node installed locally. About 6k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
bash npx reversa install bash Install Reversa into the current project npx reversa install Show current analysis state and progress npx reversa status Update agents to the latest version (respects your customizations via SHA-256) npx reversa update Add a single agent to an existing installation npx reversa add-agent Add support for an additional AI engine npx reversa add-engine Remove all Reversa-created files (legacy project untouched) npx reversa uninstall /reversa reversa Phase 1: Reconnaissance → Scout Phase 2: Excavation → Archaeologist Phase 3: Interpretation → Detective + Architect Phase 4: Generation → Writer Phase 5: Review → Reviewer reversasdd/ ├── inventory.md # Full project inventory ├── dependencies.md # Dependencies with versions ├── code-analysis.md # Technical analysis per module ├── data-dictionary.md # Data dictionary ├── domain.md # Glossary and business rules ├── state-machines.md # State machines (Mermaid diagrams) ├── permissions.md # Permission/role matrix ├── architecture.md # Architectural overview ├── c4-context.md # C4 Context diagram ├── c4-containers.md # C4 Containers diagram ├── c4-components.md # C4 Components diagram ├── erd-complete.md # Full ERD in Mermaid ├── confidence-report.md # 🟢🟡🔴 confidence per statement ├── gaps.md # Identified knowledge gaps ├── questions.md # Questions for human validation ├── dynamic.md # Dynamic analysis findings (Tracer) ├── sdd/ # Specs per component │ └── [component].md ├── openapi/ # API specs (if applicable) ├── user-stories/ # User stories ├── adrs/ # Retroactive architectural decisions ├── flowcharts/ # Flowcharts in Mermaid ├── sequences/ # Sequence diagrams ├── ui/ # Interface specs (Visor) ├── database/ # Database specs (Data Master) ├── design-system/ # Design tokens (Design System) └── traceability/ ├── spec-impact-matrix.md # Which spec impacts which └── code-spec-matrix.md # Code file → corresponding spec .reversa/ ├── state.json # Analysis progress between sessions ├── config.toml # P …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/reversa-legacy-spec