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

diagrams-as-code — скилл для Claude Code: архитектурные схемы

Скилл diagrams-as-code для Claude Code создаёт архитектурные и инфраструктурные диаграммы на Python с библиотекой diagrams. Описывает схему кодом и формирует файл изображения.

Apache-2.0 ★ 173 обновлён 2026-10-24

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

Что делает diagrams-as-code

Скилл проверяет наличие Graphviz и diagrams, затем создаёт Python-скрипт в рабочей папке, запускает его и сообщает путь к результату. Скрипт формирует изображение через Graphviz; можно задать направление схемы, формат файла, узлы, связи и вложенные кластеры. show=False оставляет запуск неинтерактивным.

Для узлов доступны категории облачных провайдеров, Kubernetes и локальной инфраструктуры; при необходимости можно добавить собственную иконку PNG. Без Graphviz скрипт завершится ошибкой, поэтому его наличие проверяется до генерации. Для оформления доступны атрибуты графа, узлов и связей, а один скрипт может создавать несколько форматов.

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

  • собрать архитектурную схему из Python-кода
  • показать потоки между сервисами и базами данных
  • сгруппировать компоненты по подсетям или кластерам
  • сохранить диаграмму в PNG и SVG

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

  • Создай архитектурную диаграмму AWS с EC2, Lambda и RDS и сохрани её в PNG.
  • Покажи поток запросов через ELB к двум узлам EC2, а затем к базе RDS.
  • Сгруппируй сервисы в кластеры VPC и Private Subnet и выведи схему в SVG.

Как установить diagrams-as-code

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill diagrams-as-code -a claude-code

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

~/.claude/skills/diagrams-as-code/SKILL.md

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

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

Вопросы о diagrams-as-code

Как установить diagrams-as-code в Claude Code?

Выполни npx skills add sammcj/agentic-coding --skill diagrams-as-code -a claude-code. Файл скилла находится по пути ~/.claude/skills/diagrams-as-code/SKILL.md.

Что делает diagrams-as-code?

Он помогает создавать архитектурные и инфраструктурные диаграммы с Python-библиотекой diagrams и Graphviz. Результат сохраняется как файл изображения.

Что нужно установить для работы diagrams-as-code?

Нужны Graphviz и Python-библиотека diagrams. Скилл проверяет их наличие перед запуском скрипта.

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

SKILL.md · Apache-2.0
---
name: diagrams-as-code
description: Use only when creating architecture diagrams with Python's `diagrams` library (mingrammer/diagrams).
allowed-tools: Bash(python3 *) Bash(uv *) Bash(pip install *) Bash(command -v *) Bash(brew install *) Read Write Edit Glob Grep
---

# Diagrams as Code

Generate architecture and infrastructure diagrams using the Python `diagrams` library. Diagrams are Python scripts that render to image files via Graphviz.

## Workflow

1. **Check prerequisites** - verify graphviz and diagrams are installed
2. **Write the diagram script** to a `.py` file in the user's working directory
3. **Run it** with `python3 <file>.py`
4. **Report the output path** to the user (image appears in working directory)

### Prerequisites check

```bash
command -v dot >/dev/null || brew install graphviz
uv pip install --system diagrams 2>/dev/null || pip install diagrams
```

Without graphviz, the script fails with a cryptic error. Always verify first.

## Core API

### Diagram context manager

```python
from diagrams import Diagram

with Diagram(
    name="Title",           # used as default filename (slugified)
    filename="output",      # override filename (no extension)
    direction="LR",         # LR | RL | TB | BT
    curvestyle="spline",    # spline | ortho | curved | polyline
    outformat="png",        # png | jpg | svg | pdf | dot (or list)
    show=False,             # ALWAYS False - prevents auto-opening
    strict=False,           # merge duplicate edges
    autolabel=False,        # prefix labels with provider/type
    graph_attr={},          # graphviz graph attributes
    node_attr={},           # graphviz node attributes
    edge_attr={},           # graphviz edge attributes
):
    ...
```

Always set `show=False` so the script runs non-interactively.

### Nodes

Import from `diagrams.<provider>.<category>`:

```python
from diagrams.aws.compute import EC2, Lambda, ECS
from diagrams.aws.database import RDS, Aurora
from diagrams.aws.network import ELB, Route53, CloudFront
from diagrams.k8s.compute import Pod, Deployment
from diagrams.onprem.database import PostgreSQL, MySQL
from diagrams.onprem.network import Nginx
```

See `references/providers.md` for the full provider and category listing with common node names.

### Data flow operators

```python
ELB("lb") >> EC2("web") >> RDS("db")    # left to right
RDS("db") << EC2("web")                  # right to left
RDS("primary") - RDS("replica")           # undirected
ELB("lb") >> [EC2("w1"), EC2("w2")]      # fan-out to list
```

Operator precedence matters: `-` (subtraction) binds more tightly than `>>` / `<<` (bitshift) in Python, so `A >> B - C` parses as `A >> (B - C)`. Wrap in parentheses when mixing: `(A >> B) - C`.

### Clusters

```python
from diagrams import Cluster

with Cluster("VPC"):
    with Cluster("Private Subnet"):
        svc = [ECS("svc1"), ECS("svc2")]
```

Unlimited nesting depth. Clusters accept `graph_attr` for styling (e.g. background colour).

### Edges

```python
from diagrams import Edge

node_a >> Edge(label="HTTPS", color="darkgreen", style="dashed") >> node_b
```

Attributes: `label` (text on the edge), `color` (X11 name or hex), `style` (solid | dashed | dotted | bold).

### Custom nodes

```python
from diagrams.custom import Custom

svc = Custom("My Service", "./icon.png")  # local PNG, ideally 256x256
```

## Key Techniques

- **Direction**: use `TB` for layered/hierarchical diagrams, `LR` for pipelines and flows
- **Transparent background**: `graph_attr={"bgcolor": "transparent"}`
- **Multiple outputs**: `outformat=["png", "svg"]`
- **Reduce edge noise**: import `Node` from `diagrams` and create blank junctions with `Node("", shape="plaintext", width="0", height="0")`, or merge overlapping edges with `graph_attr={"concentrate": "true", "splines": "spline"}`
- **Assign nodes to variables** when they connect to multiple other nodes
- **PEP 723** for standalone scripts so `uv run` handles the dependency automatically:
  ```python
  # /// script
  # dependencies = ["diagrams"]
  # ///
  ```

© sammcj · Apache-2.0 · sammcj/agentic-coding

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

Каталог скиллов SKILL.md →
drawio-logical-diagrams giuseppe-trisciuoglio Скилл drawio-logical-diagrams для Claude Code генерирует файлы .drawio в нативном XML-формате для логических схем, архитектуры систем, BPMN и UML. Визуализирует логику без облачных сервисов. CX Codex +1 4 200установок eraser-diagrams Eraser Labs Скилл eraser-diagrams для Claude Code, Cursor, Codex и других агентов: строит архитектурные диаграммы из кода, инфраструктурных файлов или описания через Eraser API. CX Codex +1 2 800установок drawio-diagrams stark-ai-de Скилл drawio-diagrams создаёт, редактирует и проверяет файлы .drawio прямо в диалоге с агентом. Он собирает технические схемы и архитектуру, но не строит аналитические графики. CX Codex +1 2 700установок architecture-diagrams aj-geddes Скилл architecture-diagrams помогает генерировать схемы архитектуры, потоки данных и C4-диаграммы в текстовом формате Mermaid или PlantUML. Пригодится при оформлении технической документации прямо в чате с агентом. CX Codex +1 2 000установок aws-diagrams Eraser Labs Скилл aws-diagrams для Claude Code и Codex, который строит архитектурные схемы AWS из CloudFormation, вывода AWS CLI или текстового описания. Распознаёт сервисы, их связи и генерирует диаграмму в Eraser DSL. CX Codex +1 1 200установок mermaid-diagrams davila7 Скилл mermaid-diagrams для Claude Code — учит агента писать диаграммы Mermaid: классы, последовательности, ERD, C4, флоучарты. Документирует архитектуру и схемы БД. CX Codex +1 1 180установок

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

Весь набор →
critical-reviewer Субагент critical-reviewer проверяет недавние изменения в коде, документах, планах и дизайне, затем выдаёт приоритетные замечания. Он пригодится для критического самообзора перед тем, как вы внесёте исправления. CX Codex ★ 173звёзд репо quick-researcher Субагент quick-researcher для Claude Code извлекает из веба опубликованные факты и возвращает каждый со ссылкой на источник. Ищет ответы и заполняет списки цен, квот, лимитов и версий. CX Codex ★ 173звёзд репо ambitious-model-use Скилл ambitious-model-use переосмысляет задачу перед тем, как её решать. Вместо того чтобы просто улучшить промпт, анализирует реальный результат, который вам нужен, и предлагает глубже копать в данные или привлечь смежные области. CX Codex +1 ★ 173звёзд репо demo-recorder Скилл demo-recorder записывает скриптовые видеодемо веб-приложений через headless Chromium в 3K 60fps и накладывает озвучку через Cloney. CX Codex +1 ★ 173звёзд репо liteparse Скилл liteparse извлекает текст и структуру из PDF, DOCX, PPTX, XLSX и картинок в markdown локально, без облаков и LLM. CX Codex +1 ★ 173звёзд репо analyse-design Скилл analyse-design для Claude Code анализирует код и скриншоты приложения, сайта или документа и описывает дизайн-систему. Помогает провести аудит интерфейса и создать согласованные компоненты. CX Codex +1 ★ 173звёзд репо invokeai-image-gen Скилл invokeai-image-gen для генерации изображений через локальный API InvokeAI с поддержкой FLUX.2 Klein, Z-Image Turbo и SDXL. Автоматически подбирает параметры под модель, сохраняет результат в файл. CX Codex +1 ★ 173звёзд репо qa-to-issues Скилл qa-to-issues превращает баг-репорты в готовые задачи на GitHub через диалог. Скилл опрашивает вас, изучает репозиторий и сам публикует тикеты без лишних деталей реализации. CX Codex +1 ★ 173звёзд репо

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

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