ascii-diagram-creator

Generate terminal-compatible ASCII diagrams with Mermaid export and versioning metadata.

7|3|Updated Oct 19, 2025
One-click install
npx skills add https://github.com/cskiro/annex --skill ascii-diagram-creator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ascii-diagram-creator
Source: https://github.com/cskiro/annex/tree/main/skills/ascii-diagram-creator
Command: npx skills add https://github.com/cskiro/annex --skill ascii-diagram-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, jq, perl.

What problem does it solve?

Generate professional ASCII diagrams for architecture, migration, and data flow directly in the terminal or markdown.

Core Features & Use Cases

  • 5 Diagram Types: Architecture, Before/After, Phased Migration, Data Flow, Relationship
  • Auto-Discovery & Templates: Detects project type and uses templates
  • Mermaid Export & Versioning: Convert ASCII to Mermaid and track versions

Quick Start

Describe what you want diagrammed, e.g., "Show data flow from API to DB".

Frequently Asked Questions about ascii-diagram-creator

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

FAQPage Schema
How do I create ASCII diagrams for software architecture in the terminal?▼

ASCII diagrams visualize architecture, data flows, and system relationships directly in terminal-compatible format. This Skill generates precise diagrams with 80-character width, box-drawing characters, and status indicators, then exports them to Mermaid and markdown for documentation and version tracking.

Can I convert ASCII diagrams to Mermaid format?▼

Yes. This Skill exports ASCII diagrams to Mermaid representation automatically, enabling use in tools that support Mermaid syntax while maintaining the original terminal-friendly ASCII output for markdown and documentation.

What diagram types does ASCII diagram creation support?▼

Five core types: Architecture, Before/After, Phased Migration, Data Flow, and Relationship diagrams. Each applies to specific visualization needs—migrations use phased layouts, APIs use data-flow diagrams, and system changes use Before/After comparisons.

Does this work with Git workflows and pull requests?▼

Yes. The Skill includes Git-aware staleness detection, PR template integration, and CLAUDE.md directive setup, enabling diagram versioning and workflow automation for architecture review cycles.

What dependencies do I need to generate ASCII diagrams?▼

ASCII diagram generation requires bash for execution, jq for JSON processing, and perl for text manipulation. These handle template detection, diagram rendering, and metadata output.

Can the Skill auto-detect my project type and suggest diagram templates?▼

Yes. Auto-discovery detects your project structure and applies relevant templates, reducing setup time and ensuring diagrams match your architecture type without manual configuration.