ASCII Diagram Validator Skill for Markdown Alignment

Check box-drawing characters and connector alignment in a Markdown code block and verify the repaired diagram locally.

Install in Claude Code

Use your Markdown document and the pinned Python helper with uv if following the bundled invocation.

Get the complete `plugins/doc-tools/skills/ascii-diagram-validator` directory from the pinned GitHub commit.
Copy it into the target project's `.claude/skills/`. Check `.claude/skills/ascii-diagram-validator/SKILL.md`, start Claude Code at the project root, and call `/ascii-diagram-validator`.

Example task

Create two boxes with a connecting vertical line in docs/flow.md. Offset one connector by a column, run the checker, fix its reported position, and rerun.

What to check

The check locates the disconnected connector and passes after alignment. The monospace preview agrees.

Original SKILL.md on GitHub · Updated 2026-11-13

Frequently asked question

Does alignment validation prove the flow is logically correct?

It checks character geometry. Review arrow directions and business steps separately.