amw-ascii-to-svg

Parses ASCII box-drawing diagrams and routes rendering to diagram sub-skills producing SVG output.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires cairosvg, and includes references (resource) components.

What problem does it solve? Hand-drawn ASCII diagrams are hard to share and present; this Skill converts ASCII box-drawing input into clean, rendered SVG diagrams by parsing the sketch into a node/edge graph and routing it to the correct diagram renderer. ## Core Features & Use Cases - ASCII Parsing: Tokenizes Unicode box-drawing, ASCII art boxes, or Mermaid-like text into a node/edge graph via bin/amw-ascii-parse.py. - Intelligent Routing: Classifies the diagram (layered architecture, flowchart, sequence, freeform cluster) and delegates rendering to the matching diagram sub-skill. - Visual Verification: Renders SVG to PNG with bin/amw-svg-render.py and runs a render-view-fix loop (max 3 iterations) before delivery. - Use Case: Paste an ASCII sketch of a Browser → API server architecture and receive a measured, oklch-colored architecture.svg plus a PNG preview. ## Quick Start Invoke the /amw-ascii-to-svg command with your ASCII diagram pasted inline or as a file path to get a rendered SVG and PNG preview. Note: this Skill is deprecated; new workflows should use the amw-diagram-convert skill (IR-pivot conversion path).

Frequently Asked Questions about amw-ascii-to-svg

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

FAQPage Schema
How do I convert an ASCII diagram to SVG?▼

Invoke the /amw-ascii-to-svg command with your ASCII diagram pasted inline, in a fenced code block, or as a .txt/.md file path. The skill parses it into a node/edge graph, routes it to the right diagram renderer, and outputs an SVG plus a PNG preview.

What ASCII diagram formats are supported for SVG conversion?▼

Three input formats are accepted: Unicode box-drawing characters (recommended), plain ASCII art using +---+ and | with arrows, and Mermaid-like text which routes directly to the architecture renderer in mermaid-passthrough mode.

How does the skill decide which diagram renderer to use?▼

It classifies the parsed graph: layered systems with 3-6 buckets go to amw-diagram-architecture, decision trees and freeform flowcharts go to amw-diagram-svg, and sequence flows go to amw-diagram-editorial in sequence mode.

Why does ASCII to SVG parsing fail on my diagram?▼

Parsing fails when input mixes Unicode and ASCII markers ambiguously, lines are too dense or overlapping to tokenize, or the parser returns an empty graph. Space the diagram out, pick one format, or supply an explicit edge list.

Should I still use amw-ascii-to-svg or amw-diagram-convert?▼

This skill is deprecated and retained only as a low-level primitive for the /amw-ascii-to-svg command. New workflows should use amw-diagram-convert, which covers the full ASCII, HTML, SVG, Mermaid, and PNG conversion matrix via an IR-pivot.