Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/archatas--claude-code-mermaid-skills/badge.svg)](/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

i

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
  1. # Claude Code Mermaid Skills
  2. A small collection of [Claude Code](https://claude.com/claude-code) skills for working with
  3. [Mermaid.js](https://mermaid.js.org/) diagrams — rendering them to images with a consistent
  4. look, and generating shareholder-friendly flowcharts from code.
  5. ## Skills
  6. ### `mermaid-shareholders-flowchart`
  7. Turn a function or area of a codebase into a **flowchart a non-technical shareholder can read** —
  8. business decisions and outcomes rather than framework mechanics — while staying faithful to the
  9. real control flow. The detailed heuristics for raising code up to business language live in
  10. [`skills/mermaid-shareholders-flowchart/references/translation-guide.md`](skills/mermaid-shareholders-flowchart/references/translation-guide.md).
  11. Once it has produced the diagram, it hands the generated `.mmd` to the `mermaid-convert` script
  12. below for rendering, so both skills share the same consistent light theme.
  13. ### `mermaid-convert`
  14. Render Mermaid diagrams into **both SVG and PNG** using the local Mermaid CLI (`mmdc`), applying
  15. a bundled light theme so every diagram looks consistent regardless of which project it came from.
  16. - Accepts a `.mmd`/`.mermaid` file, a `.md`/`.markdown` file (every ` ```mermaid ` block is
  17. extracted and rendered), or a diagram piped via stdin.
  18. - Styling lives in two bundled files — `assets/mermaid-light.json` (colors/fonts) and
  19. `assets/mermaid-light.css` (layout/spacing) — so you can restyle every conversion at once.
  20. - The converter script uses only Node.js built-ins; the only external dependency is `mmdc`.
  21. ```bash
  22. node skills/mermaid-convert/scripts/convert.mjs <input> [--out-dir <dir>] [--name <basename>] [--scale <n>]
  23. ```
  24. ## Requirements
  25. - [Node.js](https://nodejs.org/) (for the converter script; built-in modules only).
  26. - The Mermaid CLI, which provides `mmdc`:
  27. ```bash
  28. npm install -g @mermaid-js/mermaid-cli
  29. ```
  30. It relies on a headless Chromium that `mmdc` downloads on first run.
  31. ## Installation
  32. Claude Code discovers skills from the `skills/` directory. Make these available by placing the
  33. skills where Claude Code looks for them — either copy the folders into your project's or user-level
  34. skills directory, or clone this repo there:
  35. ```bash
  36. # Project-level skills
  37. cp -r skills/* /path/to/your/project/.claude/skills/
  38. # or user-level skills
  39. cp -r skills/* ~/.claude/skills/
  40. ```
  41. Once installed, invoke a skill in Claude Code with its name, e.g. `/mermaid-convert` or
  42. `/mermaid-shareholders-flowchart`. Both skills are manual-only (they are not auto-invoked by the
  43. model).
  44. ## Repository layout
  45. ```
  46. skills/
  47. mermaid-convert/
  48. SKILL.md # workflow, styling, gotchas
  49. assets/
  50. mermaid-light.json # Mermaid config: light theme palette
  51. mermaid-light.css # themeCSS for layout/spacing tweaks
  52. scripts/
  53. convert.mjs # the converter
  54. package.json
  55. mermaid-shareholders-flowchart/
  56. SKILL.md # workflow for shareholder flowcharts
  57. references/
  58. translation-guide.md # code → business-language heuristics
  59. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.