agentsclimarketplace

Draw mermaid diagrams

Skill JunfengRan/dev-env/skills/draw-mermaid-diagrams

在 Markdown 文档中绘制或修复 Mermaid 图,确保 GitHub 可渲染。 触发:用户要求画图、修复 Mermaid 渲染错误、为文档添加架构/序列/状态图, 或提到 mermaid、流程图、时序图、CI 验证图表。From its SKILL.md

Install
npx -y skills add JunfengRan/dev-env --skill draw-mermaid-diagrams

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.6 KB, 508 tokens by cl100k_base, as published. Nobody here has run it

绘制 GitHub 兼容的 Mermaid 图

dev-env 仓库的 Markdown 中编写 Mermaid 时,遵循本 skill,并在提交前运行验证。

工作流

  1. 确定图类型:flowchart / sequenceDiagram / stateDiagram-v2 / erDiagram / gantt
  2. 按兼容性规则编写(见下文)
  3. 本地验证npm run validate:mermaid
  4. 提交:CI 工作流 .github/workflows/validate-mermaid.yml 会自动复检

GitHub 兼容性规则(必须遵守)

通用

规则说明
节点 ID用 camelCase,无空格:userService,不用 user_service
保留字不用 endsubgraphgraphloop 作节点/参与者 ID
特殊字符@ / ( ) # 等必须包在引号内:A["@scope/pkg"]
多词标签一律加引号:B["AI SDK streamText"]
不用 emojiGitHub 渲染器可能拒绝
不用 \n用实际换行或缩短标签,勿写 \n 转义

flowchart

  • 边标签含特殊字符时加引号
  • subgraph 标题加引号
  • 避免 @pkg/name 裸写在 []

sequenceDiagram

  • 参与者 ID 不能与 loop/alt 等关键字冲突
  • 多词显示名必须引号

验证命令

npm install
npm run validate:mermaid
npm run validate:mermaid -- --render

输出格式

```mermaid
flowchart LR
    A[Step A] --> B[Step B]
```

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.