ascii-diagram

Render aligned ASCII diagrams on a 2D character grid.

820|78|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/SethGammon/Citadel --skill ascii-diagram-sethgammon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ascii-diagram
Source: https://github.com/SethGammon/Citadel/tree/main/skills/ascii-diagram
Command: npx skills add https://github.com/SethGammon/Citadel --skill ascii-diagram-sethgammon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a deterministic ASCII diagram renderer that guarantees alignment by building diagrams on a 2D character grid rather than relying on token-by-token freehand drawing.

Core Features & Use Cases

  • Programmatically render architecture, flow, sequence, and box-and-arrow diagrams with precise alignment.
  • Post-render verification to ensure box borders, arrows, and labels are consistently positioned.
  • Embedding diagrams in Markdown or plain text with style options (single, double, rounded, heavy) and optional auto-layout for multi-node topologies.
  • Clear guidance and tooling for building, validating, and re-running diagrams with a reproducible process.

Quick Start

Provide a diagram specification and run the grid engine to render an aligned ASCII diagram.

Frequently Asked Questions about ascii-diagram

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

FAQPage Schema
How do I render ASCII diagrams with guaranteed alignment in Markdown?▼

ASCII diagrams with guaranteed alignment are rendered by programmatically placing elements on a 2D character grid rather than relying on freehand drawing, ensuring precise positioning for Markdown documentation.

Why do my freehand ASCII architecture diagrams have misaligned boxes and arrows?▼

Freehand ASCII architecture diagrams misalign because token-by-token generation lacks spatial coordinates; rendering on a deterministic 2D character grid with post-render verification enforces consistent box and arrow placement.

Can I generate flow and sequence diagrams using a character grid?▼

Yes, flow and sequence diagrams can be generated using a character grid engine that programmatically renders diagram elements, supports multi-node topologies, and provides optional auto-layout.

Does this ASCII diagram renderer support different border styles?▼

The ASCII diagram renderer supports multiple border styles including single, double, rounded, and heavy lines, allowing you to embed customized architecture and box-and-arrow layouts in plain text.

What is the best way to verify ASCII diagram alignment before embedding in documentation?▼

The best way to verify ASCII diagram alignment is using a post-render verification step that checks a character grid to ensure box borders, arrows, and labels are consistently positioned before embedding.

Are there limitations to using ASCII diagrams for complex multi-node topologies?▼

ASCII diagrams for complex multi-node topologies require optional auto-layout to manage spacing effectively on the character grid, though extreme density may still challenge readable rendering in plain text.