Markdown Mermaid Writing

This codifies a strong opinion: structure and relationships should live as Mermaid diagrams in markdown files, not as images or Python plots. You get 24 diagram types, from flowcharts and sequence diagrams to Sankey and packet diagrams, plus templates for common docs like ADRs and research papers. The bet is that text-based diagrams diff cleanly in git, render natively on GitHub and Notion, use fewer tokens than prose, and stay editable without regeneration. Phase 1 is always Mermaid. Phase 2 (Python charts) and Phase 3 (polished visuals) are optional downstream steps. If you're writing scientific documentation or architectural diagrams and want a version-control-first workflow, this gives you the references and templates to make Mermaid your default.

skills.sh installs: 2.2K
GitHub stars: 56.6K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add k-dense-ai/scientific-agent-skills --skill markdown-mermaid-writing --agent claude-code

Installs into .claude/skills of the current project.

Files

Markdown and Mermaid Writing

Overview

This skill provides an optional house style for Markdown documentation with Mermaid structural diagrams. Follow the requested output format, existing repository conventions, and journal requirements first. This skill does not replace scientific analysis or plotting.

A relationship expressed as Mermaid inside a .md file is editable text that diffs cleanly in git. A compatible host renders it without a separate user build step. It renders where the host has Mermaid support; plain Markdown viewers may show only code, and platforms/extensions ship different Mermaid versions. It uses a compact source representation, though token use depends on the diagram. Exporting SVG/PNG requires a renderer; retain the diagram source alongside exported figures.

SKILL.md on GitHub

Details

Repository: github.com/k-dense-ai/scientific-agent-skills
Categories: Documentation, Code Review & Quality, AI & Agent Building, Data Science & ML
First seen: Jun 3, 2026