Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Create perfectly aligned ASCII diagrams using the hybrid character strategy.
tier
extended
applyTo
**/*ascii*,**/*diagram*,**/*box-drawing*
ASCII Art Alignment Skill
Create perfectly aligned ASCII diagrams using the hybrid character strategy.
Format Selection: Mermaid-First Principle
Default to Mermaid for all architecture, flow, and relationship diagrams. ASCII art is a last resort for specific use cases. SVG is preferred for polished, brand-ready illustrations.
Use Case
Format
Reason
Architecture diagrams
Mermaid
Auto-layout, renderable, LLM-readable
Flowcharts / sequences
Mermaid
Native tooling (renderMermaidDiagram)
Relationship maps
Mermaid
ER, class, graph diagrams
Branded visuals / logos
SVG
Scalable, animatable, platform-specific
Infographics / illustrations
SVG
Full design control, dark/light mode
UI mockups / wireframes
ASCII
Embedded in code comments
Terminal output examples
ASCII
Literal reproduction
Inline feature lists in boxes
ASCII
README decorations
Conversation mockups
ASCII
Chat-style formatting
Decision rule: If a diagram shows structure or flow, use Mermaid. If it shows a visual design, use SVG. If it's embedded in code or terminal context, use ASCII.
The Problem
ASCII art diagrams render with misaligned lines due to inconsistent character widths across fonts and rendering contexts.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ DATA PROCESSING PIPELINE โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ
โ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โ
โ โ INPUT โ--->โ VALIDATEโ--->โ PROCESS โ--->โ OUTPUT โ โ
โ โโโโโโฌโโโโโ โโโโโโฌโโโโโ โโโโโโฌโโโโโ โโโโโโฌโโโโโ โ
โ โ โ โ โ โ
โ v v v v โ
โ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โ
โ โ Raw โ โ Clean โ โ Enrichedโ โ Final โ โ
โ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Mermaid vs ASCII Decision
Default: Use Mermaid unless you have a specific reason for ASCII. Mermaid auto-layouts, renders interactively, and supports theming via the markdown-mermaid skill.
Diagram Type
Use
Reason
Flow charts
Mermaid
Auto-layout, interactive, GitHub-native
Gantt/Timeline
Mermaid
Native support, date handling
Sequence diagrams
Mermaid
Lifelines, activation bars
State machines
Mermaid
Standard notation, auto-routing
ER diagrams
Mermaid
Relationship cardinality notation
UI Mockups
ASCII
Precise pixel-level layout control
Conversation mockups
ASCII
Text-heavy, spacing matters per-character
Feature lists in boxes
ASCII
Better for bullet lists inside boxes
Simple architecture
Either
Mermaid for auto-layout, ASCII for exact control
Inline code comments
ASCII
Can't embed Mermaid in source code
Terminal output
ASCII
Rendered in monospace, no Mermaid support
When ASCII excels: Content with precise character-level alignment, mixed bullet lists inside boxes, or rendering contexts without Mermaid support (terminals, code comments, plain text files).