What is a Claude Code Skill?

A specialized capability that enhances Claude's behavior when performing specific tasks, providing domain-specific guidance, best practices, and implementation patterns.

What types of diagrams can I create with this skill?

It supports 24 types, including flowcharts, sequence diagrams, ER diagrams, Gantt charts, C4 architecture models, Git graphs, and Sankey diagrams.

Can I still use traditional images for complex plots?

Yes, the skill uses a three-phase workflow where Mermaid is the mandatory source of truth, while Python-generated charts or AI visuals are used as optional supplementary assets.

Does this skill support GitHub dark mode?

Yes, the included style guide specifically prohibits initialization directives that break dark mode rendering to ensure universal readability.

Why use Mermaid instead of Python-generated images?

Mermaid diagrams are text-based, making them easily editable, git-diffable, and more token-efficient for AI models than prose descriptions or binary image files.

Markdown & Mermaid Writing

Name: Markdown & Mermaid Writing
Author: Yezez9

byYezez9

0•

Content Management

Standardizes scientific documentation and technical diagrams using Markdown and Mermaid syntax to ensure version-control-friendly visualization.

This skill establishes a text-based documentation standard for Claude, prioritizing Markdown and Mermaid diagrams over static images. It provides a comprehensive framework including 24 specialized diagram types, 9 domain-specific templates, and a rigorous style guide. By enforcing a 'Mermaid-first' approach, it ensures that all scientific reports, architecture decisions, and project analyses are git-diffable, token-efficient, and natively renderable across platforms like GitHub, GitLab, and VS Code, maintaining text as the ultimate source of truth.

Key Features

01Enforces text-based diagram standards for superior version control and git-diffing

020 GitHub stars

03Provides 9 standardized Markdown templates for research papers, ADRs, and status reports

04Includes 24 specialized Mermaid diagram references including C4, Gantt, and State machines

05Optimizes documentation for AI token efficiency and accessibility standards

06Implements a mandatory Phase 1 workflow ensuring diagrams remain the source of truth

Use Cases

01Visualizing system architectures and data pipelines within project documentation

02Creating version-controlled scientific manuscripts and technical reports

03Standardizing project documentation and decision records across research teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yezez9/research-agent markdown-mermaid-writing

For use in Claude.ai and ChatGPT

Key Features

01Enforces text-based diagram standards for superior version control and git-diffing

020 GitHub stars

03Provides 9 standardized Markdown templates for research papers, ADRs, and status reports

04Includes 24 specialized Mermaid diagram references including C4, Gantt, and State machines

05Optimizes documentation for AI token efficiency and accessibility standards

06Implements a mandatory Phase 1 workflow ensuring diagrams remain the source of truth

Use Cases

01Visualizing system architectures and data pipelines within project documentation

02Creating version-controlled scientific manuscripts and technical reports

03Standardizing project documentation and decision records across research teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yezez9/research-agent markdown-mermaid-writing

For use in Claude.ai and ChatGPT