reversa-docs-analyst

Generate metrics and timeline artifacts from reversa pipeline JSON data.

1|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/Rdinda/FMA_Pontos --skill reversa-docs-analyst-rdinda
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-docs-analyst
Source: https://github.com/Rdinda/FMA_Pontos/tree/main/.agents/skills/reversa-docs-analyst
Command: npx skills add https://github.com/Rdinda/FMA_Pontos --skill reversa-docs-analyst-rdinda

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts quantitative engineering signals like lines of code, complexity, and dependency relationships into human-readable visual reports for project documentation.

Core Features & Use Cases

  • Quantitative metrics derivation: Aggregates modules and dependency JSON into a consolidated metrics.json schema suitable for charts.
  • Interactive Highcharts dashboard generation: Produces metricas.html with treemap LOC, top complexity bars, LOC histogram, and dependency Sankey visualization.
  • Timeline from chronicle events: Optionally converts chronicle.md into timeline.json and renders timeline.html when event history exists.

Quick Start

Run the analyst step by invoking the skill command: reversa-docs-analyst.

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 visual documentation from code metrics?

To generate visual documentation from code metrics, the analyst aggregates modules and dependency JSON into a consolidated metrics schema and renders Highcharts-based HTML pages with treemaps, complexity bars, and dependency Sankey diagrams.

Can I create a project timeline from a chronicle markdown file?

Yes, you can create a project timeline from a chronicle markdown file. The analyst optionally converts chronicle.md event history into timeline.json and renders an interactive timeline.html when the file exists.

What's the best way to visualize software dependency relationships?

The best way to visualize software dependency relationships is by using the generated Highcharts dashboard, which includes a dependency Sankey visualization derived from the project's deps.json file.

Do I need modules.json and deps.json to run this code metrics analysis?

You need modules.json and deps.json available or extracted to run this code metrics analysis. The analyst loads these files to derive quantitative metrics and requires reversa state and configuration to honor cache and extraction policies.

Why does my dashboard visualization fail to load local data?

Dashboard visualization fails to load local data because the analyst renders Highcharts-based pages without local fetch. It writes outputs directly under the .reversa/documentation/ directory to ensure static rendering.