Mermaid Syntax

Mermaid Syntax is a Writing skill for Claude Code, published by tractorjuice in arc-kit.

2.2K stars274 forkson tractorjuice/arc-kitAdded 2026/08/18+1% in starsRepository updated 2026/08/17

ai-agentsai-governancearchitecture-decision-recordsarchitecture-governancearckitclaude-codecodex-clicomplianceenterprise-architecturegemini-cligithub-copilotgovtechmcpmodel-context-protocolopencodeprocurementpublic-sectorrequirements-engineeringsoftware-architecturetraceability

Install in seconds

Install Mermaid Syntax

Copy Mermaid Syntax into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/tractorjuice/arc-kit/tree/main/plugins/arckit-claude/skills/mermaid-syntax ~/.claude/skills/mermaid-syntax

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/tractorjuice/arc-kit.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: plugins/arckit-claude/skills/mermaid-syntax/SKILL.md in tractorjuice/arc-kit
Installs to: ~/.claude/skills/mermaid-syntax
Collection: One of 15 skills cataloged from this repository
Category: Writing — 1012 skills

What Mermaid Syntax does

Mermaid Syntax provides reference material for all 23 Mermaid diagram types, theming, and configuration. Use it when troubleshooting rendering errors or looking up syntax for flowcharts, sequence, class, state, ER, Gantt, C4, mindmap, timeline, and other diagrams.

Mermaid Syntax is cataloged under Writing on DirSkills. Mermaid Syntax comes from a repository tagged ai-agents, ai-governance, architecture-decision-records, architecture-governance and arckit.

Documentation

README

Excerpt

Mermaid Syntax Reference

A comprehensive reference for all 23 Mermaid diagram types plus configuration and theming. This skill provides official Mermaid syntax documentation sourced from the mermaid-skill project (auto-synced from upstream Mermaid docs).

This skill ships reference material, not runnable scripts. Read the relevant reference file with Read, apply the syntax, and write the diagram into the user's artefact. Do not Bash-execute anything from references/ — they are Mermaid syntax docs, not commands.

To look up syntax for a specific diagram type, identify the type from the table below and read the corresponding reference file.

Supported Diagram Types

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Mermaid Syntax

What else does tractorjuice publish alongside Mermaid Syntax?
Mermaid Syntax is one of 15 skills that DirSkills catalogs from tractorjuice/arc-kit, the repository it ships in. Its siblings there include ArcKit Build, ArcKit Release and Architecture Workflow. Each one is a separate skill with its own page in this directory, installs the same way Mermaid Syntax does, and is maintained by tractorjuice in that same repository. The rest of the collection is listed on the tractorjuice/arc-kit page.
How does Mermaid Syntax compare to other Writing skills?
Mermaid Syntax ranks #273 by stars among the 1012 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Mermaid Syntax against them. Open each page to compare what they document and how they install.