New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Diagram

by HybridAIOne in HybridAIOne/hybridclaw

Create, validate, update, and render diagram-as-code artifacts with Mermaid-first schema awareness plus PlantUML, Graphviz DOT, and Excalidraw JSON adapters.

MITAuto-check passedDevelopment

Install Diagram

skills CLI
$ npx skills add HybridAIOne/hybridclaw --skill diagram -a claude-code

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

GitHub CLI
$ gh skill install HybridAIOne/hybridclaw diagram --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/HybridAIOne/hybridclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/diagram .claude/skills/diagram && 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
diagram
GitHub stars
159
Token cost
~1.7k tokens
SKILL.md length
825 words
Files
3 (incl. references)
Skills in repo
72
Repo updated
First seen
Licence
MIT

At a glance

Create, validate, update, and render diagram-as-code artifacts with Mermaid-first schema awareness plus PlantUML, Graphviz DOT, and Excalidraw JSON adapters.

  • Works in 7 steps: Pick the diagram type before writing… → For Mermaid, read… → Draft complete source yourself when the… → …
  • Tasks that involve Diagrams
  • SKILL.md covers Tool Surface, Default Workflow, Type Selection and Mermaid Rules, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Diagram is an agent skill from HybridAIOne/hybridclaw. Create, validate, update, and render diagram-as-code artifacts with Mermaid-first schema awareness plus PlantUML, Graphviz DOT, and Excalidraw JSON adapters.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/mermaid-types.md`).

It sits in Development, covering Diagrams. It works with Mermaid and Excalidraw. The repository describes itself as: Enterprise-ready self-hosted AI assistant runtime with sandboxed execution, secure credentials, approvals, and memory. The licence is MIT.

When your agent uses it

  • Tasks that involve Diagrams

Example prompts

  • “/diagram”

Workflow steps

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

  1. Pick the diagram type before writing syntax. If uncertain, set type to auto, but prefer an explicit type when the user request clearly…
  2. For Mermaid, read references/mermaid-types.md when you need grammar examples or when the diagram type is not obvious.
  3. Draft complete source yourself when the user needs a specific diagram. Do not rely on the tool's generated starter unless the request is…
  4. Call diagram_validate before rendering when you wrote or revised source manually.
  5. If validation fails, use the returned errors and suggested_fix, revise once, then validate again. Make at most 2 fix-up attempts before…
  6. Call diagram_create or diagram_update with render_to set to svg by default. Use png or pdf only when requested and the adapter can render…
  7. Return the source artifact and rendered artifact paths to the user.

What it can do on your machine

Read from SKILL.md and the folder at commit 8162701. 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 (its code samples are json).

    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

Diagram loads about 1.7k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 41 tokens; SKILL.md has 825 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.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 HybridAIOne/hybridclaw at commit 8162701, republished under its MIT licence (© HybridAIOne). 825 words, ~1,730 tokens.

Download SKILL.mdSave it as .claude/skills/diagram/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
diagram
description
Create, validate, update, and render diagram-as-code artifacts with Mermaid-first schema awareness plus PlantUML, Graphviz DOT, and Excalidraw JSON adapters.
user-invocable
true
disable-model-invocation
false

Diagram

Use this skill when the user wants a rendered static diagram, a validated diagram source artifact, or a revision to an existing diagram source.

Default to Mermaid unless the user asks for another format or the shape is a better fit for another adapter:

  • Mermaid: sequence, flowchart, state, ER, class, gantt, git-graph, mindmap, and pie diagrams.
  • PlantUML: UML sequence/component/activity/deployment diagrams when the user already uses PlantUML or asks for it.
  • Graphviz DOT: topology, dependency graphs, and layouts where rank/direction control matters.
  • Excalidraw JSON: hand-drawn-style editable sketches when the user asks for an editable canvas.

Tool Surface

Use the runtime tools directly:

  • diagram_create: create source, validate it, save source, and optionally render.
  • diagram_update: update existing source or source artifact, validate it, save a new source artifact, and optionally render.
  • diagram_validate: validate source only; do not render.

The tool output includes these fields:

json
{
  "success": true,
  "valid": true,
  "source": "...",
  "source_artifact_ref": "/workspace/.generated-diagrams/skills/diagram/diagram-...",
  "rendered_artifact_ref": "/workspace/.generated-diagrams/skills/diagram/diagram-...",
  "type": "flowchart",
  "format": "mermaid",
  "artifacts": [],
  "runtime_events": [],
  "warnings": []
}

On validation failure, success and valid are false and errors plus suggested_fix may be present. When render_to is "none", rendered_artifact_ref is null. Invalid source is still saved with source_artifact_valid: false so the operator can inspect or repair it.

Default Workflow

  1. Pick the diagram type before writing syntax. If uncertain, set type to auto, but prefer an explicit type when the user request clearly names one.
  2. For Mermaid, read references/mermaid-types.md when you need grammar examples or when the diagram type is not obvious.
  3. Draft complete source yourself when the user needs a specific diagram. Do not rely on the tool's generated starter unless the request is generic.
  4. Call diagram_validate before rendering when you wrote or revised source manually.
  5. If validation fails, use the returned errors and suggested_fix, revise once, then validate again. Make at most 2 fix-up attempts before surfacing the failure with the invalid source artifact. The runtime also caps automatic pre-render fix-up at 2 attempts.
  6. Call diagram_create or diagram_update with render_to set to svg by default. Use png or pdf only when requested and the adapter can render that target.
  7. Return the source artifact and rendered artifact paths to the user.

Type Selection

Use these defaults:

User intentType
messages, API call flow, actors, request/responsesequence
process, decision tree, pipeline, system flowflowchart
lifecycle, status machine, transitionsstate
database schema, entities, relationshipser
classes, interfaces, inheritance, methodsclass
timeline, schedule, milestones, roadmapgantt
branches, commits, merges, release traingit-graph
brainstorm, taxonomy, concept map, outlinemindmap
shares, proportions, percentagespie

Mermaid Rules

  • Use the canonical header for the selected type.
  • Keep labels short and ASCII-safe unless the user provided exact labels.
  • Quote labels when Mermaid grammar requires it, especially pie chart slices.
  • Avoid unsupported Markdown inside labels.
  • Prefer flowchart TD or flowchart LR; do not mix both in one source.
  • In sequenceDiagram, define participants when names are long or reused.
  • In gantt, include dateFormat and stable task ids when using dependencies.
  • In erDiagram, include cardinality on relationships.
Show full SKILL.md (349 more words)Show less

Update Rules

For diagram_update, preserve the existing type and format unless the user explicitly asks to convert. When the user gives natural-language update instructions:

  1. Read the existing source artifact when needed.
  2. Apply the change to the source yourself.
  3. Validate the full updated source.
  4. Call diagram_update with the complete updated source, original format/type, and desired render_to.

If the user only asks to annotate a diagram and exact placement does not matter, the tool can add a small update annotation when passed only artifact_ref plus instructions.

Adapter Notes

  • Mermaid and Graphviz use local renderers when available. If a renderer is not installed, SVG requests fall back to source-backed SVG artifacts so the operator still gets an embed-ready file.
  • Mermaid validation checks the diagram header and, for flowchart, state, and class diagrams, bracket and quote balance. Full syntax checking happens only when mmdc renders the source, so re-read the diagram-type grammar before drafting when mmdc is not installed.
  • PlantUML rendering uses HYBRIDCLAW_PLANTUML_SERVER_URL or PLANTUML_SERVER_URL when configured. Without a server, SVG requests fall back to source-backed SVG artifacts. Operators are responsible for pointing this setting only at a trusted PlantUML server with appropriate network egress controls.
  • Excalidraw defaults to render_to: "none" because JSON is the editable deliverable. Use render_to: "svg" when a static preview is requested; the runtime renders the JSON elements directly to SVG.
  • Local Mermaid and Graphviz renders use short-lived OS temp directories. Normal tool completion removes them; process-level termination such as SIGKILL may leave temporary source copies for the OS temp cleaner. Diagram render usage is reported as a zero-cost budget hook; LLM tokens are only consumed when the model drafts or repairs source.

Runtime Hooks

Rendered diagrams include a diagram.rendered event in runtime_events. Validation failures include a diagram.validation_failed event with the validation errors and source artifact path when one was persisted. Diagram artifacts are stored under the skill-scoped path .generated-diagrams/skills/diagram/.

Stakes

Diagram rendering is F8 low stakes: the output is a file artifact the operator chooses to share. Do not treat generated diagrams as authoritative for security, legal, medical, or financial decisions without separate verification.

© HybridAIOne, 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 2 other files (references) in skills/diagram of HybridAIOne/hybridclaw.

  • SKILL.md
  • agents/openai.yaml
  • references/mermaid-types.md

Open the folder on GitHubat commit 8162701

Compare with similar skills

Diagram 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.

Diagram compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Diagram this skillHybridAIOne/hybridclaw159—~1.7kAutomated safety check: PassMIT
Diagram Designcathrynlavery/diagram-design49k1 repos~7.6kAutomated safety check: PassMIT
Excalidraw Skillyctimlin/mcp_excalidraw2.5k—~4.6kAutomated safety check: PassMIT
Sketch Labwebdevcody/sketchlab.app182—~1.4kAutomated safety check: PassNone
Diagram Makergarrytan/gstack136k—~4.1kAutomated safety check: NotesMIT
Excalidraw Canvas Toolkitlingzhi227/agent-research-skills390—~3.8kAutomated safety check: PassNone

Similar skills

  • Diagram Design

    cathrynlavery/diagram-design

    Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.

    49k GitHub starsUsed in 1 repo~7.6k tokens
    DevelopmentAuto-check passed

  • Excalidraw Skill

    yctimlin/mcp_excalidraw

    Excalidraw canvas toolkit for creating, editing, and refining diagrams on a live canvas.

    2.5k GitHub stars~4.6k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Sketch Lab

    webdevcody/sketchlab.app

    Generate Sketch Lab architecture diagrams and open them via a share URL.

    182 GitHub stars~1.4k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed

  • Diagram Maker

    garrytan/gstack

    Turns an English description or Mermaid source into a diagram set: the source, an editable .excalidraw file and rendered SVG and PNG images.

    136k GitHub stars~4.1k tokensUpdated today
    DevelopmentAuto-check: notes

  • Excalidraw Canvas Toolkit

    lingzhi227/agent-research-skills

    Draws and refines Excalidraw diagrams on a live canvas through MCP tools or a REST API, with screenshots, file import and export, snapshots and Mermaid conversion.

    390 GitHub stars~3.8k tokensUpdated 7 mo ago
    DevelopmentAuto-check passed

  • Excalidraw Diagram Design

    BV-Venky/excalidraw-architect-mcp

    Guide for structuring graph input (nodes and edges) for the Excalidraw Architect MCP tool to produce clean, readable diagrams.

    158 GitHub stars~1.6k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

More from HybridAIOne/hybridclaw

All 72 skills in this repo

  • Hermes3000 Writing

    HybridAIOne/hybridclaw

    Use Hermes3000 to plan, draft, revise, save, check consistency, and export long-form manuscripts through the Hermes3000 AI writing portal API.

    159 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

  • Manim Video

    HybridAIOne/hybridclaw

    Plan, script, render, and stitch Manim Community Edition videos in Python.

    159 GitHub stars~4.7k tokensUpdated today
    Auto-check: notes

  • Skill Creator

    HybridAIOne/hybridclaw

    Create and update SKILL.md-based skills with strong trigger metadata, lean docs, and reliable init, validate, package, and publish workflows.

    159 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • XLSX

    HybridAIOne/hybridclaw

    Create, edit, inspect, and analyze .xlsx spreadsheets and Excel workbooks.

    159 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

  • Excalidraw

    HybridAIOne/hybridclaw

    Create and revise editable .excalidraw diagrams as Excalidraw JSON for architecture diagrams, flowcharts, sequence diagrams, concept maps, and other hand-drawn explainers.

    159 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

  • Google Ads

    HybridAIOne/hybridclaw

    Manage Google Ads accounts with safe GAQL reporting, campaign planning, guarded mutations, and gateway-proxied REST API calls.

    159 GitHub stars~4k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Diagram

What does Diagram do?

Create, validate, update, and render diagram-as-code artifacts with Mermaid-first schema awareness plus PlantUML, Graphviz DOT, and Excalidraw JSON adapters. Diagram is an agent skill from HybridAIOne/hybridclaw. Create, validate, update, and render diagram-as-code artifacts with Mermaid-first schema awareness plus PlantUML, Graphviz DOT, and Excalidraw JSON adapters.

When should I use Diagram?

Diagram fits situations like: tasks that involve Diagrams.

How do I install Diagram in Claude Code?

Run `npx skills add HybridAIOne/hybridclaw --skill diagram -a claude-code`. Or copy the skill folder (skills/diagram in HybridAIOne/hybridclaw) into .claude/skills/diagram in your project. Claude Code loads it when a task matches its description.

How do I install Diagram in Codex?

Run `npx skills add HybridAIOne/hybridclaw --skill diagram -a codex`. Or copy the skill folder (skills/diagram in HybridAIOne/hybridclaw) into .agents/skills/diagram in your project. Codex loads it when a task matches its description.

Can I use Diagram 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 HybridAIOne/hybridclaw --skill diagram -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/diagram, .gemini/skills/diagram, .github/skills/diagram and .opencode/skills/diagram in your project.

What does Diagram need to run?

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

Does Diagram 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 Diagram 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 Diagram use?

Diagram 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 Diagram use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 364 tokens, read only when the agent opens those files.

What are the alternatives to Diagram?

Skills that share tags, products or a category with Diagram: Diagram Design (cathrynlavery/diagram-design, 49k stars), Excalidraw Skill (yctimlin/mcp_excalidraw, 2.5k stars), Sketch Lab (webdevcody/sketchlab.app, 182 stars) and Diagram Maker (garrytan/gstack, 136k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Diagram?

HybridAIOne (a GitHub organization) maintains it in HybridAIOne/hybridclaw, which has 159 GitHub stars. The repository holds 72 skills in this directory. The repository was last updated on October 9, 2026.

Source: HybridAIOne/hybridclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.