amw-html-diagram

Create or modify self-contained HTML diagrams and infographic pages via an IR-based pipeline.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/Emasoft/ai-maestro-webdesign --skill amw-html-diagram-emasoft
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: amw-html-diagram
Source: https://github.com/Emasoft/ai-maestro-webdesign/tree/main/skills/amw-html-diagram
Command: npx skills add https://github.com/Emasoft/ai-maestro-webdesign --skill amw-html-diagram-emasoft

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lxml.

What problem does it solve? Creating or editing HTML-rendered diagrams by hand leads to inconsistent markup, broken validation, and structural drift when patching existing files. This Skill provides a single dispatcher that routes new briefs to the right diagram producer and runs existing .html files through a deterministic parse-patch-re-render-validate pipeline. ## Core Features & Use Cases - Create path dispatch: Routes new diagram briefs to an editorial diagram producer (13 archetypes) or a dense infographic producer based on --style flags or brief cues. - Modify path pipeline: Parses an existing .html file into an intermediate representation (IR), applies the requested edit, re-renders, and re-validates with a retry budget of 3. - Validation gate: Every emitted file must pass xmllint/tidy validation plus a 12-item AI-slop-avoid checklist; failures leave the original file untouched. - Use Case: Given an existing onboarding-funnel.html, ask to rename stage 3 from 'Verify' to 'Confirm' and update the conversion rate to 84%; the Skill patches the IR and re-emits a validated self-contained HTML file. ## Quick Start Ask the AI to create an HTML flow diagram of a 4-step user onboarding funnel with conversion rates, or to edit an existing diagram file such as existing-diagram.html.

Frequently Asked Questions about amw-html-diagram

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

FAQPage Schema
How do I create an HTML diagram from a text brief?▼

Provide a brief describing the diagram, optionally with --style editorial or --style infographic. The Skill generates an intermediate representation, routes it to the editorial or infographic producer, and emits one self-contained .html file with inline CSS and SVG.

How do I edit an existing HTML diagram without breaking it?▼

Pass the path to the existing .html file along with the requested change. The Skill parses the file into an IR, applies the edit, re-renders, and re-validates; on validation failure the original file is left untouched.

What tools are required to run HTML diagram validation?▼

Validation requires python3 (3.8+) with the lxml package for parsing, plus xmllint from libxml2 and HTML Tidy for the unified PASS/FAIL validation contract. These are installed by the plugin's init command and checked by its doctor command.

When should I not use this HTML diagram skill?▼

Do not use it for generic landing pages or dashboard UI design, which route to the design-principles orchestrator, nor for converting other diagram formats to HTML or for validation-only tasks, which have dedicated commands.

Why does HTML diagram modification fail after three retries?▼

Repeated failures mean the requested patch conflicts with other parts of the HTML structure. The validator findings are surfaced so you can refine the edit; the original file remains unchanged throughout.