diagrams-as-code — скилл для Claude Code: архитектурные схемы
Скилл diagrams-as-code для Claude Code создаёт архитектурные и инфраструктурные диаграммы на Python с библиотекой diagrams. Описывает схему кодом и формирует файл изображения.
Apache-2.0 ★ 173 обновлён 2026-10-24
npx skills add sammcj/agentic-coding --skill diagrams-as-code -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/diagrams-as-code/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/diagrams-as-code/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill diagrams-as-code -a codex2Вручную: положить файлы
.agents/skills/diagrams-as-code/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill diagrams-as-code -a cursor2Вручную: положить файлы
.cursor/skills/diagrams-as-code/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills_disabled/diagrams-as-code/SKILL.md2Вручную: положить файлы
.github/skills/diagrams-as-code/SKILL.md1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill diagrams-as-code -a gemini-cli2Командой платформы
gemini skills install https://github.com/sammcj/agentic-coding --path Skills_disabled/diagrams-as-codeВручную: положить файлы
.devin/skills/diagrams-as-code/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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