What it does
drawthe.net draws network diagrams dynamically from a text file describing the placement, layout and icons. Given a yaml file describing the hierarchy of the network and it's connections, a resulting diagram will be created.
- Connects Instruction files the AI reads
- Account or key No key found in README or SKILL.md
- Category Other
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/skills/cidrblock-drawthe-net)Similar Skills
Same kind of work, ordered like the Skills list
| This one drawthe.net | llmfit | claude-video | VideoCaptioner | claude-cookbooks | |
|---|---|---|---|---|---|
| Maker | cidrblock | AlexsJones | bradautomates | WEIFENG2333 | anthropics |
| Skills | 1 | 1 | 1 | 1 | 4 |
| GitHub stars | 1,184 | 39,036 | 21,085 | 16,557 | 54,799 |
| Last code change | Nov 13, 2026 | Nov 16, 2026 | Sep 25, 2026 | Sep 12, 2026 | Nov 5, 2026 |
| License | MIT | MIT | MIT | GPL-3.0 | MIT |
1 skills (instruction sets) by cidrblock that an AI reads and follows · not an MCP server
How a Skill differs from MCP
MCP = the hands
Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.
Skill = the manual
A text file that teaches the AI how to do a task. It connects to nothing.
Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.
Works with
Codex
From the maker’s README and the folders in the repo
Install
Is it safe?
- Who made it
GitHub account cidrblock (person), 10 years old
- Use and upkeep
★ 1,184 stars · code last changed Nov 13, 2026
- Any scripts?
75 scripts that can run on a computer: .eslintrc.cjs, bin/container-entrypoint.sh, bin/drawthe-net.js, mcp/dsl-reference.ts and 71 more
- Uses the internet?
Scripts that go online: src/renderer/icon-loader.ts
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 8aeeacc (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
First: which AI do you use?
Pick your app and this page shows only how to install it there
Option 1Upload to claude.ai (web and app)
Uploading to claude.ai would fail: the description is over 200 characters (389). Use "Let the AI install it" instead
Option 1Let Claude Code install it
Copy this sentence and paste it into a Claude Code chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Restart Claude Code, then type /drawthe.net or ask for a matching task and Claude picks it up
Checked against official docs Nov 12, 2026 · Source: code.claude.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.claude/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/cidrblock/drawthe.net.git /tmp/popnx-skill-cidrblock-drawthe-net-8aeeacc && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-cidrblock-drawthe-net-8aeeacc/.' ~/.claude/skills/drawthe.netRestart Claude Code, then type /drawthe.net or ask for a matching task and Claude picks it up
ChatGPT desktop app
The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills
Option 1Let ChatGPT install it
Open Codex in the ChatGPT desktop app and paste this sentence into the chat
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2Put the folder there yourself
Put the drawthe-net folder at ~/.agents/skills/drawthe-net
~ is your home folder ($HOME)
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/cidrblock/drawthe.net.git /tmp/popnx-skill-cidrblock-drawthe-net-8aeeacc && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-cidrblock-drawthe-net-8aeeacc/.' ~/.agents/skills/drawthe.net
After installing
- ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
- To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
- Codex picks up newly installed skills by itself; if one does not show up, restart Codex
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
ChatGPT on the web and mobile
Skills you install yourself do not work here; only skills that come with a plugin from the directory
To use this skill with ChatGPT, use the ChatGPT desktop app as above
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
Option 1Let Codex install it
Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/cidrblock/drawthe.net.git /tmp/popnx-skill-cidrblock-drawthe-net-8aeeacc && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-cidrblock-drawthe-net-8aeeacc/.' ~/.agents/skills/drawthe.netRestart Codex, then ask for a matching task; Codex lists the skill
Option 1Let Cursor install it
Copy this sentence and paste it into a Cursor chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
In Cursor’s Agent chat, type / and pick drawthe.net
Checked against official docs Nov 12, 2026 · Source: cursor.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.cursor/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/cidrblock/drawthe.net.git /tmp/popnx-skill-cidrblock-drawthe-net-8aeeacc && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-cidrblock-drawthe-net-8aeeacc/.' ~/.cursor/skills/drawthe.netIn Cursor’s Agent chat, type / and pick drawthe.net
Option 1Let the AI install it
For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.
Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026
✓ Commands checked Nov 18, 2026
View the original SKILL.md
The text below comes from the maker’s repo, not from PopNx MCP
Showing the first 8,000 characters · Open the full file on GitHub
---
name: drawthe.net
description: Draw network/architecture diagrams (AWS, Azure, Cisco) from a natural-language description or from a proposed system architecture, using the drawthe.net MCP server's YAML DSL and icon tools. Use this skill whenever the user asks to "draw a diagram", "create an architecture diagram", "visualize this infrastructure", "sketch the network", or asks you to propose/illustrate a system design.
---
# drawthe.net diagram authoring skill
This skill teaches an agent how to turn a description (or a proposed
architecture) into a drawthe.net YAML diagram and render it via the
drawthe.net MCP server's tools. The result should be a build blueprint:
someone reading it should understand what to provision, how traffic and
data move, what is required versus optional, and what to configure next.
### ARCHITECTURE DIAGRAM DESIGN SYSTEM & AESTHETIC DIRECTIVES
When authoring system architecture diagrams in YAML, adhere strictly to these architectural visual design principles:
#### 1. Architectural Layout & Directional Flow
* **Determine the Primary Axis:**
* **Top-to-Bottom (Layered Systems):** Use for Tiered/Client-Server architectures (Presentation → Processing/Logic → Storage → External Infrastructure).
* **Left-to-Right (Data & Workflow Pipelines):** Use for event-driven systems, ETL pipelines, integration flows, or user journey sequences.
* **Dedicated Cross-Cutting Rows/Columns:** Place auxiliary or cross-cutting services (e.g., Logging, Authentication, Telemetry, Storage) on a dedicated side column or bottom row rather than interspersing them within the core flow.
* **Spatial Breathability:** Always leave 1–2 empty grid steps between connected components to provide space for connection lines without crossing icons or text.
#### 2. Restrained Color System & Contrast
* **Canvas:** Use the established white canvas (`white`) unless the user requests another treatment.
* **Default Elements:** Use dark readable text and lines (`black` for labels and `#334155` for connections/borders). Do not use the historical orange renderer defaults for blueprint styling.
* **Containers:** Use light-gray or very lightly tinted fills with a consistent border, such as `#F1F5F9` with `#94A3B8`. Container color should establish hierarchy without competing with the topology.
* **Icons:** Preserve native vendor icon artwork. Do not impose a diagram-wide accent palette or override icon fills/strokes unless the selected icon has been previewed and the override is intentional.
#### 3. Domain Grouping & Boundaries
* **Container Enclosure:** Wrap related components in named groups (e.g., Services, Data Domain, External System, Core Boundary).
* **Line Style Rules:**
* **Solid Lines:** Direct synchronous calls, primary system processes, or hard structural boundaries.
* **Dashed Lines (`strokeDashArray: [4, 4]`):** Asynchronous events, metadata/telemetry flows, or logical/trust boundaries.
* **Group Headers:** Choose one placement for all group names, commonly `bottomMiddle` for north-to-south flows, and keep it consistent unless a collision is unavoidable.
#### 4. Typography & Label Symmetry
* **Unified Alignment:** Standardize `textLocation` across the entire diagram. Use the selected group/icon placement consistently; the established blueprint default is `bottomMiddle`. Never mix alignments within the same diagram unless a documented collision makes it unavoidable.
* **Readable Display Names:** Always use explicit, concise display text with the `text:` attribute (e.g., `text: "Auth Service"`) instead of raw technical identifiers (e.g., `auth_svc_node_01`).
#### 5. Connection Line Discipline
* Align connected components along straight grid lines to eliminate diagonal line clutter.
* Group multi-destination fan-outs neatly through shared alignment rather than overlapping multiple connection lines across the canvas.
## Prerequisites
The drawthe.net MCP server must be connected and expose these tools:
- `get_dsl_reference` — returns the full YAML DSL syntax reference.
- `list_icon_families` — lists available icon families and icon counts.
- `list_icons` — lists/searches icon names within a family.
- `get_icon` / `get_icon_svg` — preview a specific icon (PNG/SVG) to confirm it looks right before using it.
- `render_diagram` — renders a YAML diagram to PNG or SVG.
## Procedure
1. **Read the DSL reference first.** Call `get_dsl_reference` before
writing any YAML if you have not already seen it in this conversation.
Do not guess at the syntax — the `diagram`, `title`, `icons`, `notes`,
`groups`, and `connections` sections each have specific required and
optional fields.
2. **Identify the components in the description.** Break the request down
into concrete entities (servers, load balancers, databases, gateways,
VPCs/VNets, users, external services, etc.) and the connections between
them. If the user proposes an architecture rather than describing an
existing one, design a sensible one first (reasonable tiers, redundancy,
networking boundaries), then diagram it.
State the architecture assumption in the title or a note when the
request is ambiguous. For example, RHDH on ROSA is materially different
from RHDH on EKS or RHDH on EC2.
Design the blueprint before choosing icons. Organize it into these layers
where they apply:
- prerequisites and network foundation: account, region, VPC, AZs,
public/private subnets, routing, security groups, IAM, and certificates;
- request path: users, DNS, edge/load balancer, ingress, and application;
- platform: cluster, namespaces, operators, ingress controller, and
workload replicas;
- dependencies: identity, database, secrets, object storage, registries,
source control, and observability;
- build notes: required configuration, optional choices, and an ordered
implementation sequence.
Do not draw every plausible service. Include a component only when it
answers a deployment question, and mark it as required, optional, or
external in its label or notes.
3. **Choose the right icon family based on vendor keywords in the
request** — there is no fixed default family. Inspect the request for
vendor/platform signals:
- AWS services/terms → `aws2026` (preferred, current) or `aws` (legacy).
- Azure services/terms → `azure2026` (preferred), or `azureCloud` /
`azureEnterprise` (legacy).
- Cisco/network hardware terms → `cisco2026` (preferred) or `cisco` (legacy).
- Generic/vendor-neutral request → pick whichever family has the closest
conceptually matching icon; prefer the modern `*2026` families.
Call `list_icon_families` if you're unsure what's available.
4. **Never invent an icon name.** For every component, call `list_icons`
with the family and a keyword query (e.g. `query: "load_balanc"`) to find
the real icon name before writing an `icon:` reference in YAML. Use
`get_icon` or `get_icon_svg` to visually confirm an ambiguous match
before committing to it.
5. **Always prefer a meaningful, accurate icon over a generic
placeholder.** If an exact icon for a component doesn't exist in the
chosen family, search for the closest conceptually similar icon (e.g. a
generic "server" or "compute" icon for an unlisted service type) rather
than defaulting to a plain box or an unrelated icon. Only fall back to a
generic shape (e.g. via `notes`) if truly no reasonable icon exists in
any relevant family.
6. **Write the YAML diagram** using the DSL: define `diagram` (grid size,
background), optionally `title`, then `icons` (with `x`/`y` grid
coordinates, using relative positions like `x: "+1"` where convenient),
`groups` to box related components together, and `connections` between
icon keys. Use YAML anchors for repeated styling if helpful.
Start from the light, readable style below unless the user explicitly
requests a different visual treatment:
Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
From GitHub
- GitHub stars
- 1,184
- Maker
- cidrblock
- License
- MIT
- Last code change
- Nov 13, 2026
- SKILL.md files in the repo (including translated copies and templates)
- 2
- Topics
- diagram, icons, network