Skip to content
mcp/skillhub

Agent Skill

Mermaid Diagrams skill

mermaid-diagramssoftaworks/agent-toolkitskills/mermaid-diagrams/SKILL.md

Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams including class diagrams (domain modeling, object-oriented design), sequence diagrams (application flows, API interactions, code execution), flowcharts (processes, algorithms, user journeys), entity relationship diagrams (database schemas), C4 architecture diagrams (system context, containers, components), state diagrams, git graphs, pie charts, gantt charts, or any other diagram type. Triggers include requests to "diagram", "visualize", "model", "map out", "show the flow", or when explaining system architecture, database design, code structure, or user/application flows.

2.6kMIT

always on

142 tokname + description

once used

1,543 tokSKILL.md body

bundled files

876 KB

repo stars

2.6kGitHub

Install the Mermaid Diagrams skill

Skills CLI (Claude Code, Codex, Cursor and others)

npx skills add https://github.com/softaworks/agent-toolkit --skill mermaid-diagrams

Claude Code, by hand (all projects)

git clone --depth 1 https://github.com/softaworks/agent-toolkit.git /tmp/agent-toolkit
mkdir -p ~/.claude/skills
cp -R /tmp/agent-toolkit/skills/mermaid-diagrams ~/.claude/skills/mermaid-diagrams

For one project only, copy the folder into .claude/skills/ in that project instead. The agent picks it up when a task matches its description.

What it costs your context

Agent Skills load in three steps. Tokens counted with the o200k tokenizer; your model's count will differ a little.

WhenWhat loadsCost
Every sessionName and description142 tok
When the agent uses itThe SKILL.md instructions1,543 tok
Only if opened8 bundled files (76 KB)varies

Until it is used, mermaid-diagrams costs about 9.6× less than the median MCP server we measured (1,363 tokens on every turn). Installing all 43 skills from softaworks/agent-toolkit would load 2,462 tokens of descriptions. Skills vs MCP study

Checks

Our checks found nothing to flag: it follows the Agent Skills specification's naming and size guidelines and doesn't pipe downloads into a shell.

Checked 2026-10-22 · method

What's inside

The headings of its SKILL.md. Read the full file on GitHub.

  • Mermaid Diagramming
  • Core Syntax Structure
  • Diagram Type Selection Guide
  • Quick Start Examples
  • Class Diagram (Domain Model)
  • Sequence Diagram (API Flow)
  • Flowchart (User Journey)
  • ERD (Database Schema)
  • Detailed References
  • Best Practices
  • Configuration and Theming
  • Exporting and Rendering
  • Common Pitfalls
  • When to Create Diagrams

More skills from softaworks/agent-toolkit

All skills in this repo
  1. agent-md-refactorsoftaworks/agent-toolkit

    Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.

    2.6k40 tok idle · 1,732 in use
  2. backend-to-frontend-handoff-docssoftaworks/agent-toolkit

    Create API handoff documentation for frontend developers. Use when backend work is complete and needs to be documented for frontend integration, or user says 'create handoff', 'document API', 'frontend handoff', or 'API documentation'.

    2.6k55 tok idle · 1,139 in use
  3. c4-architecturesoftaworks/agent-toolkit

    Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize software structure, create C4 diagrams, or generate context/container/component/deployment diagrams. Triggers include "architecture diagram", "C4 diagram", "system context", "container diagram", "component diagram", "deployment diagram", "document architecture", "visualize architecture".

    2.6k82 tok idle · 2,505 in use
  4. codexsoftaworks/agent-toolkit

    Use when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing. Uses GPT-5.2 by default for state-of-the-art software engineering.

    2.6k55 tok idle · 1,275 in use
  5. command-creatorsoftaworks/agent-toolkit

    This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable command. Essential for creating optimized, agent-executable slash commands with proper structure and best practices.

    2.6k66 tok idle · 1,492 in use
  6. commit-worksoftaworks/agent-toolkit

    Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits). Use when the user asks to commit, craft a commit message, stage changes, or split work into multiple commits.

    2.6k54 tok idle · 522 in use
  7. crafting-effective-readmessoftaworks/agent-toolkit

    Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.

    2.6k35 tok idle · 589 in use
  8. daily-meeting-updatesoftaworks/agent-toolkit

    Interactive daily standup/meeting update generator. Use when user says 'daily', 'standup', 'scrum update', 'status update', 'what did I do yesterday', 'prepare for meeting', 'morning update', or 'team sync'. Pulls activity from GitHub, Jira, and Claude Code session history. Conducts 4-question interview (yesterday, today, blockers, discussion topics) and generates formatted Markdown update.

    2.6k194 tok idle · 2,779 in use