reversa-docs-publisher

Bundle vendor assets and inject navigation into generated HTML pages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Reversa-docs-publisher turns multiple independently generated HTML outputs into a single coherent mini-site with consistent navigation, branding, offline-ready assets, and final validation.

Core Features & Use Cases

  • Generates a branded, deterministic seal: creates both hero seal and mini seal SVGs from the project seed, ensuring unique identity across regenerations.
  • Builds a single data source for all pages: embeds intermediate JSON data into .reversa/documentation/assets/js/data.js as window.RV_DATA, preventing local-file fetch/CORS issues.
  • Finalizes the mini-site pipeline: injects the mini seal and navigation into every generated page, auto-discovers auxiliary HTML pages by metadata, validates relative links, downloads required vendor libraries locally for offline use, and updates final telemetry.
  • Ensures operational safety: enforces offline-first invariants, performs a smoke test checklist, and records failures like missing vendor libraries or broken links into .reversa/documentation/.state.json.

Quick Start

Ask the agent to run reversa-docs-publisher for the current documentation build, then open .reversa/documentation/index.html to verify navigation, offline rendering, and the generated seal branding.

Frequently Asked Questions about reversa-docs-publisher

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

FAQPage Schema
How do I bundle HTML documentation for offline-first viewing without CORS issues?

To bundle HTML documentation for offline-first viewing without CORS issues, this skill embeds operational data into window.RV_DATA and rewrites external script references to local vendor assets. This guarantees file:// compatibility without relying on fetch() for local resources.

How do I combine multiple generated HTML pages into a single branded mini-site?

To combine multiple generated HTML pages into a single branded mini-site, this skill injects consistent navigation and branding across all outputs. It auto-discovers auxiliary HTML pages via metadata tags and generates deterministic seal SVGs from the project seed.

How do I validate relative links and check for missing vendor libraries in an offline HTML site?

To validate relative links and check for missing vendor libraries in an offline HTML site, this skill enforces offline-first invariants and performs a smoke test checklist. Failures like broken links or missing assets are recorded into a .state.json telemetry file.

Does reversa-docs-publisher require any external dependencies to finalize the documentation pipeline?

No, reversa-docs-publisher requires zero external dependencies to finalize the documentation pipeline. It downloads required vendor libraries locally during the publishing phase to guarantee offline execution and records any missing assets into the state telemetry.

Why does my local HTML documentation site fail to load operational data when opened directly from the file system?

Local HTML documentation sites fail to load operational data from the file system due to browser CORS restrictions on fetch() calls. This skill solves the problem by embedding all intermediate JSON data into a local data.js file as window.RV_DATA.