claude-code-mermaid-skills
Claude Code SKILLS for Mermaid Diagrams
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/archatas--claude-code-mermaid-skills)HTML
<a href="/listings/archatas--claude-code-mermaid-skills"><img src="/api/listings/archatas--claude-code-mermaid-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Claude Code discovers skills from the `skills/` directory. Make these available by placing the skills where Claude Code looks for them — either copy the folders into your project's or user-level skills directory, or clone this repo there:
# Project-level skills cp -r skills/* /path/to/your/project/.claude/skills/ # or user-level skills cp -r skills/* ~/.claude/skills/
Once installed, invoke a skill in Claude Code with its name, e.g. `/mermaid-convert` or `/mermaid-shareholders-flowchart`. Both skills are manual-only (they are not auto-invoked by the model).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 79 lines
- # Claude Code Mermaid Skills
- A small collection of [Claude Code](https://claude.com/claude-code) skills for working with
- [Mermaid.js](https://mermaid.js.org/) diagrams — rendering them to images with a consistent
- look, and generating shareholder-friendly flowcharts from code.
- ## Skills
- ### `mermaid-shareholders-flowchart`
- Turn a function or area of a codebase into a **flowchart a non-technical shareholder can read** —
- business decisions and outcomes rather than framework mechanics — while staying faithful to the
- real control flow. The detailed heuristics for raising code up to business language live in
- [`skills/mermaid-shareholders-flowchart/references/translation-guide.md`](skills/mermaid-shareholders-flowchart/references/translation-guide.md).
- Once it has produced the diagram, it hands the generated `.mmd` to the `mermaid-convert` script
- below for rendering, so both skills share the same consistent light theme.
- ### `mermaid-convert`
- Render Mermaid diagrams into **both SVG and PNG** using the local Mermaid CLI (`mmdc`), applying
- a bundled light theme so every diagram looks consistent regardless of which project it came from.
- - Accepts a `.mmd`/`.mermaid` file, a `.md`/`.markdown` file (every ` ```mermaid ` block is
- extracted and rendered), or a diagram piped via stdin.
- - Styling lives in two bundled files — `assets/mermaid-light.json` (colors/fonts) and
- `assets/mermaid-light.css` (layout/spacing) — so you can restyle every conversion at once.
- - The converter script uses only Node.js built-ins; the only external dependency is `mmdc`.
- ```bash
- node skills/mermaid-convert/scripts/convert.mjs <input> [--out-dir <dir>] [--name <basename>] [--scale <n>]
- ```
- ## Requirements
- - [Node.js](https://nodejs.org/) (for the converter script; built-in modules only).
- - The Mermaid CLI, which provides `mmdc`:
- ```bash
- npm install -g @mermaid-js/mermaid-cli
- ```
- It relies on a headless Chromium that `mmdc` downloads on first run.
- ## Installation
- Claude Code discovers skills from the `skills/` directory. Make these available by placing the
- skills where Claude Code looks for them — either copy the folders into your project's or user-level
- skills directory, or clone this repo there:
- ```bash
- # Project-level skills
- cp -r skills/* /path/to/your/project/.claude/skills/
- # or user-level skills
- cp -r skills/* ~/.claude/skills/
- ```
- Once installed, invoke a skill in Claude Code with its name, e.g. `/mermaid-convert` or
- `/mermaid-shareholders-flowchart`. Both skills are manual-only (they are not auto-invoked by the
- model).
- ## Repository layout
- ```
- skills/
- mermaid-convert/
- SKILL.md # workflow, styling, gotchas
- assets/
- mermaid-light.json # Mermaid config: light theme palette
- mermaid-light.css # themeCSS for layout/spacing tweaks
- scripts/
- convert.mjs # the converter
- package.json
- mermaid-shareholders-flowchart/
- SKILL.md # workflow for shareholder flowcharts
- references/
- translation-guide.md # code → business-language heuristics
- ```
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.