reversa-docs

Generate a self-contained offline HTML documentation mini-site from Reversa artifacts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It turns scattered, extracted Reversa artifacts into a navigable offline mini-site so stakeholders and developers can understand the system without reading raw files.

Core Features & Use Cases

  • Mini-site HTML generation: Builds a self-contained site under .reversa/documentation/ with architecture, modules, metrics, and feature pages when available.
  • Deterministic pipeline orchestration: Runs the Mapper → Analyst → Storyteller → Publisher sequence, with isolated agent regeneration commands.
  • Offline-safe publishing: Bundles required JS libraries locally so the user can open index.html via file:// without CDN fetches.

Quick Start

Run /reversa-docs --auto to generate the documentation mini-site with sensible defaults (no interview prompts).

Frequently Asked Questions about reversa-docs

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

FAQPage Schema
How do I generate an offline HTML documentation mini-site from project artifacts?

To generate an offline HTML documentation mini-site, you can run a command like `/reversa-docs --auto` to orchestrate the Mapper, Analyst, Storyteller, and Publisher pipeline, bundling local assets and writing outputs directly to the `.reversa/documentation/` directory.

What is the best way to view architecture walkthroughs and feature specs without an internet connection?

Offline architecture walkthroughs and feature specs are viewable by opening the generated `index.html` via the `file://` protocol, which works without CDN fetches because required JavaScript libraries are bundled locally.

Do I need specific metadata files to generate project visualization and metrics views?

Generating project visualization and metrics views requires YAML-frontmatter-identified skill metadata, and the pipeline reads `.reversa/state.json` and `.reversa/documentation/.config.json` if they are present in the project.

Can I regenerate specific documentation sections without rebuilding the entire offline mini-site?

You can regenerate specific sections without a full rebuild because the deterministic pipeline orchestration supports isolated agent regeneration commands for the Mapper, Analyst, Storyteller, and Publisher stages.

Where are the generated offline HTML documentation files written on my local system?

Generated offline HTML documentation files are written exclusively under the `.reversa/documentation/` directory, ensuring all architecture, modules, metrics, and feature pages remain contained within the project structure.

Why does the offline HTML mini-site skip interview prompts during generation?

The offline HTML mini-site skips interview prompts during generation because the `--auto` flag applies sensible defaults, allowing the pipeline to process extracted artifacts and output documentation dashboards autonomously.