Markdown → HTML — Domain Orchestrator
Converts any markdown file in a Claude project into a single-file, lightly-interactive HTML document. It classifies the input as a long-form document, code review, or slide deck, then routes to the appropriate converter sub-skill to produce the final HTML file.
✨ What it does
- Deterministic classification of markdown into document, review, or slides.
- Pre-flight gates that refuse conversion for inputs under 100 lines or missing design-system onboarding.
- Routes to dedicated converter sub-skills (md-document, md-review, md-slides) that generate single-file HTML.
- Output path resolution with collision handling (suffix or timestamp).
- Returns a concise digest with output path and top features used.
🎯 When to use it
- When a user asks to convert a markdown file (spec, RFC, report, explainer) into an HTML document.
- When a user wants to turn a PR writeup or code review with diffs into an interactive HTML review.
- When a user wants to create an HTML slide deck from markdown with slide boundaries.
- When the markdown is at least 100 lines and the design system has been onboarded.
🚀 How to use
Trigger: /cs:grill-markdown-html
Trigger by asking to convert a markdown file to HTML, e.g., "convert this RFC to HTML" or "make slides from this markdown". Ensure the markdown is at least 100 lines and the design system is onboarded (run python3 markdown-html/skills/design-system/scripts/onboard.py if not). The orchestrator classifies the input and routes to the appropriate sub-skill automatically or asks one clarifying question. Example prompts:
Convert this spec.md to HTML
Turn this PR writeup into an interactive HTML review
📄 Output: A single self-contained HTML file (doc-<slug>.html, review-<slug>.html, or deck-<slug>.html) saved to the configured output directory.
📦 Add this skill to Claude Code
# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills
# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/markdown-html/skills/markdown-html-orchestrator .claude/skills/markdown-html-orchestratorSkill source: markdown-html/skills/markdown-html-orchestrator/SKILL.md
⚠️ Good to know
Requires the design system to be onboarded and the input markdown to be at least 100 lines; refuses otherwise.
❓ FAQ
What happens if my markdown is under 100 lines?
The orchestrator refuses to convert and tells you to keep it as markdown, since markdown is still better below that threshold.
How does the orchestrator decide which converter to use?
It uses a deterministic classifier that scores filename hints and content signals; if the winner is clear, it routes silently, otherwise it asks one clarifying question.
Can I convert a document and also make slides from it in one go?
No, chaining sub-skills is an anti-pattern; you must pick one conversion, finish it, and then ask before doing another.
🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.