moai-domain-html-report

Convert markdown reports into single self-contained HTML files with tiered audience depth.

1.2k|222|Updated Sep 16, 2025
One-click install
npx skills add https://github.com/modu-ai/moai-adk --skill moai-domain-html-report
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-domain-html-report
Source: https://github.com/modu-ai/moai-adk/tree/main/internal/template/templates/.claude/skills/moai-domain-html-report
Command: npx skills add https://github.com/modu-ai/moai-adk --skill moai-domain-html-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Markdown reports are hard to share with non-technical stakeholders: they render poorly in email, cannot be printed cleanly, and carry no visual structure. This Skill renders any markdown report into one self-contained HTML file that opens in a browser, attaches to email, prints cleanly, and works offline.

Core Features & Use Cases

  • Six report modes: status, incident, plan, explainer, financial, and pr templates, each with its own section structure, charts, and layout.
  • Three audience tiers: expert, basic, and learn depth derived from the active output style, adding plain-language primers, mermaid diagrams, and worked examples only where the reader needs them.
  • Zero-dependency output: inline SVG charts, no external JS/CSS frameworks, with only a Korean font CDN and a tier-gated mermaid CDN as sanctioned exceptions.
  • Lean markdown twin: every HTML report ships with a token-efficient .md twin for agent context, keeping enrichment out of machine-facing artifacts.
  • Use Case: After finishing a weekly status analysis in markdown, render it as an HTML report for executives — the basic tier adds a flow diagram and plain-language leads, and the file auto-opens in the browser.

Quick Start

Render the attached markdown incident summary as a self-contained HTML report for the basic audience tier.

Frequently Asked Questions about moai-domain-html-report

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

FAQPage Schema
How do I convert a markdown report to a single HTML file?▼

Provide the markdown body and select one of six modes (status, incident, plan, explainer, financial, pr). The skill writes a self-contained .html file plus a lean .md twin, then auto-opens the result in your default browser.

What report types does the HTML renderer support?▼

Six modes are implemented: status, incident, plan, explainer, financial, and pr. Each mode has its own section structure, such as metric cards for status, a timeline for incident, and an income-statement table for financial.

Does the HTML report work offline and in email clients?▼

Yes. Charts are inline SVG and there are no external JS or CSS frameworks. The only external references are a Korean font CDN and, at basic and learn tiers, a mermaid CDN that always ships with a noscript fallback for offline, email, and print contexts.

How is the audience tier for a report determined?▼

The tier is derived from the active output style: MoAI maps to expert, MoAI-Easy to basic, and MoAI-Learn to learn. An explicit audience argument always overrides the derived value, and unresolvable styles default to expert.

Why does the skill write a markdown twin alongside the HTML?▼

The .md twin is the agent-facing artifact containing only load-bearing facts, tables, and action items. Using it instead of raw HTML for agent context avoids spending 3-5x the tokens on tags, styles, and tier enrichment that carry no extra information.

Can I use Chart.js, D3, or Tailwind in the generated report?▼

No. External JS libraries and CSS frameworks are explicitly out of scope. All quantitative charts are hand-authored inline SVG, and mermaid is permitted only for structural diagrams at the basic and learn tiers.