AlterLab Mermaid
Skill Verified ActivePart of the AlterLab Academic Skills suite. 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.
To establish and enforce standards for creating professional, accessible, and version-controlled documentation using markdown with embedded Mermaid diagrams.
Features
- Comprehensive markdown and Mermaid style guides
- 24 diagram type references with exemplar guides
- 9 document templates for various scientific writing needs
- Emphasis on accessibility (accTitle/accDescr) and GitHub rendering
- Clear guidelines for diagram composition and complexity management
Use Cases
- Creating scientific documents like reports, analyses, and manuscripts
- Writing project documentation, READMEs, and how-to guides
- Producing any diagram type (flowcharts, sequences, ER diagrams, etc.)
- Generating outputs that require version control and clean diffs
- Ensuring consistent and professional documentation across projects
Non-Goals
- Replacing image-based diagrams when Mermaid is insufficient (e.g., photorealistic images)
- Producing raw code or executables
- Managing project repositories or Git workflows directly
Practices
- Documentation quality
- Diagramming best practices
- Accessibility in documentation
Installation
npx skills add AlterLab-IEU/AlterLab-Academic-SkillsRuns the Vercel skills CLI (skills.sh) via npx — needs Node.js locally and at least one installed skills-compatible agent (Claude Code, Cursor, Codex, …). Assumes the repo follows the agentskills.io format.
Quality Score
VerifiedTrust Signals
Similar Extensions
Markdown and Mermaid Writing
100Comprehensive 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.
Readme I18n
100Use when the user wants to translate a repository README, make a repo multilingual, localize docs, add a language switcher, internationalize the README, or update localized README variants in a GitHub-style repository.
Mermaid Diagrams
99Teaches PMs to create syntactically valid mermaid diagrams by selecting the right diagram type for their communication need, following syntax validity rules, and validating before shipping. Covers all 15 mermaid diagram types with PM-relevant examples and a dual-lens navigation system.
HADS Claude Skill
99Use when writing technical documentation that needs to be readable by both humans and AI models, converting existing docs to HADS format, validating a HADS document, or optimizing documentation for token-efficient AI consumption.
Cli Anything Mermaid
98Command-line interface for Mermaid Live Editor - Create, edit, and render Mermaid diagrams via stateful project files and mermaid.ink renderer URLs. Designed for AI agents and power users who need to generate flowcharts, sequence diagrams, and other visualizations without a GUI.
Crypto Protocol Diagram
97Extracts protocol message flow from source code, RFCs, academic papers, pseudocode, informal prose, ProVerif (.pv), or Tamarin (.spthy) models and generates Mermaid sequenceDiagrams with cryptographic annotations. Use when diagramming a crypto protocol, visualizing a handshake or key exchange flow, extracting message flow from a spec or RFC, diagramming a ProVerif or Tamarin model, or drawing sequence diagrams for TLS, Noise, Signal, X3DH, Double Ratchet, FROST, DH, or ECDH protocols.