reversa-docs-publisher

Build a self-contained offline mini-site index from multi-agent HTML pages.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-docs-publisher-afsjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-docs-publisher
Source: https://github.com/afsjr/secretaria_escola_csm/tree/main/.agents/skills/reversa-docs-publisher
Command: npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-docs-publisher-afsjr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the problem of turning scattered, multi-agent HTML outputs into a single coherent mini-site that reliably works offline and via file:// while keeping navigation, assets, and link integrity consistent.

Core Features & Use Cases

  • Offline-first publishing: bundles required third-party vendor libraries into local assets/vendor/ and rewrites external and stray local asset references so pages load without network access.
  • Deterministic visual identity: generates a large hero seal and a matching mini seal, then injects the mini seal across all generated pages.
  • Single source of truth for data: compiles all intermediary JSON artifacts into one assets/js/data.js consumed by pages through window.RV_DATA, avoiding fetch() under file://.
  • Index and discovery integration: produces index.html and performs HTML auxiliary auto-discovery based on reversa-category metadata, then links auxiliary sections into the final index.
  • Validation and resilience: validates relative links, applies placeholders for omitted pages when needed, runs a smoke test, and records final telemetry in .state.json including CDN fallback and failure details.

Quick Start

Run /reversa-docs-publisher to generate .reversa/documentation/index.html, embed the mini-selo and navigation into the existing HTML pages, and update .reversa/documentation/assets/js/data.js and .reversa/documentation/.state.json.

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 file:// access?

To bundle HTML documentation for offline file:// access, this Skill vendors third-party libraries into local assets and rewrites external references, ensuring pages load without network access.

How do I generate a unified index from multiple HTML pages?

Generating a unified index from multiple HTML pages involves auto-discovering auxiliary sources via metadata, compiling JSON artifacts into a single data model, and linking them into index.html.

Why does fetch() fail when opening local HTML files and how do I fix it?

The fetch() API fails under file:// due to browser CORS restrictions. This Skill fixes it by compiling all data into a local assets/js/data.js file consumed via window.RV_DATA.

How do I validate relative links in a static documentation site?

Validating relative links in a static documentation site is handled natively by this Skill, which checks link integrity, applies placeholders for omitted pages, and reports failures in telemetry.

Can I use multi-agent generated HTML pages in a single offline mini-site?

Yes, you can use multi-agent generated HTML pages in a single offline mini-site. This Skill is specifically designed to unify scattered HTML outputs into one coherent site with consistent navigation.

What are the limitations of publishing a static site with stray local asset references?

Publishing a static site with stray local asset references can break offline viewing. This Skill addresses this limitation by rewriting stray local references and recording CDN fallback details in telemetry.