/wiki-diagram

Add Mermaid diagrams to wiki pages to aid understanding. This skill should be used during ingest/review when a concept involves a process, architecture, sequence, hierarchy, or comparison that is easier to grasp visually, or when the user explicitly asks to

issacw228@issacw228

GitHub

From plugin

student-llm-wiki

19612 skills5 commands

Install

$ npx -y skills add IssacW228/student-llm-wiki --skill wiki-diagram --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/wiki-diagram

Context preview

The summary Claude sees to decide when to auto-load this skill.

Add Mermaid diagrams to wiki pages to aid understanding. This skill should be used during ingest/review when a concept involves a process, architecture, sequence, hierarchy, or comparison that is easier to grasp visually, or when the user explicitly asks to

SKILL.md

wiki-diagram.SKILL.md

name: wiki-diagram
description: Add Mermaid diagrams to wiki pages to aid understanding. This skill should be used during ingest/review when a concept involves a process, architecture, sequence, hierarchy, or comparison that is easier to grasp visually, or when the user explicitly asks to "画图"/"配图"/"diagram"/"visualize" a concept.

Wiki Diagram — Mermaid 可视化

用 Mermaid 给概念页配图。Obsidian 原生渲染 ```mermaid 代码块，无需安装插件。

何时配图 When to Diagram

只在"文字描述比图更难懂"时配图，不要每页都加。适合配图的情况：

多步骤流程/算法 → flowchart
协议交互/攻击步骤，含时序（适合 COMP4337） → sequenceDiagram
系统架构/模型结构，含组件关系 → flowchart
概念分类/知识地图 → mindmap
状态转换/生命周期 → stateDiagram-v2
概念间关系网（跨课程连接） → graph

不适合配图：单一定义、纯数学公式推导、线性叙述无分支无关系的内容。

图表类型映射 Diagram Type Mapping

| 内容类型 | Mermaid 类型 | |---|---| | 算法步骤/数据处理流程 | `flowchart TD` | | 协议/攻击交互序列 | `sequenceDiagram` | | 模型架构/系统组件 | `flowchart LR` | | 概念分类/知识地图 | `mindmap` | | 状态机/生命周期 | `stateDiagram-v2` | | 概念间关系网 | `graph TD` |

放置位置 Placement

在概念页的 `直觉 Intuition` 或 `详细解释 Detailed` 章节之后，新增 `## 图解 Diagram` 小节。局部插入，不重写全页。

## 图解 Diagram

\`\`\`mermaid
flowchart TD
    A[输入 Input] --> B[处理 Process]
    B --> C[输出 Output]
\`\`\`

质量规则 Quality Rules

1. **≤10 个节点**：超过就简化或只画核心路径 2. **双语标签**：节点文字用"中文 English"或保持和页面其他部分一致的语言风格 3. **一页最多 1-2 个图**：避免视觉噪音 4. **语法要对**：节点 ID、箭头、括号/引号配对正确，避免渲染失败 5. 若图表来自课件原图：先在来源页文字描述要点，再判断是否用 Mermaid 重绘成更清晰的逻辑图（不需要 1:1 还原）

触发方式 Triggers

**自动**：ingest/review 创建或更新概念页时，按上述标准判断是否需要配图（见 wiki-ingest 步骤）
**手动**：用户说"画图"/"画个图"/"配图"/"diagram this"/"visualize X"，或用 `/diagram {concept}` 命令，针对指定概念页生成/补充图表

Read it on GitHub ↗

Ships withstudent-llm-wiki

用 AI 把课件变成你自己的知识库 Turn your course slides into a personal wiki with AI

Get the whole plugin

Stats

Bash Linux Git GitHub Mermaid

+5 tags

Anthropic OpenAI Obsidian iOS Android

196

Stars

Forks

Maintained