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.