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

diagramming-expert — скилл для Claude Code: схемы и установка

Скилл diagramming-expert для Claude Code превращает архитектуру, процессы и связи между сущностями в текстовые схемы. Показывает их блоками и стрелками.

MIT 232 установок ★ 274 обновлён 2026-10-30

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

Что делает diagramming-expert

diagramming-expert строит схемы из ASCII-символов, Unicode-рамок и структурированных обозначений. Он помогает визуализировать архитектуру систем, потоки процессов, иерархии, деревья решений, связи данных и циклы обратной связи. Диаграммы остаются обычным текстом, поэтому их можно читать и править в моноширинном редакторе.

Скилл группирует связанные элементы, выделяет уровни и старается не перегружать схему декором или пересекающимися стрелками. В комплекте есть шаблоны блок-схем, деревьев решений, слоистой архитектуры и циклов, а также ссылки на справочники по типам диаграмм и символам. Это скилл для текстовой визуализации: для редактирования фотографий, векторной графики и точных макетов он не предназначен.

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

  • показать компоненты системы и связи между ними
  • разложить процесс по шагам и решениям
  • изобразить иерархию или модель данных
  • сравнить состояния до и после
  • объяснить цикл обратной связи

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

  • Покажи архитектуру сервиса как текстовую диаграмму слоёв.
  • Разложи этот процесс на блок-схему с ветками решений.
  • Изобрази связи между сущностями модели данных.

Как установить diagramming-expert

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill diagramming-expert -a claude-code

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

~/.claude/skills/diagramming-expert/SKILL.md

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

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

Вопросы о diagramming-expert

Как установить diagramming-expert в Claude Code?

Выполните npx skills add curiositech/some_claude_skills --skill diagramming-expert -a claude-code. Файл скилла появится по пути ~/.claude/skills/diagramming-expert/SKILL.md.

Что делает diagramming-expert?

Создаёт текстовые диаграммы систем, процессов, иерархий и связей. Использует ASCII-символы, Unicode-рамки и структурированные обозначения.

Подходит ли diagramming-expert для макетов интерфейса?

Он рассчитан на схемы в виде текста. Для точных макетов, векторной графики и редактирования фотографий скилл не предназначен.

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

SKILL.md · MIT
---
name: diagramming-expert
description: Master of text-based visual communication using ASCII art, Unicode box-drawing, and structured diagram notation. Creates clear, maintainable diagrams for systems, processes, hierarchies, relationships,
  and psychological structures. Proactively generates diagrams to enhance understanding. Activate on visualization needs, system architecture, process flows, psychological mapping, or when complex concepts
  would benefit from visual representation. NOT for photo editing, vector graphics, or GUI-based design tools.
allowed-tools: Read,Write,Edit
metadata:
  category: Content & Writing
  pairs-with:
  - skill: technical-writer
    reason: Visual documentation for technical content
  - skill: api-architect
    reason: Diagram API architectures
  tags:
  - diagrams
  - ascii
  - visualization
  - architecture
  - documentation
---

# Diagramming Expert

Master of text-based visual communication. Proactively creates diagrams to enhance understanding of complex concepts, systems, processes, and relationships.

## Core Philosophy

> "Above all else, show the data." — Edward Tufte

Diagrams should:
1. **Reduce cognitive load** — not add to it
2. **Maximize signal** — minimize noise (data-ink ratio)
3. **Be maintainable** — easy to update as understanding evolves
4. **Work everywhere** — monospace text renders universally

## When to Use This Skill

**Use for:**
- System architectures and component relationships
- Process flows and state transitions
- Hierarchical structures (org charts, taxonomies)
- Psychological structures (psyche maps, parts work)
- Decision trees and conditional logic
- Data relationships and entity models
- Feedback loops and causal systems
- Before/after comparisons
- Timelines and sequences

**NOT for:**
- Photo editing or image manipulation
- Vector graphics or GUI-based design tools
- Pixel-perfect mockups (use design tools)
- Complex 3D visualizations

**Ask yourself:** "Would this be clearer with a picture?"
If yes → diagram it.

## Diagram Types Reference

> See `/references/diagram-types.md` for complete taxonomy

### Quick Reference

| Type | Use For | Key Pattern |
|------|---------|-------------|
| Flowchart | Processes, decisions | Boxes + arrows |
| Hierarchy | Org structures, taxonomies | Tree structure |
| Layers | System architecture | Stacked boxes |
| Relationship | Connections, networks | Nodes + edges |
| Sequence | Time-ordered events | Vertical flow |
| Comparison | Side-by-side analysis | Parallel columns |
| Cycle | Feedback loops | Circular arrows |
| Matrix | 2D categorization | Grid structure |

## Character Reference

> See `/references/unicode-characters.md` for complete character set

### Essential Characters

```
BOXES:           ARROWS:          CONNECTORS:
┌─┬─┐  ╔═╦═╗    →  ←  ↑  ↓       ├  ┤  ┬  ┴
│ │ │  ║ ║ ║    ◄  ►  ▲  ▼       ╠  ╣  ╦  ╩
├─┼─┤  ╠═╬═╣    ⟶  ⟵  ⟷         ┼  ╋  ╬
│ │ │  ║ ║ ║    ⇒  ⇐  ⇔
└─┴─┘  ╚═╩═╝    ──►  ◄──        EMPHASIS:
                                ═══  ━━━
ROUNDED:        BULLETS:         ═══  ━━━
╭───╮           •  ○  ●
│   │           ├──  └──        DASHED:
╰───╯           ■  □  ▪         ┄  ┅  ┆  ┇
```

## Design Principles

### 1. Tufte's Data-Ink Ratio

```
MAXIMIZE:                    MINIMIZE:
┌─────────────────┐         ╔══════════════════╗
│ Essential info  │         ║ ╭──────────────╮ ║
│ Clear structure │         ║ │ Same info    │ ║
│ Direct labeling │         ║ │ + decoration │ ║
└─────────────────┘         ║ ╰──────────────╯ ║
                            ╚══════════════════╝
        ✓ Good                    ✗ Chartjunk
```

### 2. Cognitive Load Management

```
CHUNKING: Group related elements

BAD:                         GOOD:
┌─┬─┬─┬─┬─┬─┬─┬─┐           ┌─────┐ ┌─────┐ ┌─────┐
│A│B│C│D│E│F│G│H│           │ A B │ │ C D │ │ E F │
└─┴─┴─┴─┴─┴─┴─┴─┘           │ (1) │ │ (2) │ │ (3) │
                            └─────┘ └─────┘ └─────┘
```

### 3. Gestalt Principles

```
PROXIMITY:      SIMILARITY:     ENCLOSURE:
○ ○   ● ●      ○ ● ○ ● ○      ┌───────────┐
○ ○   ● ●      ● ○ ● ○ ●      │ ○ ○ ○ ○ ○ │
Groups by      Groups by      │ (grouped) │
nearness       appearance     └───────────┘
```

### 4. Visual Hierarchy

```
EMPHASIS LEVELS:

═══════════════════════    Level 1: Double/Heavy
───────────────────────    Level 2: Single
- - - - - - - - - - - -    Level 3: Dashed
. . . . . . . . . . . .    Level 4: Dotted

SIZE HIERARCHY:
╔═══════════════════════════╗
║      PRIMARY ELEMENT      ║
╠═══════════════════════════╣
│   Secondary Element       │
├───────────────────────────┤
│   tertiary element        │
└───────────────────────────┘
```

## Common Patterns

> See `/references/patterns-library.md` for comprehensive patterns

### Process Flow

```
┌─────────┐    ┌─────────┐    ┌─────────┐
│  Start  │───►│ Process │───►│   End   │
└─────────┘    └─────────┘    └─────────┘
```

### Decision Tree

```
                ┌──────────┐
                │ Decision │
                └────┬─────┘
           ┌─────────┴────────┐
           ▼                  ▼
      ┌────────┐         ┌────────┐
      │  Yes   │         │   No   │
      └────────┘         └────────┘
```

### Layered Architecture

```
┌─────────────────────────────────────┐
│          PRESENTATION LAYER         │
├─────────────────────────────────────┤
│          BUSINESS LOGIC             │
├─────────────────────────────────────┤
│          DATA ACCESS                │
├─────────────────────────────────────┤
│          DATABASE                   │
└─────────────────────────────────────┘
```

### Feedback Loop

```
        ┌──────────────────┐
        │                  │
        ▼                  │
    ┌───────┐          ┌───┴───┐
    │ Input │─────────►│Output │
    └───────┘          └───────┘
        ▲                  │
        │                  │
        └──────────────────┘
```

## Anti-Patterns

### Chartjunk
```
✗ BAD: Excessive decoration
╔══════════════════════════════════╗
║ ╭━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╮ ║
║ ┃ ★ ★ ★  IMPORTANT INFO  ★ ★ ★ ┃ ║
║ ╰━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╯ ║
╚══════════════════════════════════╝

✓ GOOD: Clean and direct
┌──────────────────┐
│  Important Info  │
└──────────────────┘
```

### Spaghetti Arrows
```
✗ BAD: Crossing lines, unclear flow
    ┌───┐     ┌───┐
    │ A │──┬──│ B │
    └───┘  │  └───┘
      │    ╳    │
    ┌─┴─┐  │  ┌─┴─┐
    │ C │──┴──│ D │
    └───┘     └───┘

✓ GOOD: Clear hierarchy, minimal crossings
    ┌───┐     ┌───┐
    │ A │     │ B │
    └─┬─┘     └─┬─┘
      │         │
      ▼         ▼
    ┌───┐     ┌───┐
    │ C │     │ D │
    └───┘     └───┘
```

### Information Overload
```
✗ BAD: Too much in one diagram
[Cramming 15 concepts with 30 arrows]

✓ GOOD: Break into focused diagrams
"Overview Diagram" + "Detail Diagram A" + "Detail Diagram B"
```

## Skill Integrations

Works with:
- **jungian-psychologist**: Psyche mapping, parts work diagrams
- **system-architect**: System architecture diagrams
- **backend-architect**: API and data flow diagrams

## Jungian Psychology Diagrams

> See `/references/jungian-diagrams.md` for psychology-specific patterns

This skill integrates closely with `jungian-psychologist` for:
- Psyche structure mapping
- Parts work visualization
- Shadow content diagrams
- Individuation journey maps
- Complex anatomy diagrams
- Ego-Self axis visualization

## Mermaid Integration

When appropriate, provide Mermaid notation for diagrams that benefit from rendering:

```mermaid
graph TD
    A[Conscious] --> B[Personal Unconscious]
    B --> C[Collective Unconscious]
    B --> D[Complexes]
    C --> E[Archetypes]
```

## Workflow

1. **Understand the content** — What are we visualizing?
2. **Choose the right type** — Hierarchy? Process? Relationship?
3. **Sketch the structure** — Start rough, refine
4. **Apply principles** — Data-ink ratio, chunking, hierarchy
5. **Test readability** — Would someone new understand this?
6. **Iterate** — Diagrams improve with revision

---

**Remember**: A good diagram is worth a thousand words. Create them proactively whenever complex concepts arise.

© curiositech · MIT · curiositech/some_claude_skills

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

Все скиллы по теме «Дизайн» →
mermaid-diagramming NickCrew Скилл mermaid-diagramming учит агента рисовать диаграммы Mermaid: блок-схемы, sequence-диаграммы, ERD, состояния, Gantt и архитектурные виды, отдельно базовую и стилизованную версию. CX Codex +1 105установок mermaid-diagrams softaworks Плагин mermaid-diagrams для Claude Code помогает создавать диаграммы архитектуры, потоков данных и процессов прямо в редакторе. Запускается, когда нужно визуализировать структуру кода или задокументировать систему через схемы. ★ 2 707звёзд репо Agentic Mermaid adewale MCP-сервер Agentic Mermaid рендерит диаграммы Mermaid в форматах SVG, PNG или ASCII и даёт агентам типизированные операции для точной правки графов без переписывания исходника. CX Codex +1 ★ 72звёзд репо diagramming-processes riekelt Скилл diagramming-processes для ИИ-кодинга, который заставляет агента рисовать процессы, состояния и обмен сообщениями в виде диаграмм с исходником в git, а не картинок. CX Codex +1 26 400установок excalidraw-diagram coleam00 Скилл excalidraw-diagram для Claude Code: генерирует .excalidraw JSON-файлы схем архитектуры и процессов. Наглядно разбирает структуру системы или алгоритм без ручного рисования. CX Codex +1 8 900установок plantuml-diagram-generator Jeremy Longshore Скилл plantuml-diagram-generator генерирует схемы и код PlantUML для визуальной документации. Скилл включается сам, когда в диалоге с ассистентом упоминаются диаграммы или ключевое слово plantuml. CX Codex +1 123установок

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

Весь набор →
native-app-designer Скилл native-app-designer для дизайна iOS, Mac и веб-приложений, которые не выглядят шаблонно. Учит агента физике анимаций, пружинам и деталям, из-за которых интерфейс ощущается живым. CX Codex +1 241установок large-scale-map-visualization Скилл large-scale-map-visualization для веб-карт с десятками тысяч маркеров. Подсказывает, как кластеризовать точки, грузить данные по вьюпорту и не вешать браузер. CX Codex +1 240установок api-architect Скилл api-architect помогает проектировать REST, GraphQL и gRPC API: от контракта и схемы до документации и проверки спецификации. CX Codex +1 235установок vaporwave-glassomorphic-ui-designer Скилл vaporwave-glassomorphic-ui-designer для Claude Code описывает дизайн фото- и мемори-приложений на SwiftUI в стилях vaporwave и glassmorphism. Включает матовое стекло, неоновые пастели и ретрофутуристичное оформление. CX Codex +1 234установок design-critic Скилл design-critic для дизайн-ревью интерфейсов по 6 критериям с расчётом баллов и разбором кода компонентов. Помогает найти огрехи в верстке и доступности до релиза. CX Codex +1 230установок grief-companion Скилл grief-companion для Claude Code помогает пережить утрату: объясняет особенности горя, поддерживает при практических задачах и помогает создавать памятные тексты. CX Codex +1 229установок crisis-detection-intervention-ai Скилл crisis-detection-intervention-ai для Claude Code обнаруживает сигналы кризиса в пользовательском тексте и запускает безопасную эскалацию. Используется в приложениях поддержки и восстановления. CX Codex +1 227установок drone-inspection-specialist Скилл drone-inspection-specialist для анализа дроновых съёмок: пожары, крыши, град, тепловидение и 3D-реконструкция. Пригодится в оценке недвижимости и страховании. CX Codex +1 227установок

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

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