ascii-diagrams

Generate ASCII flowcharts, decision trees, and sequence diagrams from JSON-like data.

1|1|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/namnh240795/automation-with-claude-cli --skill ascii-diagrams-namnh240795
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ascii-diagrams
Source: https://github.com/namnh240795/automation-with-claude-cli/tree/main/skills/ascii-diagrams
Command: npx skills add https://github.com/namnh240795/automation-with-claude-cli --skill ascii-diagrams-namnh240795

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Generate portable ASCII diagrams that render in any Markdown viewer without external diagram tools, enabling quick visualization in docs and READMEs.

Core Features & Use Cases

  • Vertical flowcharts: top-to-bottom diagrams using ASCII boxes and arrows.
  • Horizontal flowcharts: left-to-right diagrams for compact workflows.
  • Decision trees: branch yes/no decisions in a readable ASCII form.
  • Sequence diagrams: interactions between components over time.
  • Script-driven generation: programmatic diagram creation via a Python CLI.

Quick Start

Use the ASCII diagram tool to render a simple vertical flowchart from a JSON payload, for example: python3 scripts/ascii_diagram.py vertical '{"steps": [{"text": "User"}, {"text": "Agent"}, {"text": "Skill"}]}'

Frequently Asked Questions about ascii-diagrams

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

FAQPage Schema
How do I generate ASCII diagrams for Markdown viewers without external tools?

You can generate ASCII diagrams for Markdown viewers by running a self-contained Python CLI script. It processes JSON-like data to render flowcharts and sequence diagrams directly in text, ensuring portability across any Markdown viewer.

Can I create an ASCII sequence diagram from a JSON payload using a CLI?

Yes, you can create an ASCII sequence diagram from a JSON payload using the Python CLI. The script accepts structured JSON-like data as input to map component interactions over time into a readable text-based sequence diagram.

What types of flowcharts can I render using ASCII text?

You can render vertical top-to-bottom flowcharts and horizontal left-to-right flowcharts using ASCII text. The tool also supports branching decision trees, allowing you to visualize yes/no logic paths in a compact format.

Do I need to install external Python dependencies to render ASCII flowcharts?

No, you do not need to install external Python dependencies to render ASCII flowcharts. The tool ships with a self-contained CLI script and relies solely on a standard Python environment to generate diagrams.

When should I use ASCII diagrams instead of external image-based diagram tools?

You should use ASCII diagrams instead of external image-based tools when you need portable, quick visualizations for docs and READMEs. They render natively in any Markdown viewer without requiring external rendering engines or image hosting.

How do I automate diagram generation in a scripting context?

You automate diagram generation in a scripting context by invoking the Python CLI programmatically. The tool supports script-driven creation, allowing you to pass structured JSON-like data directly to the command line to output diagrams.