plantuml-ascii

Convert PlantUML diagrams to ASCII art for terminal viewing.

37.6k|4.7k|Updated Jun 11, 2025
One-click install
npx skills add https://github.com/github/awesome-copilot --skill plantuml-ascii
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plantuml-ascii
Source: https://github.com/github/awesome-copilot/tree/main/skills/plantuml-ascii
Command: npx skills add https://github.com/github/awesome-copilot --skill plantuml-ascii

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill makes it easy to generate readable ASCII diagrams from PlantUML definitions for environments where images can't be displayed, such as terminals or plain text documents.

Core Features & Use Cases

  • ASCII rendering: Convert PlantUML diagrams to plain ASCII art suitable for terminal viewing.
  • Unicode-enhanced ASCII: Optional Unicode box-drawing characters via the -utxt mode for improved readability.
  • Diagram types: Support for sequence diagrams, class diagrams, and flowcharts; additional diagram types can be rendered in ASCII as supported by PlantUML.
  • Use Case: When documenting software architecture in a README, generate a textual diagram that renders in a terminal without images.

Quick Start

Prepare a PlantUML diagram file (example.puml) and run the CLI to produce ASCII output.

  • Standard ASCII: plantuml -txt example.puml
  • Unicode ASCII: plantuml -utxt example.puml The output files will be example.atxt (ASCII) or example.utxt (Unicode ASCII), respectively.

request: "Generate ASCII art diagrams from PlantUML text mode. Applies to terminal-based documentation and environments without image support. Requires PlantUML tooling to parse diagrams and export ASCII (-txt) or Unicode ASCII (-utxt) outputs, covering sequence, class, and flowchart diagrams."