[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75MPHVH04RYE5W7440MBVXJ":3,"skill-same:01M75MPHVH04RYE5W7440MBVXJ":45},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M75MPHVH04RYE5W7440MBVXJ","mermaid-diagrams",null,"Use when you need to create, version-control, or document software as text-based diagrams — class, sequence, flowchart, ER, state, or C4. Pick the diagram type deliberately and generate Mermaid so diagrams live in the repo and stay maintainable alongside code.","selamy-labs\u002Fagent-skills","selamy-labs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F287832944?v=4","01M75MDKJ0CKAM94KZ7TWQJM5Q","01M75MDKJNP3TATHAW1MX1FWM6",0,"MIT","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fmermaid-diagrams\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: mermaid-diagrams\ndescription: Use when you need to create, version-control, or document software as text-based diagrams — class, sequence, flowchart, ER, state, or C4. Pick the diagram type deliberately and generate Mermaid so diagrams live in the repo and stay maintainable alongside code.\n---\n\n# Mermaid Diagrams\n\nMermaid renders diagrams from plain text, so they version, diff, and review like\ncode instead of rotting as exported PNGs. The skill is mostly in **choosing the\nright diagram type** for the question being answered — the syntax is the easy\npart.\n\n## Pick the type from the question\n\n| The question you're answering | Diagram type |\n|---|---|\n| What are the objects\u002Fdomain and how do they relate? | `classDiagram` |\n| What talks to what, in what order, over time? | `sequenceDiagram` |\n| What's the process \u002F decision flow? | `flowchart` |\n| What's the database shape? | `erDiagram` |\n| What states can this thing be in? | `stateDiagram-v2` |\n| How does the system fit together at a high level? | C4 (`C4Context`\u002F`C4Container`) — see the `c4-architecture` skill |\n\nIf you can't name the question, you don't need a diagram yet.\n\n## The shape\n\nEvery diagram starts with the type, then its body:\n\n```mermaid\nsequenceDiagram\n    participant U as User\n    participant API\n    U->>API: POST \u002Flogin\n    API-->>U: 200 + token\n```\n\n```mermaid\nflowchart TD\n    A[Request] --> B{Authed?}\n    B -->|yes| C[Serve]\n    B -->|no| D[401]\n```\n\n## Gotchas that waste the most time\n\n- **Unknown keywords fail silently or break the whole diagram** — a typo'd\n  diagram-type or arrow renders nothing useful. Start from a known-good example\n  and mutate it.\n- **Reserved characters in labels** (`()`, `:`, `;`, `#`) need quoting:\n  `A[\"Node (v2)\"]`. This is the #1 cause of \"it won't render.\"\n- **Direction matters for readability** — `TD` (top-down) for processes\u002Ftrees,\n  `LR` (left-right) for pipelines and wide flows.\n- **Keep one diagram to one idea.** A 40-node flowchart is unreadable; split it.\n\n## Make it a repo artifact\n\nWrite the diagram into a fenced ```` ```mermaid ```` block in a markdown file\nchecked in next to the code it describes (README, ADR, `docs\u002F`). GitHub and most\nrenderers display it inline, and it updates in the same PR as the change it\ndocuments — that's the whole point of text diagrams over image exports.\n\n---\n\n_Adapted from the MIT-licensed [softaworks\u002Fagent-toolkit](https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit) `mermaid-diagrams` skill._\n","# Mermaid Diagrams\n\nMermaid renders diagrams from plain text, so they version, diff, and review like\ncode instead of rotting as exported PNGs. The skill is mostly in **choosing the\nright diagram type** for the question being answered — the syntax is the easy\npart.\n\n## Pick the type from the question\n\n| The question you're answering | Diagram type |\n|---|---|\n| What are the objects\u002Fdomain and how do they relate? | `classDiagram` |\n| What talks to what, in what order, over time? | `sequenceDiagram` |\n| What's the process \u002F decision flow? | `flowchart` |\n| What's the database shape? | `erDiagram` |\n| What states can this thing be in? | `stateDiagram-v2` |\n| How does the system fit together at a high level? | C4 (`C4Context`\u002F`C4Container`) — see the `c4-architecture` skill |\n\nIf you can't name the question, you don't need a diagram yet.\n\n## The shape\n\nEvery diagram starts with the type, then its body:\n\n```mermaid\nsequenceDiagram\n    participant U as User\n    participant API\n    U->>API: POST \u002Flogin\n    API-->>U: 200 + token\n```\n\n```mermaid\nflowchart TD\n    A[Request] --> B{Authed?}\n    B -->|yes| C[Serve]\n    B -->|no| D[401]\n```\n\n## Gotchas that waste the most time\n\n- **Unknown keywords fail silently or break the whole diagram** — a typo'd\n  diagram-type or arrow renders nothing useful. Start from a known-good example\n  and mutate it.\n- **Reserved characters in labels** (`()`, `:`, `;`, `#`) need quoting:\n  `A[\"Node (v2)\"]`. This is the #1 cause of \"it won't render.\"\n- **Direction matters for readability** — `TD` (top-down) for processes\u002Ftrees,\n  `LR` (left-right) for pipelines and wide flows.\n- **Keep one diagram to one idea.** A 40-node flowchart is unreadable; split it.\n\n## Make it a repo artifact\n\nWrite the diagram into a fenced ```` ```mermaid ```` block in a markdown file\nchecked in next to the code it describes (README, ADR, `docs\u002F`). GitHub and most\nrenderers display it inline, and it updates in the same PR as the change it\ndocuments — that's the whole point of text diagrams over image exports.\n\n---\n\n_Adapted from the MIT-licensed [softaworks\u002Fagent-toolkit](https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit) `mermaid-diagrams` skill._\n",{"name":5,"description":7},"main","54007b08157feb09e5bb9d7ff5ce4ddd21625dbf","skills\u002Fmermaid-diagrams",3,"https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills","https:\u002F\u002Fselamy.dev","https:\u002F\u002Fgithub.com\u002Fselamy-labs","2026-11-15 03:50:58",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add selamy-labs\u002Fagent-skills --skill mermaid-diagrams",{"tool":37,"command":38},"bunx","bunx skills add selamy-labs\u002Fagent-skills --skill mermaid-diagrams",{"tool":40,"command":41},"pnpm","pnpm dlx skills add selamy-labs\u002Fagent-skills --skill mermaid-diagrams","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fmermaid-diagrams\u002FSKILL.md",true,[],[46,53,60,67,73,80],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M75MY70JMSNFHQX63G90SKZ7","silence-phrase","A seemingly normal skill.","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fsilence-phrase\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M75MY5PKVKY60M8H2DFTW58C","selamy-bad-skill","This skill has a vendor prefix that should be rejected.","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fprefixed-name\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M75MY1TKXCH6WYN9ET0W4T02","oversized-description","This is a very long description that contains way too many words and should be rejected by the validator because it exceeds the forty five word limit that is enforced by the naming lint checker which ensures skill descriptions stay concise and readable for humans and machines alike without unnecessary verbosity or padding","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Foversized-description\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":18},"01M75MY0SZ7EKT99NWJEJ8HKS2","missing-frontmatter","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmissing-frontmatter\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M75MXYMBREE6D7KRR87YM4DH","malicious-skill","A poisoned skill used only as a negative fixture for the security gate.","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmalicious-skill\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":18},"01M75MXX2B7AC2QSSRRQQXTA0N","leaking-org-name","A skill about something.","https:\u002F\u002Fgithub.com\u002Fselamy-labs\u002Fagent-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fleaking-org-name\u002FSKILL.md",[],[]]