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

diagram-quality — скилл для Claude Code: что делает и как установить

Скилл diagram-quality задаёт правила отрисовки PlantUML на холсте agent-uml, предотвращая ошибки HTTP 400 и пустые схемы при работе с инструментами дизайна.

MIT 230 установок ★ 227 обновлён 2026-08-15

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

Что делает diagram-quality

Скилл регламентирует вызовы MCP-инструментов agent-uml: design_create, diagram_upsert, design_feedback и design_export. Он вводит правила для надёжного рендеринга и архитектурной декомпозиции.

В блоке безопасности собрано 18 правил против ошибки пустого холста. Каждому элементу обязательно присваивается as Alias — иначе на интерактивном SVG-холсте по нему нельзя кликнуть или оставить аннотацию. Фон задаётся через skinparam backgroundColor transparent, чтобы не конфликтовать со светлой подложкой #f4f1ec.

Для структуры архитектуры заданы пороги разделения. Схемы компонентов дробят при более чем 12 элементах, а диаграммы последовательностей разделяют, если участников больше 10 или сообщений свыше 20. Скилл работает в связке с MCP agent-uml.

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

  • предотвратить ошибку HTTP 400 и пустой экран в PlantUML
  • настроить кликабельность и аннотации элементов через алиасы
  • разделить перегруженные диаграммы компонентов и последовательностей
  • подобрать пресеты skinparam под стили холста agent-uml

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

  • Проверь синтаксис диаграммы перед вызовом diagram_upsert на холсте agent-uml
  • Разбей компонентную схему по порогам декомпозиции, если в ней больше 12 блоков
  • Подготовь PlantUML с нужными skinparam-пресетами и алиасами для design_create

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

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill diagram-quality -a claude-code

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

~/.claude/skills/diagram-quality/SKILL.md

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

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

Вопросы о diagram-quality

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

Выполните команду npx skills add pproenca/dot-skills --skill diagram-quality -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/diagram-quality/SKILL.md.

Зачем нужен скилл diagram-quality?

Он содержит 18 правил синтаксической безопасности и эвристики декомпозиции для PlantUML. Скилл исключает появление пустых холстов и сохраняет кликабельность узлов в интерфейсе agent-uml.

Когда скилл требует разбивать диаграмму?

Пороги требуют деления, если компонентная схема содержит свыше 12 элементов, модель классов — более 15, а диаграмма последовательности превышает 10 участников или 20 сообщений.

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

SKILL.md · MIT
---
name: diagram-quality
description: "PlantUML diagram quality on the agent-uml collaborative canvas — three tiers: rendering safety (syntax that prevents HTTP 400 blank canvas), conversation mechanics (when to push a version vs ask a question, what to write in the message parameter), and design effectiveness (decomposition thresholds, cross-diagram traceability, export readiness). Trigger whenever calling agent-uml MCP tools (design_create, diagram_upsert, design_feedback, design_export) — even when the task seems simple, since a missing `as alias` makes elements un-annotatable and a skinparam mismatch makes diagrams unreadable."
---
# agent-uml Diagram Quality Best Practices

Make the human-Claude design conversation converge faster on the agent-uml canvas.

## When to Apply

- Before every `diagram_upsert` call — check syntax safety rules and apply the correct skinparam preset
- After every `design_feedback` response — consult the versioning decision table to choose the right next action
- When starting a new design session — follow the progressive detail layers for diagram ordering
- Before calling `design_export` — run the export-readiness checklist
- When a diagram renders blank or elements aren't clickable — consult rendering safety rules

## Rule Categories by Priority

| Priority | Section | Impact | Reference |
|----------|---------|--------|-----------|
| 1 | Rendering Safety | CRITICAL | [syn-safety.md](references/syn-safety.md), [_presets.md](references/_presets.md) |
| 2 | Conversation Mechanics | HIGH | [_conversation.md](references/_conversation.md) |
| 3 | Design Effectiveness | MEDIUM | [_design.md](references/_design.md) |

## Quick Reference

### 1. Rendering Safety (CRITICAL)

18 rules that prevent blank canvas and ensure interactive SVG. Read [syn-safety.md](references/syn-safety.md) before writing any PlantUML source.

Key rules:
- **Every element gets `as Alias`** — without it, element is not clickable on canvas
- **`skinparam backgroundColor transparent`** — white default clashes with #f4f1ec canvas
- **Copy the correct preset from [_presets.md](references/_presets.md)** — one block per diagram type, matched to canvas CSS variables

### 2. Conversation Mechanics (HIGH)

5 decision tables for the feedback-response loop. Read [_conversation.md](references/_conversation.md) when deciding what tool to call next.

Key tables:
- **Table 4: Signal → Action** — maps annotation, chat, silence, and timeout to the correct tool call
- **Table 5: Message content** — what to write in the `message` parameter (explain change + ask focusing question)

### 3. Design Effectiveness (MEDIUM)

4 heuristics with concrete thresholds. Read [_design.md](references/_design.md) when planning diagram sequences or preparing for export.

Key heuristics:
- **Progressive detail layers** — L1 context → L2 container → L3 class → L4 behavior → L5 state
- **Cross-reference traceability** — every sequence participant must map to a component; every interface belongs to exactly one component boundary
- **Decomposition thresholds** — component >12, class >15, sequence >10 participants or >20 messages → split

## How to Use

1. **Starting a session:** Read [_conversation.md](references/_conversation.md) Table 3 (diagram type scope) to decide which diagram to create first
2. **Writing PlantUML:** Apply the skinparam preset from [_presets.md](references/_presets.md), then check [syn-safety.md](references/syn-safety.md) for the rules relevant to your diagram type
3. **After feedback:** Consult [_conversation.md](references/_conversation.md) Table 4 (signal → action) to decide whether to push a new version or reply with a question
4. **Before export:** Run the checklist in [_design.md](references/_design.md) Heuristic 4

## Reference Files

| File | Description |
|------|-------------|
| [references/_sections.md](references/_sections.md) | Section definitions and ordering |
| [references/syn-safety.md](references/syn-safety.md) | 18 rendering safety rules (Incorrect/Correct) |
| [references/_presets.md](references/_presets.md) | 5 copy-paste skinparam presets per diagram type |
| [references/_conversation.md](references/_conversation.md) | 5 decision tables for conversation loop |
| [references/_design.md](references/_design.md) | 4 heuristics with thresholds |
| [assets/templates/_template.md](assets/templates/_template.md) | Template for adding new rules |
| [metadata.json](metadata.json) | Version and reference information |

© pproenca · MIT · pproenca/dot-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
diagram-architect davila7 Субагент diagram-architect для Claude Code создаёт технические диаграммы в ASCII, Mermaid, PlantUML и Draw.io. Подключается к задачам по архитектуре, схемам баз данных, потокам и зависимостям. CX Codex 1 178установок markdown-viewer-skills podo Скилл markdown-viewer-skills для Claude Code и Codex выбирает движок для UML, сетевых схем, графиков и инфографики в Markdown. Создаёт схемы для документации. CX Codex +1 202установок plantuml-skill Agents365-ai Скилл plantuml-skill для Claude Code и других ИИ-агентов: пишет .puml-файлы и рендерит их в PNG или SVG. Строит схему из кода или текстового описания. CX Codex +1 4 200установок diagram-generator zhaoxuya520 Скилл diagram-generator для Claude Code генерирует, проверяет и рендерит диаграммы из текста, кода, схем и таблиц. Создаёт диаграммы архитектур, процессов и UML-модели. CX Codex +1 1 500установок plantuml-diagram-generator Jeremy Longshore Скилл plantuml-diagram-generator генерирует схемы и код PlantUML для визуальной документации. Скилл включается сам, когда в диалоге с ассистентом упоминаются диаграммы или ключевое слово plantuml. CX Codex +1 123установок uml-and-software-architecture-visualization официальный OpenAI Скилл uml-and-software-architecture-visualization помогает выбрать нотацию и формат для UML-диаграмм, схем архитектуры, процессов и данных. Подключайте его, когда нужно описать структуру или поведение системы. CX Codex GP ChatGPT +1 24установок

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

Весь набор →
clean-code-ts-react Скилл clean-code-ts-react переносит принципы Clean Code Роберта Мартина на TypeScript 5.x и React 19. Помогает на код-ревью, при рефакторинге и проектировании компонентов или функций. CX Codex +1 238установок cli-for-agents Скилл cli-for-agents для Claude Code помогает проектировать и проверять CLI, которым пользуются ИИ-агенты и автоматизация. Он включается при работе с подкомандами, флагами, справкой и сообщениями об ошибках. CX Codex +1 237установок eval-mcp Скилл eval-mcp проверяет схемы MCP-сервера и точность выбора инструментов моделью. Находит пересечения в описаниях и тестирует вызовы на синтетических запросах. CX Codex +1 234установок threat-patch Скилл threat-patch берёт находки сканера или модель угроз и превращает их в небольшие патчи кода с описанием правок и шагами проверки. CX Codex +1 232установок drizzle-sqlite Скилл drizzle-sqlite помогает писать и проверять Drizzle ORM для SQLite: схемы, миграции, запросы, транзакции и типы. Подходит для рефакторинга SQLite-кода. CX Codex +1 221установок cli-review-runner Скилл cli-review-runner для Claude Code проверяет CLI-команду по 45 правилам каталога cli-for-agents и оценивает, может ли агент безопасно использовать её в пайплайне. CX Codex +1 219установок openai-codex-rust-patterns Скилл openai-codex-rust-patterns добавляет 63 инженерных правила для разработки на Rust из кодовой базы агента OpenAI Codex. Помогает писать надёжный async-код, изолировать подпроцессы и проектировать enum-ошибки. CX Codex +1 219установок marketplace-search-recsys-planning Скилл marketplace-search-recsys-planning для Claude Code помогает планировать поиск и рекомендации в маркетплейсе на OpenSearch: от структуры индекса до оценки качества. Охватывает планирование новой и разбор существующей системы. CX Codex +1 211установок

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

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