Alterlab Mermaid
Writes Markdown documents and text-based Mermaid diagrams (flowcharts, sequence, class, ER, gantt, state, and more) with full style guides, 24 diagram-type references, and 9 document templates. Use when a diagram or technical document should live as version-controllable Markdown/Mermaid text rather than a rendered image — READMEs, methods and pipeline diagrams, analysis or status reports, ADRs, and project docs that render natively on GitHub and GitLab. For AI-rendered publication schematics use alterlab-scientific-schematics; for manuscript prose use alterlab-scientific-writing; for plots of
Install
/plugin marketplace add AlterLab-IEU/AlterLab-Academic-SkillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add AlterLab-IEU/AlterLab-Academic-Skills --skill alterlab-mermaidgit clone --depth 1 https://github.com/AlterLab-IEU/AlterLab-Academic-Skills.git /tmp/AlterLab-Academic-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/AlterLab-Academic-Skills/skills/visualization/alterlab-mermaid ~/.claude/skills/alterlab-mermaidPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 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 > as well as being a simple 'script language'. This just helps with any downstream rendering > and especially AI generated images (using mermaid instead of just long form text to > describe relationships < tokens). Additionally mermaid can render along with markdown for > easy use almost anywhere by humans or AI." > > — Clayton Young (@borealBytes), 2026-02-19 ## When to Use This Skill Use this skill when: - Writing **Markdown documentation** — READMEs, how-tos, decision records, project docs, status reports, analysis write-ups - Producing **a structural or relational diagram** — workflows, data pipelines, architectures, timelines, schemas
Details
- Skill name
alterlab-mermaid- Repository
- AlterLab-IEU/AlterLab-Academic-Skills
- Path
skills/visualization/alterlab-mermaid/SKILL.md- License
- MIT
- Repo updated
- 11 November 2026
- Listed in
- BehiSecc/awesome-claude-skills
FAQ
What does the Alterlab Mermaid skill do?
Writes Markdown documents and text-based Mermaid diagrams (flowcharts, sequence, class, ER, gantt, state, and more) with full style guides, 24 diagram-type references, and 9 document templates. Use when a diagram or technical document should live as version-controllable Markdown/Mermaid text rather than a rendered image — READMEs, methods and pipeline diagrams, analysis or status reports, ADRs, and project docs that render natively on GitHub and GitLab. For AI-rendered publication schematics use alterlab-scientific-schematics; for manuscript prose use alterlab-scientific-writing; for plots of
How do I install the Alterlab Mermaid skill?
Claude Code plugin: /plugin marketplace add AlterLab-IEU/AlterLab-Academic-Skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Alterlab Mermaid popular?
It lives in AlterLab-IEU/AlterLab-Academic-Skills, which has 87 GitHub stars and 18 forks, and is included in 1 curated skill list.
Related skills
Alterlab Abm Mesa
87AlterLab-IEU/AlterLab-Academic-Skills
Builds agent-based models of social systems with Mesa 3 — the current AgentSet API (model.agents.shuffle_do('step'), auto-assigned unique_id, mandatory super().__init__(rng=...)), cell spaces (mesa.discrete_space OrthogonalMooreGrid / classic mesa.space grids), the DataCollector, batch_run parameter sweeps, and SolaraViz — for emergence, segregation, diffusion, opinion dynamics, and cooperation models. It uses the Mesa 3.x API (the old mesa.time schedulers like RandomActivation are removed) and treats the model as a generative theory to be validated, not just run. Use when the request mentions
Alterlab Academic Career
87AlterLab-IEU/AlterLab-Academic-Skills
Prepares academic career documents and professional-development materials for faculty and researchers. Use when drafting academic CVs, research statements, teaching philosophies, diversity statements, faculty-position cover letters, tenure dossiers, promotion narratives, academic portfolios, or mentorship statements, and when planning conference-networking strategy, building academic web presence, setting up ORCID profiles, or understanding impact metrics. Part of the AlterLab Academic Skills suite.
Alterlab Accreditation Aol
87AlterLab-IEU/AlterLab-Academic-Skills
Scaffolds program-level Assurance-of-Learning (AoL) documentation for AACSB (Standard 5 in the 2020 standards and the 2026 Global Standards) and ABET (Criterion 3 Student Outcomes, Criterion 4 Continuous Improvement) accreditation — program learning outcomes / competency goals, curriculum-to-outcome mapping matrices, direct- and indirect-assessment plans, rubric design, and closing-the-loop continuous-improvement narratives — and validates the structure of an outcome-mapping matrix with scripts/aol_matrix.py. Use when the user needs AACSB or ABET assurance-of-learning material, a program-learn
Alterlab Networkx
87AlterLab-IEU/AlterLab-Academic-Skills
Creates, analyzes, and visualizes complex networks and graphs in Python with NetworkX. Use when working with network/graph data structures, analyzing relationships between entities, computing graph algorithms (shortest paths, centrality, clustering), detecting communities, generating synthetic networks, or visualizing topologies — applicable to social, biological, transportation, citation, and any pairwise-relationship networks. This is classical graph analytics, not deep learning — for training graph neural networks (GCN/message passing, node/edge/graph classification on Cora-style data) use
Alterlab Matplotlib
87AlterLab-IEU/AlterLab-Academic-Skills
Builds plots with the matplotlib Python library (pyplot and the object-oriented Figure/Axes API) for full low-level customization, exporting to PNG/PDF/SVG. Use when fine-grained control over individual plot elements is needed — custom line/scatter/bar/histogram/heatmap/contour/box/violin/3D plots, rcParams and style-sheet tuning, or GridSpec subplot layouts inside a scientific Python workflow. Does NOT cover opinionated journal-ready multi-panel figure workflows (Nature/Science/Cell formatting, colorblind-safe palettes, significance annotations); for those prefer alterlab-scientific-viz inste
Alterlab Open Notebook
87AlterLab-IEU/AlterLab-Academic-Skills
Runs and scripts Open Notebook, a self-hosted open-source alternative to Google NotebookLM with a full REST API, for AI-powered research and document analysis. Use when organizing research materials into notebooks, ingesting diverse content sources (PDFs, videos, audio, web pages, Office documents), generating AI-powered notes and summaries, creating multi-speaker podcasts from research, chatting with documents using context-aware AI, searching across materials with full-text and vector search, or running custom content transformations. Runs keyless on local models (Ollama or LM Studio; a loca
Browse the most popular Claude skills, all data & analytics skills, or write your own with the skills generator.