Individual skill
markdown-mermaid-writing
Comprehensive markdown and Mermaid diagram writing skill. Use when creating any scientific document, report, analysis, or visualization. Establishes text-based diagrams as the default documentation standard with full style guides (markdown + mermaid), 24 diagram type references, and 9 document templates.
backend/cli/skills/writing/markdown-mermaid-writing/SKILL.md
Source commit a08e0ad0ad3d6448123039ee4659163eb2e35d99
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 2, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 4,352
- Repository last updated
- Nov 6, 2026
- License
- Apache-2.0
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agent Repository topic
- ai Repository topic
- bun Repository topic
- cli Repository topic
- llm Repository topic
- ml Repository topic
- open-source Repository topic
- research Repository topic
- science Repository topic
- ai-agent Repository topic
- writing Derived category
- data Derived category
- docs Derived category
- research Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 15,113 bytesSKILL.mdcore · 15,113 bytesSKILL.mdcore · 15,113 bytesSKILL.mdcore · 15,113 bytesSKILL.mdcore · 15,113 bytesSKILL.mdcore · 15,113 bytesSKILL.mdcore · 15,113 bytesassets/examples/example-research-report.mddoc · 9,010 bytesreferences/diagrams/architecture.mddoc · 4,369 bytesreferences/diagrams/block.mddoc · 4,825 bytesreferences/diagrams/c4.mddoc · 6,201 bytesreferences/diagrams/class.mddoc · 8,521 bytesreferences/diagrams/complex_examples.mddoc · 17,079 bytesreferences/diagrams/er.mddoc · 7,601 bytesreferences/diagrams/flowchart.mddoc · 6,961 bytesreferences/diagrams/gantt.mddoc · 5,851 bytesreferences/diagrams/git_graph.mddoc · 2,009 bytesreferences/diagrams/kanban.mddoc · 3,544 bytesreferences/diagrams/mindmap.mddoc · 2,232 bytesreferences/diagrams/packet.mddoc · 1,721 bytesreferences/diagrams/pie.mddoc · 1,560 bytesreferences/diagrams/quadrant.mddoc · 2,163 bytesreferences/diagrams/radar.mddoc · 2,176 bytesreferences/diagrams/requirement.mddoc · 2,463 bytesreferences/diagrams/sankey.mddoc · 2,143 bytesreferences/diagrams/sequence.mddoc · 5,510 bytesreferences/diagrams/state.mddoc · 5,464 bytesreferences/diagrams/timeline.mddoc · 4,181 bytesreferences/diagrams/treemap.mddoc · 2,039 bytesreferences/diagrams/user_journey.mddoc · 5,049 bytesreferences/diagrams/xy_chart.mddoc · 1,887 bytesreferences/diagrams/zenuml.mddoc · 2,285 bytesreferences/markdown_style_guide.mddoc · 34,866 bytesreferences/mermaid_style_guide.mddoc · 26,241 bytestemplates/decision_record.mddoc · 7,169 bytestemplates/how_to_guide.mddoc · 7,091 bytestemplates/issue.mddoc · 12,835 bytestemplates/kanban.mddoc · 11,403 bytestemplates/presentation.mddoc · 8,068 bytestemplates/project_documentation.mddoc · 11,489 bytestemplates/pull_request.mddoc · 12,903 bytestemplates/research_paper.mddoc · 10,157 bytestemplates/status_report.mddoc · 7,185 bytes
Read excerpt
# Markdown and Mermaid Writing
## Overview
This skill teaches you — and enforces a standard for — creating scientific documentation
using **markdown with embedded Mermaid diagrams as the default and canonical format**.
The core bet: a relationship expressed as a Mermaid diagram inside a `.md` file is more
valuable than any image. It is text, so it diffs cleanly in git. It requires no build step.
It renders natively on GitHub, GitLab, Notion, VS Code, and any markdown viewer. It uses
fewer tokens than a prose description of the same relationship. And it can always be
converted to a polished image later — but the text version remains the source of truth.
> "The more you get your reports and files in .md in just regular text, which mermaid is