reversa-docs-publisher

Aggregate generated HTML pages into an offline-ready documentation mini-site with embedded data and navigation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the challenge of turning scattered agent outputs into a coherent, navigable documentation mini-site that works reliably offline when opened via file://, without broken links or missing assets.

Core Features & Use Cases

  • Offline-first mini-site assembly: Generates a single index.html plus supporting assets while embedding all required data via window.RV_DATA so pages do not fetch local files.
  • Deterministic identity and navigation: Creates hero and mini seals and injects a consistent header mini-seal and nav links across all generated pages.
  • Validation and operational guardrails: Bundles required vendor libraries locally from pinned versions, performs link checks, runs a smoke test, and records final telemetry in .state.json.

Quick Start

Run reversa-docs-publisher to generate .reversa/documentation/index.html and inject the project seal and nav into all existing pages for the mini-site.

Frequently Asked Questions about reversa-docs-publisher

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

FAQPage Schema
How do I generate an offline-ready documentation mini-site that works via file://?

To generate an offline-ready documentation mini-site, you need a final aggregation stage that integrates generated HTML pages into a consistent index with embedded data. This approach forbids local fetch usage, embedding all required data via window.RV_DATA so pages work reliably offline.

How do I validate relative links and bundle assets for a static site generation pipeline?

Validating relative links and bundling assets for static site generation requires bundling pinned vendor libraries into assets/vendor. The pipeline performs link checks, runs a smoke test, and writes final telemetry plus deterministic seal assets to ensure file:// compatibility.

What is the best way to turn scattered HTML outputs into a navigable offline-first mini-site?

Turning scattered HTML outputs into a navigable offline-first mini-site involves injecting a consistent header mini-seal and navigation links across all generated pages. This creates deterministic identity and navigation, ensuring a coherent documentation site without broken links or missing assets.

Does static site generation for offline documentation require specific upstream outputs before publishing?

Static site generation for offline documentation requires upstream generators to have already produced HTML and auxiliary discovery outputs. This final aggregation stage applies to documentation pipelines that need to integrate these scattered outputs into a single offline-ready index.

Why does my offline documentation mini-site break when opened locally via file:// protocol?

Offline documentation mini-sites break when opened via file:// because they attempt local fetch usage. Forbidding local fetch and embedding all required data directly into the pages ensures file:// compatibility without missing assets or broken links.