A skill for Agentic Diagrams

#agentic#skills#claude-code

A skill for Agentic Diagrams

Last post I open-sourced the schema behind Agentic Diagrams. A file format is only as useful as the things that can read and write it - so here’s the next piece: a skill.

What’s a skill?

A SKILL.md is a small markdown file with a description and a set of instructions. Skill-aware assistants like Claude Code read the description, decide when it applies, and follow the instructions when it does. No plugin to install, no binary to run - the assistant already knows how to do the work, the skill just tells it how you want it done for this specific job.

Think of it as a prompt you commit to disk. Except it only fires when relevant.

The agentic-diagrams skill

Drop it in, describe a system in plain English, and get back a valid .agentic.yaml you can import into the app.

Under the hood it:

  • Fetches the live spec on every run, so it picks node and edge types from the real schema instead of guessing
  • Writes the YAML using stable kebab-case IDs, a proper diagram block, and a scenarios section when you’ve described a flow
  • Validates with @agenticdiagrams/schema and fixes what it can

It also fires on the obvious triggers: “draft an agentic.yaml”, “diagram this multi-agent system”, “fix my agentic file”. You don’t have to ask for it by name.

Install

One line:

mkdir -p ~/.claude/skills/agentic-diagrams
curl -fsSL https://agenticdiagrams.com/skills/agentic-diagrams/SKILL.md \
  -o ~/.claude/skills/agentic-diagrams/SKILL.md

Then just describe your system to Claude Code. That’s the whole loop.

Why ship a skill, not a CLI?

Because the interesting work isn’t “generate YAML from a template” - it’s understanding a system from a conversation and mapping it onto the schema correctly. That’s what the assistant is already good at. The skill just keeps it on the rails: fetch the spec, don’t invent node types, validate before you finish.

A proper skills manager - discovery, versioning, install - is on the way. For now it’s a single file you can paste into any skill-aware assistant.

Grab it:

Got an idea for another skill? Open a PR.