Skip to content

feat(skill): add Mermaid diagram skill to diagramming category#3791

Open
memosr wants to merge 1 commit intoNousResearch:mainfrom
memosr:feat/mermaid-diagram-skill
Open

feat(skill): add Mermaid diagram skill to diagramming category#3791
memosr wants to merge 1 commit intoNousResearch:mainfrom
memosr:feat/mermaid-diagram-skill

Conversation

@memosr
Copy link
Copy Markdown
Contributor

@memosr memosr commented Mar 29, 2026

What does this PR do?

Adds a Mermaid diagram skill to the skills/diagramming/ category,
which currently contains only a DESCRIPTION.md and no actual skills.

Mermaid is the most widely supported developer diagram tool — it renders
natively in GitHub READMEs, GitLab, Notion, VS Code, and Obsidian with
no external tools or API keys. It is also referenced in the Hermes
documentation (cron examples use blogwatcher alongside diagram workflows)
but had no skill to guide the agent.

The skill covers: flowcharts, sequence diagrams, ERDs, class diagrams,
Gantt charts, state diagrams, and mindmaps. Includes pitfalls, a quick
reference table, local CLI rendering instructions, and browser preview
options.

Type of Change

  • 🎯 New skill (bundled)

Changes Made

  • skills/diagramming/mermaid/SKILL.md — new skill file

How to Test

Checklist

  • Read the Contributing Guide
  • Broadly useful to most users — Mermaid is standard in GitHub workflows
  • SKILL.md follows the standard format
  • No external dependencies required (optional mmdc CLI detected at runtime)
  • Tested end-to-end
  • No config key changes

This file introduces the Mermaid skill for creating various types of diagrams using plain text syntax. It includes instructions for flowcharts, sequence diagrams, ERDs, Gantt charts, and class diagrams, along with usage examples and rendering options.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant