Agent Skill
Markdown Mermaid Writing skill
markdown-mermaid-writingforyourhealth111-pixel/Vibe-Skillsbundled/skills/markdown-mermaid-writing/SKILL.md
Comprehensive markdown and Mermaid diagram writing skill that establishes text-based diagrams as the DEFAULT documentation standard. Use this skill when creating ANY scientific document, report, analysis, or visualization — it ensures all outputs are in version-controlled, token-efficient markdown with embedded Mermaid diagrams as the source of truth, with clear pathways to downstream Python or AI-generated images. Includes full style guides (markdown + mermaid), 24 diagram type references, and 9 document templates ready to use.
always on
97 tokname + description
once used
3,397 tokSKILL.md body
bundled files
36260 KB
repo stars
3.8kGitHub
Install the Markdown Mermaid Writing skill
Skills CLI (Claude Code, Codex, Cursor and others)
npx skills add https://github.com/foryourhealth111-pixel/Vibe-Skills --skill markdown-mermaid-writing
Claude Code, by hand (all projects)
git clone --depth 1 https://github.com/foryourhealth111-pixel/Vibe-Skills.git /tmp/Vibe-Skills mkdir -p ~/.claude/skills cp -R /tmp/Vibe-Skills/bundled/skills/markdown-mermaid-writing ~/.claude/skills/markdown-mermaid-writing
For one project only, copy the folder into .claude/skills/ in that project instead. The agent picks it up when a task matches its description.
What it costs your context
Agent Skills load in three steps. Tokens counted with the o200k tokenizer; your model's count will differ a little.
| When | What loads | Cost |
|---|---|---|
| Every session | Name and description | 97 tok |
| When the agent uses it | The SKILL.md instructions | 3,397 tok |
| Only if opened | 36 bundled files (260 KB) | varies |
Until it is used, markdown-mermaid-writing costs about 14× less than the median MCP server we measured (1,363 tokens on every turn). Installing all 150 skills from foryourhealth111-pixel/Vibe-Skills would load 9,038 tokens of descriptions. Skills vs MCP study
Checks
Our checks found nothing to flag: it follows the Agent Skills specification's naming and size guidelines and doesn't pipe downloads into a shell.
Pre-approved tools (allowed-tools): Read, Write, Edit, Bash. The agent can use these without asking while the skill is active.
Checked 2026-10-22 · method
What's inside
The headings of its SKILL.md. Read the full file on GitHub.
- Markdown and Mermaid Writing
- Overview
- When to Use This Skill
- 🎨 The Source Format Philosophy
- Why text-based diagrams win
- The three-phase workflow
- What Mermaid can express
- 🔧 Core workflow
- Step 1: Identify the document type
- Step 2: Read the style guide
- Step 3: Pick the diagram type and read its guide
- Step 4: Write the document
- Step 5: Commit as text
- ⚠️ Common pitfalls
- Radar chart syntax (radar-beta)
- XY Chart vs Radar confusion
- Forgetting accTitle/accDescr on supported types
- 🔗 Integration with other skills
- With scientific-schematics
- With scientific-writing
- With literature-review
- With any skill that produces output documents
- 📚 Reference index
- Style guides
More skills from foryourhealth111-pixel/Vibe-Skills
- Error Resolverforyourhealth111-pixel/Vibe-Skills
Legacy error-resolution reference archive retained for migration. Do not route user tasks here; use systematic-debugging for active bug, stack-trace, and root-cause work.
3.8k37 tok idle · 2,032 in use - G2 Legend Expertforyourhealth111-pixel/Vibe-Skills
Expert skill for G2 legend development - provides comprehensive knowledge about legend rendering implementation, component architecture, layout algorithms, and interaction handling. Use when implementing, customizing, or debugging legend functionality in G2 visualizations.
3.8k47 tok idle · 1,636 in use - LQF_Machine_Learning_Expert_Guideforyourhealth111-pixel/Vibe-Skills
LQF Machine Learning Expert Guide - Routed skill for ML/Statistical Modeling with Critical Discussion Mode. Triggers on: machine learning, modeling, prediction, training, classification, regression, clustering, deep learning, neural network, model evaluation, feature engineering, hyperparameter tuning, overfitting, underfitting, baseline, ablation study, critique my approach, review my model, is this a good idea, should I use, what's wrong with, evaluate my solution, challenge my assumptions, discuss my approach Engages in critical discussion with minimum 3 rounds of iterative refinement. Challenges both user proposals and own suggestions with fact-based critique. Demands evidence and baselines before accepting solutions.
3.8k152 tok idle · 7,277 in use - adaptyvforyourhealth111-pixel/Vibe-Skills
Cloud laboratory platform for automated protein testing and validation. Use when designing proteins and needing experimental validation including binding assays, expression testing, thermostability measurements, enzyme activity assays, or protein sequence optimization. Also use for submitting experiments via API, tracking experiment status, downloading results, optimizing protein sequences for better expression using computational tools (NetSolP, SoluProt, SolubleMPNN, ESM), or managing protein design workflows with wet-lab validation.
3.8k95 tok idle · 690 in use - aeonforyourhealth111-pixel/Vibe-Skills
This skill should be used for time series machine learning tasks including classification, regression, clustering, forecasting, anomaly detection, segmentation, and similarity search. Use when working with temporal data, sequential patterns, or time-indexed observations requiring specialized algorithms beyond standard ML approaches. Particularly suited for univariate and multivariate time series analysis with scikit-learn compatible APIs.
3.8k74 tok idle · 2,409 in use - alpha-vantageforyourhealth111-pixel/Vibe-Skills
Access real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API. Use when fetching stock prices (OHLCV), company fundamentals (income statement, balance sheet, cash flow), earnings, options data, market news/sentiment, insider transactions, GDP, CPI, treasury yields, gold/silver/oil prices, Bitcoin/crypto prices, forex exchange rates, or calculating technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands). Requires a free API key from alphavantage.co.
3.8k126 tok idle · 1,284 in use - architecture-patternsforyourhealth111-pixel/Vibe-Skills
Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use when architecting complex backend systems or refactoring existing applications for better maintainability.
3.8k40 tok idle · 3,227 in use - astropyforyourhealth111-pixel/Vibe-Skills
Comprehensive Python library for astronomy and astrophysics. This skill should be used when working with astronomical data including celestial coordinates, physical units, FITS files, cosmological calculations, time systems, tables, world coordinate systems (WCS), and astronomical data analysis. Use when tasks involve coordinate transformations, unit conversions, FITS file manipulation, cosmological distance calculations, time scale conversions, or astronomical data processing.
3.8k83 tok idle · 2,618 in use