Agent skill

Specialist Solution Diagrammer

by HoangNguyen0403 in HoangNguyen0403/agent-skills-standard

Draws one evidence-grounded architecture diagram as an editable draw.io file plus a rendered image, from an evidence bundle supplied by the caller.

MITAuto-check passedDevelopment

Install Specialist Solution Diagrammer

skills CLI
$ npx skills add HoangNguyen0403/agent-skills-standard --skill specialist-solution-diagrammer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HoangNguyen0403/agent-skills-standard specialist-solution-diagrammer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HoangNguyen0403/agent-skills-standard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/specialists/specialist-solution-diagrammer .claude/skills/specialist-solution-diagrammer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
specialist-solution-diagrammer
GitHub stars
572
Token cost
~1k tokens
SKILL.md length
414 words
Files
2
Skills in repo
211
Repo updated
First seen
Licence
MIT

At a glance

Draws one evidence-grounded architecture diagram as an editable draw.io file plus a rendered image, from an evidence bundle supplied by the caller.

  • Works in 8 steps: Restate the audience, the diagram type,… → Extract nodes and edges from the bundle… → For every selected view, assign… → …
  • Produce a system context
  • SKILL.md covers Priority: P1 (HIGH), Role, Budget and Steps, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Specialist Solution Diagrammer is an agent skill from HoangNguyen0403/agent-skills-standard. Draws one evidence-grounded architecture diagram as an editable draw.io file plus a rendered image, from an evidence bundle supplied by the caller. Use to produce a system context, container, component, deployment, data flow, sequence, state, or ERD diagram; spawn one per diagram for a batch.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `evals/evals.json`).

It sits in Development, covering Diagrams, Dispute resolution and Deployment. It works with draw.io. The repository describes itself as: A collection of Agent Skills Standard and Best Practice for Programming Languages, Frameworks that help our AI Agent follow best practies on frameworks and programming laguages. The licence is MIT.

When your agent uses it

  • Produce a system context
  • Spawn one per diagram for a batch

Example prompts

  • “Use the specialist-solution-diagrammer skill to draw one evidence-grounded architecture diagram as an editable draw.io file plus a rendered image…”
  • “/specialist-solution-diagrammer”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Restate the audience, the diagram type, and the one question this diagram answers.
  2. Extract nodes and edges from the bundle per references/source-extraction.md, attaching
  3. For every selected view, assign canonical identity values, lifecycle
  4. Write the spec per references/diagram-spec.md. For ERD, use the existing schema generator;
  5. Run scripts/validate_spec.py; fix the spec, never the validator.
  6. Run scripts/render_drawio.py --strict; a layout finding means change the spec (a layer,
  7. If the caller supplies multiple scoped specs, use scripts/validate_manifest.py; it checks
  8. Look at the exported image before reporting. Labels clear of boxes, no line crossing a

What it can do on your machine

Read from SKILL.md and the folder at commit b529c2d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Specialist Solution Diagrammer loads about 1k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 414 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~81
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HoangNguyen0403/agent-skills-standard at commit b529c2d, republished under its MIT licence (© HoangNguyen0403). 414 words, ~1,033 tokens.

Download SKILL.mdSave it as .claude/skills/specialist-solution-diagrammer/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
specialist-solution-diagrammer
description
Draws one evidence-grounded architecture diagram as an editable draw.io file plus a rendered image, from an evidence bundle supplied by the caller. Use to produce a system context, container, component, deployment, data flow, sequence, state, or ERD diagram; spawn one per diagram for a batch.
risk_tier
L2
metadata.internal
true

Specialist: Solution Diagrammer

Priority: P1 (HIGH)

Role

Produce exactly one diagram for one slug, per common-architecture-diagramming. The slug may be a context, container, component, deployment, dataflow, sequence, state, or ERD view. Do not gather your own evidence, redesign the architecture, or draw a second view because the first looked thin.

Budget

  • One diagram per invocation; at most 10 tool calls; no sub-agents; no Git.
  • Read only the evidence bundle the caller supplied plus the skill's own references.
  • Write only <out>/<slug>.spec.json, .drawio, and the exported image.
  • Return BLOCKED when the caller gave no evidence bundle, no diagram type, or when every node would be UNVERIFIED — never invent a box to make the picture look complete.

Steps

  1. Restate the audience, the diagram type, and the one question this diagram answers.
  2. Extract nodes and edges from the bundle per references/source-extraction.md, attaching a path:line to every node and edge you can prove and leaving evidence absent for the rest. Carry metric and constraint onto each node from the bundle's constraint -> component -> cost lines and edge metrics from stated latency budgets; never invent a number.
  3. For every selected view, assign canonical identity values, lifecycle (proposed|implemented|retired), evidence_kind (code|document|runtime|deployment) when cited, and evidence_confidence (unverified|assumed|documented|observed). Capture supplied source revision/digest and node/edge provenance. Label metrics target|estimated|measured; code/document citations never prove deployment.
  4. Write the spec per references/diagram-spec.md. For ERD, use the existing schema generator; do not hand-model tables when a schema file is supplied.
  5. Run scripts/validate_spec.py; fix the spec, never the validator.
  6. Run scripts/render_drawio.py --strict; a layout finding means change the spec (a layer, the node order, or a split), never the renderer. Then export: a draw.io MCP tool if the session has one, else scripts/export_drawio.py, else report the image as not exported.
  7. If the caller supplies multiple scoped specs, use scripts/validate_manifest.py; it checks identities, refinement/ownership links, relationship direction, and evidence captures without network resolution. Regeneration protects hand edits by default; acknowledge replacement only after returning semantic changes to the spec.
  8. Look at the exported image before reporting. Labels clear of boxes, no line crossing a third box, legend complete.
Show full SKILL.md (66 more words)Show less

Output

text
DIAGRAM: [.drawio path] + [image path | "image: not exported (no draw.io MCP or CLI)"]
TYPE: [context|container|component|deployment|dataflow|sequence|state|erd] · AUDIENCE: [exec|tech]
NODES: [n] (UNVERIFIED: [ids or "none"])
EDGES: [n]
METRICS: [n of m nodes carry a metric; edges with metric: k]
QUESTION: [the one question this diagram answers]
REVIEW: [one question for the named audience]
BLOCKED: [reason, if any]

Anti-Patterns

  • No invented boxes: Leave it out, or leave it UNVERIFIED.
  • No hand-written XML: Write the spec and run the renderer.
  • No mixed C4 levels: Draw a second diagram instead.
  • No silent overwrite: Use --protect-manual-edits before replacing a hand-tuned .drawio.
  • No semantic draw.io edits: Return lifecycle, provenance, identity, and relationship changes to the JSON spec.
  • No manifest claims of runtime drift: changed revisions/digests report review-needed.

© HoangNguyen0403, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/specialists/specialist-solution-diagrammer of HoangNguyen0403/agent-skills-standard.

  • SKILL.md
  • evals/evals.json

Open the folder on GitHubat commit b529c2d

Compare with similar skills

Specialist Solution Diagrammer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Specialist Solution Diagrammer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Specialist Solution Diagrammer this skillHoangNguyen0403/agent-skills-standard572—~1kAutomated safety check: PassMIT
Drawio Skillyuanchen-home/cumcm-step-review319—~11kAutomated safety check: PassMIT
Drawio Azuresparklabx/drawio-ai-kit655—~1.6kAutomated safety check: PassMIT
AWS DrawIO Diagram Generatora5c-ai/babysitter1.8k—~4.2kAutomated safety check: PassMIT
Drawio GCPsparklabx/drawio-ai-kit655—~1.6kAutomated safety check: PassMIT
Azv Azure To DiagramAzure/AZVerify101—~5.7kAutomated safety check: PassMIT

Similar skills

  • Drawio Skill

    yuanchen-home/cumcm-step-review

    A skill your agent uses when the user requests diagrams, flowcharts, architecture diagrams, ER diagrams, UML / sequence / class diagrams, SysML / MBSE diagrams (block definition, internal block…

    319 GitHub stars~11k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Drawio Azure

    sparklabx/drawio-ai-kit

    A skill your agent uses when the user asks for an Azure architecture diagram — VNet/networking, App Service, AKS, landing zone, multi-region, or any diagram built with Azure service icons.

    655 GitHub stars~1.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Creates and edits AWS architecture diagrams as DrawIO XML, converting a text description or an image and reading existing files back into shapes.

    1.8k GitHub stars~4.2k tokensUpdated 24 days ago
    DevelopmentAuto-check passed
  • Drawio GCP

    sparklabx/drawio-ai-kit

    A skill your agent uses when the user asks for a GCP or Google Cloud architecture diagram — VPC/networking, GKE, Cloud Run, landing zone, multi-region, or any diagram built with GCP service icons.

    655 GitHub stars~1.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Azv Azure To Diagram

    Azure/AZVerify

    Official

    Reverse-engineer a live Azure scope (resource group or filtered subscription) into a professional Draw.io architecture diagram following established AzVerify conventions.

    101 GitHub stars~5.7k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Azure Draw.io MCP Diagrams

    thomast1906/github-copilot-agent-skills

    Creates and edits architecture diagrams through the Draw.io MCP tool, with guidance for rendering Azure icons correctly and laying out network diagrams.

    202 GitHub stars~3.1k tokensUpdated 3 days ago
    DevelopmentAuto-check passed

More from HoangNguyen0403/agent-skills-standard

All 211 skills in this repo
  • Subagent-Driven Development

    HoangNguyen0403/agent-skills-standard

    Runs a multi-task implementation plan by sending each task to a fresh implementer subagent, reviewing it independently, then reviewing the whole branch.

    572 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • draw.io Architecture Diagramming

    HoangNguyen0403/agent-skills-standard

    Draws architecture diagrams as editable draw.io files from a JSON spec, with a fixed house style, one C4 level per diagram and evidence-tagged shapes.

    572 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Android Navigation 3 Guide

    HoangNguyen0403/agent-skills-standard

    Implements and migrates to Jetpack Navigation 3 in Compose: NavDisplay, typed route objects, a state-list back stack, deep links, multiple back stacks and dialog scenes.

    572 GitHub stars~687 tokensUpdated yesterday
    Auto-check passed
  • Angular HttpClient Standards

    HoangNguyen0403/agent-skills-standard

    Sets rules for Angular HTTP code: functional interceptors, typed requests, services that own every call, and httpResource for reactive data loading in Angular 17+.

    572 GitHub stars~652 tokensUpdated yesterday
    Auto-check passed
  • Angular Tooling

    HoangNguyen0403/agent-skills-standard

    Angular CLI usage, code generation, build configuration, and bundle optimization.

    572 GitHub stars~743 tokensUpdated yesterday
    Auto-check passed
  • Common Code Review

    HoangNguyen0403/agent-skills-standard

    Conduct high-quality, persona-driven code reviews. An agent skill from HoangNguyen0403/agent-skills-standard.

    572 GitHub stars~772 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Specialist Solution Diagrammer

What does Specialist Solution Diagrammer do?

Draws one evidence-grounded architecture diagram as an editable draw.io file plus a rendered image, from an evidence bundle supplied by the caller. Specialist Solution Diagrammer is an agent skill from HoangNguyen0403/agent-skills-standard.io file plus a rendered image, from an evidence bundle supplied by the caller.

When should I use Specialist Solution Diagrammer?

Specialist Solution Diagrammer fits situations like: produce a system context; spawn one per diagram for a batch.

How do I install Specialist Solution Diagrammer in Claude Code?

Run `npx skills add HoangNguyen0403/agent-skills-standard --skill specialist-solution-diagrammer -a claude-code`. Or copy the skill folder (skills/specialists/specialist-solution-diagrammer in HoangNguyen0403/agent-skills-standard) into .claude/skills/specialist-solution-diagrammer in your project. Claude Code loads it when a task matches its description.

How do I install Specialist Solution Diagrammer in Codex?

Run `npx skills add HoangNguyen0403/agent-skills-standard --skill specialist-solution-diagrammer -a codex`. Or copy the skill folder (skills/specialists/specialist-solution-diagrammer in HoangNguyen0403/agent-skills-standard) into .agents/skills/specialist-solution-diagrammer in your project. Codex loads it when a task matches its description.

Can I use Specialist Solution Diagrammer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HoangNguyen0403/agent-skills-standard --skill specialist-solution-diagrammer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/specialist-solution-diagrammer, .gemini/skills/specialist-solution-diagrammer, .github/skills/specialist-solution-diagrammer and .opencode/skills/specialist-solution-diagrammer in your project.

What does Specialist Solution Diagrammer need to run?

SKILL.md names no scripts, command-line tools or credentials: Specialist Solution Diagrammer is instructions for the agent only.

Does Specialist Solution Diagrammer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Specialist Solution Diagrammer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Specialist Solution Diagrammer use?

Specialist Solution Diagrammer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Specialist Solution Diagrammer use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Specialist Solution Diagrammer?

Skills that share tags, products or a category with Specialist Solution Diagrammer: Drawio Skill (yuanchen-home/cumcm-step-review, 319 stars), Drawio Azure (sparklabx/drawio-ai-kit, 655 stars), AWS DrawIO Diagram Generator (a5c-ai/babysitter, 1.8k stars) and Drawio GCP (sparklabx/drawio-ai-kit, 655 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Specialist Solution Diagrammer?

HoangNguyen0403 (a GitHub user) maintains it in HoangNguyen0403/agent-skills-standard, which has 572 GitHub stars. The repository holds 211 skills in this directory. The repository was last updated on October 9, 2026.

Source: HoangNguyen0403/agent-skills-standard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.