reversa-docs-analyst

Generate quantitative metrics dashboards from Reversa Mapper outputs.

1.5k|383|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/sandeco/reversa --skill reversa-docs-analyst-sandeco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-docs-analyst
Source: https://github.com/sandeco/reversa/tree/main/agents/reversa-docs-analyst
Command: npx skills add https://github.com/sandeco/reversa --skill reversa-docs-analyst-sandeco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Legacy code holds critical knowledge in implicit rules, structure, and dependencies, but AI agents need operational specifications and quantitative context to evolve systems safely.

Core Features & Use Cases

  • Quantitative metrics extraction pipeline: Computes LOC by folder, top complexity hotspots, language distribution, and dependency structure from Reversa Mapper outputs (modules.json, deps.json).
  • Interactive Highcharts dashboard generation: Produces metricas.html with a treemap LOC view, complexity columns, a LOC histogram, and a sankey dependency graph.
  • Chronicle-driven interactive timeline: Optionally converts .reversa/chronicle.md into timeline.html with click-to-open event details for project history and change understanding.
  • Pipeline integration for the Time Reversa Docs site: Acts as the quantitative-data analyst in the /reversa-docs workflow, reusing intermediate JSON artifacts and applying the documentation page chassis.

Quick Start

Run /reversa-docs-analyst to generate the metrics dashboard and, when available, the interactive project timeline from the existing Reversa documentation assets.

Frequently Asked Questions about reversa-docs-analyst

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

FAQPage Schema
How do I generate a metrics dashboard from legacy code analysis data?

To generate a metrics dashboard from legacy code data, you process Reversa Mapper outputs like `modules.json` and `deps.json` to compute LOC, complexity, and dependency structure. The result is an interactive `metricas.html` file with treemap, histogram, and sankey visualizations.

What is code complexity visualization and how does it help with legacy systems?

Code complexity visualization transforms legacy code stats into interactive charts, highlighting top complexity hotspots and dependency structures. This provides AI agents with the quantitative context needed to understand implicit rules and evolve legacy systems safely.

Can I build a project timeline visualization from a chronicle markdown file?

Yes, you can build a project timeline visualization by converting `.reversa/chronicle.md` into `timeline.json` and `timeline.html`. This generates an interactive timeline with click-to-open event details for tracking project history and changes.

Do I need Highcharts to display dependency graphs and LOC metrics?

Yes, Highcharts assets are required to render the interactive visualizations. The process generates HTML files that use Highcharts to display sankey dependency graphs, complexity columns, and LOC treemaps from the analyzed code metrics.

What's the best way to automate documentation for code dependencies?

Automating code dependency documentation is best handled by extracting dependency structures from `deps.json` and mapping them into a sankey graph. This pipeline reads intermediate JSON artifacts to produce agent-ready dashboards without manual intervention.

What happens if the required Reversa state files are missing?

If Reversa state files like `.reversa/state.json` or `modules.json` are missing, the documentation pipeline cannot run because it depends on these intermediate JSON artifacts to compute metrics and generate the HTML dashboards.