What problem does it solve?
This Skill removes the friction of reading ARIS Markdown/JSON artifacts by turning them into a clean, human-friendly single-file HTML view with tables, callouts, math, and optional embedded state.
Core Features & Use Cases
- Single-file HTML rendering: Converts selected ARIS Markdown/JSON artifacts into one portable .html file for easy sharing and review.
- Academic vs dashboard templates: Produces long-form academic layouts for core workflow artifacts and denser dashboard layouts for cockpit-style summaries.
- Safety and fidelity guardrails: Enforces canonical-source rendering (MD/JSON is the source of truth) and applies sanitization to prevent unsafe HTML injection; academic renders are gated by an optional cross-model Codex review.
- Drift detection and traceability: Embeds source path, SHA256, and generation timestamp into the HTML for version awareness.
Quick Start
Use the render-html skill to render a human-readable HTML report from idea-stage/IDEA_REPORT.md by running: python3 render_html.py idea-stage/IDEA_REPORT.md --template academic --out idea-stage/IDEA_REPORT.html