Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

Markdown & Mermaid Writing

Makes Markdown with embedded Mermaid diagrams the default, git-friendly standard for every report, doc, and diagram.

Docs & OfficeBeginner★ 33,030⑂ 3,248AI score 8/10Last updated: Aug 9, 2026

What it does

This skill enforces Markdown + Mermaid as the canonical documentation format for anything Claude writes.

  • Text-based diagrams instead of images: clean git diffs, no build step, renders natively on GitHub, GitLab, Notion, and VS Code.
  • Reference guides for 24 Mermaid diagram types (flowchart, sequence, ER, state, gantt, mindmap, radar, sankey, C4, and more) so the right type is chosen instead of defaulting to flowcharts.
  • 9 document templates: pull request, issue, kanban, decision record (ADR), presentation, research paper, project docs, how-to guide, status report.
  • Style enforcement: one H1, emoji only on H2, footnote citations [^N], tables over prose, mandatory accTitle/accDescr accessibility annotations.
  • Dark-mode safety rules: no %%{init} directives, no inline styles — classDef only.

Who it's for

  • Researchers and grad students producing reports, analyses, and manuscripts
  • Developers maintaining READMEs, architecture docs, and ADRs in git
  • Anyone tired of regenerating diagram images for every small edit
  • Technical writers standardizing team documentation style

Examples

  1. "Document our experimental pipeline" → a research-paper-templated .md with an inline flowchart and sequence diagram.
  2. "Record today's architecture decision" → an ADR from the decision_record template with a C4 or block diagram.
  3. "Summarize the papers I reviewed" → a mindmap concept map plus a timeline of publication years.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the skills/markdown-mermaid-writing folder from the GitHub repo K-Dense-AI/scientific-agent-skills into my ~/.claude/skills/markdown-mermaid-writing/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sas && mkdir -p ~/.claude/skills && cp -r /tmp/sas/skills/markdown-mermaid-writing ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal.
  2. Clone the repository into a temp folder: git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sas
  3. Create the skills folder if needed: mkdir -p ~/.claude/skills
  4. Copy the whole skill directory (the references/, templates/, and assets/ subfolders must come along): cp -r /tmp/sas/skills/markdown-mermaid-writing ~/.claude/skills/
  5. Verify: ls ~/.claude/skills/markdown-mermaid-writing
  6. Restart Claude Code, then try: "Write this up as Markdown with Mermaid diagrams."
  7. (Optional) Remove the temp clone at /tmp/sas.
View source on GitHub ↗License: MIT