К основному содержанию
скилл CX Codex

ascii-diagram-validator — скилл для Claude Code: проверка ASCII-схем

Скилл ascii-diagram-validator находит структурные ошибки в схемах с рамками и соединителями в Markdown. Запустите его после правок документации, чтобы проверить выравнивание.

MIT 217 установок ★ 3 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add terrylica/cc-skills --skill ascii-diagram-validator -a claude-code
Открыть на GitHub

Что делает ascii-diagram-validator

Скилл проверяет схемы из символов Unicode для рамок: ищет разрывы вертикальных соединителей, неверные углы и незамкнутые линии. Скрипт scripts/check_ascii_alignment.py сообщает файл, строку и столбец, а также предлагает, как исправить найденную проблему. Он принимает отдельные файлы и каталоги.

Запуск требует uv; для проверки используют команду uv run и путь к скрипту внутри plugins/doc-tools/skills/ascii-diagram-validator. Проверка охватывает структуру, а не эстетические отступы. Схемы в стиле +---+ скрипт не анализирует, а табуляция может дать ложные срабатывания, поэтому замените её пробелами.

Какие задачи решает

  • найти смещённые вертикальные соединители в Markdown-схеме
  • обнаружить незамкнутые линии и рамки
  • проверить несколько файлов со схемами за один запуск
  • получить номера строк и столбцов проблемных символов

Примеры запросов агенту

  • Проверь выравнивание схемы в docs/ARCHITECTURE.md и исправь найденные структурные ошибки.
  • Просканируй Markdown-файлы в docs/ на сломанные соединения в схемах.
  • Проверь рамку в README и покажи координаты проблемных символов.

Как установить ascii-diagram-validator

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill ascii-diagram-validator -a claude-code

2Вручную: положить файлы

~/.claude/skills/ascii-diagram-validator/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ascii-diagram-validator/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об ascii-diagram-validator

Как установить ascii-diagram-validator в Claude Code?

Выполните npx skills add terrylica/cc-skills --skill ascii-diagram-validator -a claude-code. Файл скилла находится по пути ~/.claude/skills/ascii-diagram-validator/SKILL.md.

Что делает ascii-diagram-validator?

Скилл проверяет Unicode-схемы в Markdown на структурные ошибки: например, разрывы соединителей и незамкнутые рамки. В отчёте указаны файл, строка и столбец.

Какие схемы проверяет ascii-diagram-validator?

Он распознаёт символы одинарных и двойных линий рамок, а также смешанные соединители. Схемы на ASCII-символах вроде +---+ он не проверяет.

Исходный текст

SKILL.md · MIT
---
name: ascii-diagram-validator
description: Validate ASCII diagram alignment in markdown. TRIGGERS - diagram alignment, ASCII art, box-drawing diagrams.
allowed-tools: Bash, Read, Glob
---

# ASCII Diagram Validator

Validate and fix alignment issues in ASCII box-drawing diagrams commonly used in architecture documentation, README files, and code comments.

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## Overview

ASCII diagrams using box-drawing characters (─│┌┐└┘├┤┬┴┼ and double-line variants ═║╔╗╚╝╠╣╦╩╬) require precise column alignment. This skill provides:

1. **Validation script** - Detects misaligned characters with file:line:column locations
2. **Actionable fixes** - Specific suggestions for correcting each issue
3. **Multi-file support** - Validate individual files or entire directories

## When to Use This Skill

Invoke when:

- Creating or editing ASCII architecture diagrams in markdown
- Reviewing documentation with box-drawing diagrams
- Fixing "diagram looks wrong" complaints
- Before committing docs/ARCHITECTURE.md or similar files
- When user mentions "ASCII alignment", "diagram alignment", or "box drawing"

## Supported Characters

### Single-Line Box Drawing

```
Corners: ┌ ┐ └ ┘
Lines:   ─ │
T-joins: ├ ┤ ┬ ┴
Cross:   ┼
```

### Double-Line Box Drawing

```
Corners: ╔ ╗ ╚ ╝
Lines:   ═ ║
T-joins: ╠ ╣ ╦ ╩
Cross:   ╬
```

### Mixed (Double-Single)

```
╞ ╟ ╤ ╧ ╪ ╫
```

## Quick Start

### Validate a Single File

```bash
/usr/bin/env bash << 'PREFLIGHT_EOF'
uv run "$(cc-plugin-root doc-tools)/skills/ascii-diagram-validator/scripts/check_ascii_alignment.py" docs/ARCHITECTURE.md
PREFLIGHT_EOF
```

### Validate Multiple Files

```bash
/usr/bin/env bash << 'PREFLIGHT_EOF_2'
uv run "$(cc-plugin-root doc-tools)/skills/ascii-diagram-validator/scripts/check_ascii_alignment.py" docs/*.md
PREFLIGHT_EOF_2
```

### Validate Directory

```bash
/usr/bin/env bash << 'PREFLIGHT_EOF_3'
uv run "$(cc-plugin-root doc-tools)/skills/ascii-diagram-validator/scripts/check_ascii_alignment.py" docs/
PREFLIGHT_EOF_3
```

## Output Format

The script outputs issues in a compiler-like format for easy navigation:

```
docs/ARCHITECTURE.md:45:12: error: vertical connector '│' at column 12 has no matching character above
  → Suggestion: Add '│', '├', '┤', '┬', or '┼' at line 44, column 12

docs/ARCHITECTURE.md:67:8: warning: horizontal line '─' at column 8 has no terminator
  → Suggestion: Add '┐', '┘', '┤', '┴', or '┼' to close the line
```

### Severity Levels

| Level   | Description                              |
| ------- | ---------------------------------------- |
| error   | Broken connections, misaligned verticals |
| warning | Unterminated lines, potential issues     |
| info    | Style suggestions (optional cleanup)     |

## Validation Rules

The script checks for:

1. **Vertical Alignment** - Vertical connectors (│║) must align with characters above/below
2. **Corner Connections** - Corners (┌┐└┘╔╗╚╝) must connect properly to adjacent lines
3. **Junction Validity** - T-joins and crosses must have correct incoming/outgoing connections
4. **Line Continuity** - Horizontal lines (─═) should terminate at valid endpoints
5. **Box Closure** - Boxes should be properly closed (no dangling edges)

## Exit Codes

| Code | Meaning                                         |
| ---- | ----------------------------------------------- |
| 0    | No issues found                                 |
| 1    | Errors detected                                 |
| 2    | Warnings only (errors ignored with --warn-only) |

## Integration with Claude Code

When Claude Code creates or edits ASCII diagrams:

1. Run the validator script on the file
2. Review any errors in the output
3. Apply suggested fixes
4. Re-run until clean

### Example Workflow

```bash
/usr/bin/env bash << 'PREFLIGHT_EOF_4'
# After editing docs/ARCHITECTURE.md
uv run "$(cc-plugin-root doc-tools)/skills/ascii-diagram-validator/scripts/check_ascii_alignment.py" docs/ARCHITECTURE.md

# If errors found, Claude Code can read the output and fix:
# docs/ARCHITECTURE.md:45:12: error: vertical connector '│' at column 12 has no matching character above
# → Edit line 44, column 12 to add the missing connector
PREFLIGHT_EOF_4
```

## Limitations

- Detects structural alignment issues, not aesthetic spacing
- Requires consistent use of box-drawing characters (no mixed ASCII like +---+)
- Tab characters may cause false positives (convert to spaces first)
- Unicode normalization not performed (use pre-composed characters)

## Bundled Scripts

| Script                             | Purpose                |
| ---------------------------------- | ---------------------- |
| `scripts/check_ascii_alignment.py` | Main validation script |

## Related

- [ARCHITECTURE.md best practices](https://github.com/joelparkerhenderson/architecture-decision-record)
- [Unicode Box Drawing block](https://www.unicode.org/charts/PDF/U2500.pdf)

---

## Troubleshooting

| Issue                       | Cause                         | Solution                                            |
| --------------------------- | ----------------------------- | --------------------------------------------------- |
| Script not found            | Plugin not installed          | Verify plugin installed with `claude plugin list`   |
| False positives with tabs   | Tab characters misalign       | Convert tabs to spaces before validation            |
| Mixed ASCII not detected    | Using `+---+` style           | Script only validates Unicode box-drawing chars     |
| Column numbers off          | Unicode width calculation     | Use pre-composed characters, avoid combining marks  |
| No issues but looks wrong   | Aesthetic spacing not checked | Validator checks structure, not visual spacing      |
| Exit code 2 unexpected      | warnings only mode            | Use --warn-only flag to treat warnings as success   |
| Can't find validation error | Complex nested diagram        | Check line numbers in output, validate section only |
| Unicode chars not rendering | Terminal font missing glyphs  | Use font with full Unicode box-drawing support      |

## Post-Execution Reflection

After this skill completes, check before closing:

1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

© terrylica · MIT · terrylica/cc-skills

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
ascii-diagram SethGammon Скилл ascii-diagram для Claude Code строит текстовые схемы с выровненными блоками и стрелками. Вставляет диаграммы в Markdown, комментарии к коду и обычный текст. CX Codex +1 ★ 937звёзд репо plantuml-ascii официальный github Скилл plantuml-ascii для GitHub Copilot превращает диаграммы PlantUML в текстовый ASCII-вид. Запускается по просьбе создать текстовую, терминальную или ASCII-диаграмму. CX Codex +1 9 740установок ascii-art 0xbyt4, Hermes Agent Скилл ascii-art рисует текстовые баннеры, рамки, речевые пузыри и превращает картинки в ASCII-арт через pyfiglet, cowsay, boxes и конвертеры изображений. CX Codex +1 430установок diagram-to-image sugarforever Скилл diagram-to-image для Claude Code переводит диаграммы Mermaid и таблицы Markdown в PNG-файлы. Создаёт изображения для постов в X/Twitter и платформ без поддержки разметки. CX Codex +1 515установок mermaid-diagram-specialist davila7 Скилл mermaid-diagram-specialist генерирует диаграммы Mermaid прямо в Markdown: от блок-схем и ER-диаграмм до C4 и таймлайнов. Пригодится при составлении технической документации и проектировании архитектуры. CX Codex +1 145установок mermaid-diagram-generator patricio0312rev Скилл mermaid-diagram-generator для Claude Code генерирует диаграммы Mermaid в markdown: блок-схемы, последовательности, ERD, состояния и классы. Срабатывает на запросы «Mermaid-диаграмму», «блок-схему» или «диаграмму архитектуры». CX Codex +1 348установок

Из того же набора79

Весь набор →
chezmoi-workflows Скилл chezmoi-workflows для Claude Code ведёт dotfiles через chezmoi: добавляет конфиги в Git-репозиторий, синхронизирует между машинами и разворачивает шаблоны. CX Codex +1 308установок disk-hygiene Скилл disk-hygiene проводит аудит диска на macOS, вычищает кэши сборщиков и находит забытые большие файлы без риска случайно стереть нужное. CX Codex +1 273установок latex-tables Скилл latex-tables для Claude Code учит агента собирать таблицы LaTeX через tabularray с нуля и переписывать старые: задавать ширину колонок, выравнивание и линии. CX Codex +1 242установок latex-build Скилл latex-build запускает сборку LaTeX через latexmk, включает просмотр с пересборкой при изменениях и помогает разбирать ошибки сборки. CX Codex +1 236установок calendar-event-manager Скилл calendar-event-manager заводит события в macOS Calendar со звуковыми будильниками и парными напоминаниями в Reminders, чтобы встреча не прошла мимо. CX Codex +1 214установок agent-reach Скилл agent-reach даёт агенту возможность искать и читать информацию с интернета: социальные сети (Twitter, Reddit, Weibo, Xiaohongshu, Douyin, Bilibili, V2EX), карьерные сайты (LinkedIn), GitHub, YouTube, подкасты, статьи и RSS-ленты. CX Codex +1 195установок code-hardcode-audit Скилл code-hardcode-audit находит захардкоженные пароли, токены API, магические числа и дубликаты кода. Запускает оркестрацию девяти статических анализаторов через uv. CX Codex +1 166установок documentation-standards Скилл documentation-standards задаёт правила оформления Markdown для чтения моделями и экспорта в PDF через Pandoc. Спасает от поломанной нумерации глав и хаоса в структуре. CX Codex +1 161установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой