Can it automatically fix the diagrams for me?

The validator provides precise suggestions and coordinates that Claude Code uses to automatically rewrite and fix the broken parts of the diagram.

Can I run this on multiple files at once?

Yes, the script supports directory-wide validation and wildcard patterns (e.g., docs/*.md) to check your entire project's documentation at once.

Why are my diagrams showing errors despite looking correct?

Alignment issues are often caused by hidden tab characters or non-proportional spacing. Converting tabs to spaces usually resolves these false positives.

Does it support standard ASCII characters like '+' and '-'?

Currently, this skill is optimized for Unicode box-drawing characters like ─, │, and ┌ to ensure high-quality visual representation in modern editors.

ASCII Diagram Validator

Name: ASCII Diagram Validator
Author: terrylica

byterrylica

•

学習とドキュメンテーション

Validates and fixes alignment issues in Unicode box-drawing diagrams within Markdown documentation and code comments.

概要

The ASCII Diagram Validator is a specialized tool for Claude Code designed to maintain the structural integrity of technical diagrams created with box-drawing characters. By analyzing vertical alignment, corner connections, and line continuity, it identifies broken connections and provides actionable, compiler-like suggestions to repair visual artifacts in documentation. This skill is essential for developers maintaining ARCHITECTURE.md files or complex READMEs, ensuring that system flowcharts and architecture diagrams remain professional, readable, and perfectly aligned across all editors.

主な機能

Automated detection of misaligned vertical and horizontal box-drawing characters
Bulk validation capabilities for individual files, directories, or glob patterns
Intelligent suggestion engine providing specific characters to fix broken junctions
Compiler-style error reporting with specific file, line, and column locations
2 GitHub stars
Support for single-line, double-line, and mixed Unicode box-drawing sets

ユースケース

Fixing broken box edges and misaligned connectors in large ASCII system flowcharts
Ensuring visual consistency in documentation during collaborative open-source contributions
Validating technical architecture diagrams in documentation before merging pull requests

概要

主な機能

Automated detection of misaligned vertical and horizontal box-drawing characters
Bulk validation capabilities for individual files, directories, or glob patterns
Intelligent suggestion engine providing specific characters to fix broken junctions
Compiler-style error reporting with specific file, line, and column locations
2 GitHub stars
Support for single-line, double-line, and mixed Unicode box-drawing sets

ユースケース

Fixing broken box edges and misaligned connectors in large ASCII system flowcharts
Ensuring visual consistency in documentation during collaborative open-source contributions
Validating technical architecture diagrams in documentation before merging pull requests