Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add richfrem/agent-plugins-skills --skill convert-mermaidgit clone --depth 1 https://github.com/richfrem/agent-plugins-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/richfrem/agent-plugins-skills/convert-mermaid)<a href="https://agentmods.dev/skills/richfrem/agent-plugins-skills/convert-mermaid"><img src="https://agentmods.dev/badge/skills/richfrem/agent-plugins-skills/convert-mermaid/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/richfrem/agent-plugins-skills/convert-mermaid"><img src="https://agentmods.dev/badge/skills/richfrem/agent-plugins-skills/convert-mermaid.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00060 | $0.00718 |
| Opus 5 | $0.00030 | $0.00359 |
| Sonnet 5 | $0.00012 | $0.00144 |
| Haiku 4.5 | $0.00006 | $0.00072 |
Grade A, and why
convert-mermaid scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 70 lines — stays where its author put it; the contents beside it link to each section on GitHub.
python ./scripts/convert.py -i architecture.mmd -o architecture.png -s 3 python ./scripts/verify_png.py architecture.png
Dependencies
This skill requires Python 3.8+ and standard library only. No external packages needed.
To install this skill's dependencies:
pip-compile ./requirements.in
pip install -r ./requirements.txt
See ./requirements.txt for the dependency lockfile (currently empty — standard library only).
Identity: The Mermaid Diagram Converter
You are a specialized conversion agent. Your job is to orchestrate the translation of .mmd or .mermaid syntax files into high-resolution .png binary images.
🛠️ Tools (Skill Scripts)
- Converter Engine:
scripts/convert.py - Verification Engine:
scripts/verify_png.py
Core Workflow: The Generation Pipeline
When a user requests .mmd to .png conversion, execute these phases strictly.
Phase 1: Engine Execution
Invoke the appropriate Python converter script wrapper.
If the user asks for "high resolution", "retina", or "HQ", set -s to 3 or 4.
python ./scripts/convert.py -i architecture.mmd -o architecture.png -s 3
Phase 2: Delegated Constraint Verification (L5 Pattern)
CRITICAL: Do not trust that the headless browser correctly generated the .png.
Immediately after the convert.py wrapper finishes, execute the verification engine:
python ./scripts/verify_png.py "architecture.png"
- If the script returns
"status": "success", the generated image is a valid PNG binary. - If it returns
"status": "errors_found", review the JSON log (e.g.,MissingMagicBytes,EmptyFile). Puppeteer likely crashed or wrote raw text to the file. Consult thereferences/fallback-tree.md.
Architectural Constraints
❌ WRONG: Manual Binary Manipulation (Negative Instruction Constraint)
Never attempt to write raw .png bitstreams natively from your context window. LLMs cannot safely generate binary blobs this way.
What ships with it
13 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- acceptance-criteria.md 605 B
- evals/eval_progress.png 333 KB
- evals/evals.json 629 B
- evals/results.tsv 2.5 KB
- fallback-tree.md 1.6 KB
- references/acceptance-criteria.md 42 B
- references/convert-mermaid-flow.mmd 44 B
- references/convert-mermaid-flow.png 44 B
- references/mermaid-to-png-architecture.mmd 51 B
- references/mermaid-to-png-architecture.png 51 B
- requirements.txt 22 B
- scripts/convert.py 27 B runs code
- scripts/verify_png.py 30 B runs code
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 70 lines · 60 tokens per session scan A baf6b7af7b61
convert-mermaid is a skill published in the GitHub repository richfrem/agent-plugins-skills (6 stars, last pushed today), licensed MIT. It adds 60 tokens to every session and 718 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
appllama-usage
Use the Appllama MCP (mcp.appllama.io) well — research real top-grossing mobile apps, their screens, flows, and UI elements, then build from what you learn. Load when the Appllama MCP is connected and the task involves building a mobile app or screen, researching app design patterns, studying…
appllama-app-design-skill
Build native-feeling, benchmark-quality mobile app screens (Expo / React Native). Use when designing or implementing any mobile UI — screens, flows, onboarding, paywalls, tab bars, sheets, settings, empty states — or when polishing motion, navigation, typography, dark mode, or perceived performance. Enforces Apple HIG…
pdf-design
Designs PDF reports and proposals from HTML with previews and branding. Use to create, export, or securely upload a PDF.
document-design
Creates print-ready HTML that exports to PDF. Use to make a proposal, report, one-pager, newsletter, slides, or flyer.
doc-pptx
A PowerPoint (.pptx) presentation generator and designer for business reports, investor pitches, training materials, conference talks, and product demos. It can build slides from direct content, HTML, NotebookLM, or a Markdown script.
strategy-consulting-visualization
Use when turning any content into clear, professional visualizations - board slides, reports, proposals, research summaries, training materials, technical diagrams, infographics, process flows, timelines, benchmarks, waterfall charts, or data-backed visual specs for any audience.