make-html

Generate self-contained HTML explainer pages with inline SVG diagrams from investigation findings.

Updated Dec 18, 2025
One-click install
npx skills add https://github.com/l0lxl0lw/dotfiles --skill make-html-l0lxl0lw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: make-html
Source: https://github.com/l0lxl0lw/dotfiles/tree/main/ai/shared/skills/utilities/make-html
Command: npx skills add https://github.com/l0lxl0lw/dotfiles --skill make-html-l0lxl0lw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Markdown summaries of concepts, codebases, or investigations are hard for newcomers to absorb. This Skill turns explanations into a single self-contained HTML page with hand-authored inline SVG diagrams that carry the teaching, readable by someone with zero prior context. ## Core Features & Use Cases - Single-file output: All CSS, SVG, and optional JS live inside one .html file that renders offline with no external dependencies, fonts, or images. - Template gallery: Twenty example pages in examples/ (concept explainers, codebase walkthroughs, flowcharts, slide decks, incident reports, status dashboards) serve as mandatory starting points matched to the content type. - Diagram-first teaching: Inline SVG visuals must show flow, structure, or sequence rather than decorate, with accessibility attributes and theme-aware colors. - Use Case: After investigating how authentication flows through a codebase, produce explainers/how-auth-works.html at the repo root that a new teammate can read once and explain back. ## Quick Start Ask the AI to explain how a concept or part of your codebase works as a visual HTML explainer page instead of a Markdown document.

Frequently Asked Questions about make-html

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

FAQPage Schema
How do I create a visual HTML explainer instead of a Markdown summary?

Invoke the skill whenever the deliverable teaches or documents how something works. It investigates the subject, picks a matching template from the examples gallery, and writes one self-contained HTML file with inline SVG diagrams to an explainers directory.

What makes an HTML explainer page self-contained?

All CSS, SVG, and any JavaScript must be inline in a single .html file with no external stylesheets, CDN links, web fonts, or linked images. The page must render correctly when opened directly from disk with no network connection.

When should I not use HTML explainers?

Do not use it for commit messages, plans, code files, or READMEs that belong in the repo as Markdown by convention. It is only for teaching documents whose purpose is to explain a concept, system, or finding.

Where are generated HTML explainer files saved?

Inside a git repository the file goes to explainers/<slug>.html at the repo root, found via git rev-parse --show-toplevel. Outside a repo it goes to ~/explainers/<slug>.html, creating the directory if needed.

Can HTML explainers include JavaScript or external images?

Small inline JavaScript helpers like collapsible sections or a scrollspy table of contents are allowed if dependency-free. External images, remote URLs, and raster graphics are forbidden; all diagrams must be hand-authored inline SVG.