diagram-quality — скилл для Claude Code: что делает и как установить
Скилл diagram-quality задаёт правила отрисовки PlantUML на холсте agent-uml, предотвращая ошибки HTTP 400 и пустые схемы при работе с инструментами дизайна.
MIT 230 установок ★ 227 обновлён 2026-08-15
npx skills add pproenca/dot-skills --skill diagram-quality -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/diagram-quality/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/diagram-quality/
1Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill diagram-quality -a codex2Вручную: положить файлы
.agents/skills/diagram-quality/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill diagram-quality -a cursor2Вручную: положить файлы
.cursor/skills/diagram-quality/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pproenca/dot-skills skills/.experimental/diagram-quality2Вручную: положить файлы
.github/skills/diagram-quality/SKILL.md1Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill diagram-quality -a gemini-cli2Командой платформы
gemini skills install https://github.com/pproenca/dot-skills --path skills/.experimental/diagram-qualityВручную: положить файлы
.devin/skills/diagram-quality/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pproenca/dot-skills --skill diagram-quality -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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