ascii-diagram-validator

Validate ASCII box-drawing diagram alignment in Markdown and documentation.

62|10|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/terrylica/cc-skills --skill ascii-diagram-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ascii-diagram-validator
Source: https://github.com/terrylica/cc-skills/tree/main/plugins/doc-tools/skills/ascii-diagram-validator
Command: npx skills add https://github.com/terrylica/cc-skills --skill ascii-diagram-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

Validates alignment of ASCII box-drawing diagrams in Markdown/docs and suggests fixes to maintain readability.

Core Features & Use Cases

  • Detect misaligned verticals, corners, and junctions
  • Provide actionable fixes and line/column coordinates
  • Multi-file support for architecture diagrams

Quick Start

uv run check_ascii_alignment.py docs/ARCHITECTURE.md

Frequently Asked Questions about ascii-diagram-validator

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

FAQPage Schema
How do I validate ASCII diagram alignment in my documentation?

ASCII diagram validation detects misaligned verticals, corners, and junctions in box-drawing diagrams within Markdown and documentation files. Run the validator against your files to receive compiler-like reports with file, line, column, and severity details, plus suggested fixes to restore alignment.

Can I check ASCII diagrams across multiple files or entire directories?

Yes, the validator supports multi-file and directory-level scanning. Process entire architecture diagram collections, README files, and code comments in one pass to identify alignment issues across your project systematically.

What alignment issues does ASCII diagram validation detect?

The validator detects vertical misalignment, broken corner and junction connectivity, improper line termination, and unclosed boxes. It applies structured detection rules and outputs actionable coordinates and fix suggestions for each issue found.

How do I get fix suggestions for misaligned ASCII diagrams?

The validator outputs compiler-like issue reports that include optional fix suggestions alongside file location and severity. Review the suggested corrections to restore proper alignment without manual recalculation of box-drawing characters.

When should I use ASCII diagram validation in my workflow?

Use validation when maintaining architecture diagrams in documentation, README files, and code comments to catch misalignments early. It's essential for projects with multiple contributors or complex ASCII box-drawing diagrams requiring consistent readability.

What file formats does ASCII diagram validation support?

The validator works with Markdown files and documentation containing ASCII box-drawing diagrams. It processes single files, directories, or entire projects, making it suitable for diverse documentation structures and repository layouts.