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.