Beautiful Mermaid

Create, render, and validate Mermaid diagrams when users need Mermaid source converted into SVG, PNG, HTML previews, or polished diagram assets.

9 stars 4 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jscraik/Agent-Skills --skill beautiful-mermaid
Manual install
git clone --depth 1 https://github.com/jscraik/Agent-Skills.git /tmp/Agent-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Agent-Skills/Skills/content-publishing/beautiful-mermaid ~/.claude/skills/beautiful-mermaid

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Beautiful Mermaid

## Philosophy
- Keep the skill focused on the decision and workflow the user actually requested.
- Preserve important context through progressive disclosure instead of trimming it away.
- Prefer repo-local contracts, wrappers, and validation before generic advice.

## When To Use
- The user asks to render Mermaid diagrams to images.
- Mermaid source needs SVG, PNG, or HTML preview output.
- Diagram syntax or rendering failures need diagnosis.

## Avoid
- Designing a diagram from scratch when no Mermaid source or structure exists.
- Non-Mermaid charting or general slide design.
- Downloading remote assets or executing untrusted diagram code.

## Inputs
- Mermaid source
- desired output format
- theme or style constraints
- output path
- rendering error logs

## Outputs
- rendered asset path
- source used
- render command
- syntax fixes
- validation evidence
- Schema-bound outputs include schema_version.

## Workflow
- Start with 2-3 focused surfaces before expanding scope.
- Confirm the Mermaid source and output format.
- Validate syntax before rendering when possible.
- Use bundled render helpers instead of ad hoc commands.
- Keep source and generated asset paths clear.
- Report render command, output files, and any syntax compromises.

## Constraints
- Apply the context-disposition policy: move important still-valid context to references, and intentionally discard stale, duplicated, unsafe, superseded, or low-signal text.
Read the full skill on GitHub

Details

Skill name
beautiful-mermaid
Path
Skills/content-publishing/beautiful-mermaid/SKILL.md
License
Apache-2.0
Repo updated
16 November 2026

FAQ

What does the Beautiful Mermaid skill do?

Create, render, and validate Mermaid diagrams when users need Mermaid source converted into SVG, PNG, HTML previews, or polished diagram assets.

How do I install the Beautiful Mermaid skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jscraik/Agent-Skills --skill beautiful-mermaid. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Beautiful Mermaid popular?

It lives in jscraik/Agent-Skills, which has 9 GitHub stars and 4 forks.

Related skills

1password

9

jscraik/Agent-Skills

Plan, diagnose, and validate 1Password CLI workflows. Use when tasks need op CLI sign-in, secret references, op run, op inject, item reads, env injection, or service-account secret access.

Security

Agentation

9

jscraik/Agent-Skills

Audit, validate, and troubleshoot Agentation integrations in frontend apps. Use when annotations, MCP registration, endpoint sync, webhook delivery, or watch mode readiness are failing.

AI, LLMs & Agents

Agents Md

9

jscraik/Agent-Skills

Use when reviewing, creating, shrinking, or refactoring AGENTS.md and directly linked instruction guidance for stale or conflicting rules against current model documentation, scoped routing, deduplication, or progressive disclosure.

AI, LLMs & Agents

Bucket Errors

5

EquiStamp/CFAR-Claude-Skills

CFAR rationality technique for identifying where you've entangled questions that should be separate, causing you to flinch away from evidence. Use when the user: (1) feels defensive about acknowledging something true, (2) conflates unrelated beliefs ("Am I a good writer?" with "Did I spell this correctly?"), (3) has trouble accepting feedback, (4) wants to practice detecting question substitution, or (5) notices they avoid thinking about certain topics. Related to Kahneman's attribute substitution. Triggers: "bucket error", "conflating", "flinching away", "defensive about", "question substitut

Writing & Content

Azure AI Translation Ts

9

huytran1120/vietnam-agentic-skills

Text and document translation with REST-style clients.

Writing & Content

Openai Docs

9

jscraik/Agent-Skills

Use when the user asks how to build with OpenAI products or APIs, asks about Codex itself or choosing Codex surfaces, needs up-to-date official documentation with citations, help choosing the latest model for a use case, or model upgrade and prompt-upgrade guidance; use OpenAI docs MCP tools for non-Codex docs questions, use the Codex manual helper first for broad Codex self-knowledge, and restrict fallback browsing to official OpenAI domains.

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.