render-html

Render ARIS Markdown or JSON artifacts into single-file HTML views.

357|13|Updated May 19, 2026
One-click install
npx skills add https://github.com/wanshuiyin/ARIS-in-AI-Offer --skill render-html
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: render-html
Source: https://github.com/wanshuiyin/ARIS-in-AI-Offer/tree/main/skills/render-html
Command: npx skills add https://github.com/wanshuiyin/ARIS-in-AI-Offer --skill render-html

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

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

Frequently Asked Questions about render-html

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

FAQPage Schema
How do I convert markdown artifacts into a single-file HTML report?

You can convert markdown artifacts into a single-file HTML report by applying a rendering script that transforms the source markdown into a portable .html file with tables, callouts, and math. This ensures the content is readable and easy to share.

What is the best way to render JSON artifacts for human reading?

The best way to render JSON artifacts for human reading is to use a template-driven layout like an academic or dashboard format. This transforms dense JSON data into a polished, human-friendly HTML view for review.

Can I generate offline-safe HTML from markdown without external dependencies?

Yes, generating offline-safe HTML from markdown without external dependencies is possible. The rendering process creates CDN-friendly or offline-safe single-file HTML, ensuring the document remains accessible without an internet connection.

How do I prevent unsafe HTML injection when exporting markdown to HTML?

You prevent unsafe HTML injection when exporting markdown to HTML by applying XSS and unsafe-HTML sanitization during the rendering process. This safety guardrail ensures the final HTML output is secure and canonical-source rendering is maintained.

Does single-file HTML rendering support embedded source metadata for traceability?

Yes, single-file HTML rendering supports embedded source metadata for traceability. It embeds the source path, SHA256, and generation timestamp directly into the HTML, providing version awareness and drift detection for your artifacts.

When should I use an academic template versus a dashboard layout for HTML rendering?

Use an academic template for long-form core workflow artifacts like IDEA_REPORT, and a dashboard layout for denser cockpit-style summaries like SUMMARY. Choosing the right template matches the content density and reading style needed.