From 8e1f60f47eaa0e9fd1a0121c49cf62d8c5584068 Mon Sep 17 00:00:00 2001 From: lzw-git-all <19607802@qq.com> Date: Sat, 25 Apr 2026 13:37:59 +0800 Subject: [PATCH] docs(skills): improve skill loading process diagram clarity (#81) Split the "Skill" participant into two distinct entities to better illustrate the three-level loading architecture: - Skill Instructions (Level 2): SKILL.md body - Skill Resources (Level 3): Bundled files (templates, scripts, etc.) Also fixed inaccurate "bash: read" notation - Claude uses the Read tool, not bash commands. Co-authored-by: Claude Opus 4.6 --- 03-skills/README.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/03-skills/README.md b/03-skills/README.md index 5fe959e..2174922 100644 --- a/03-skills/README.md +++ b/03-skills/README.md @@ -66,19 +66,20 @@ This means you can install many Skills without context penalty—Claude only kno ```mermaid sequenceDiagram participant User - participant Claude as Claude - participant System as System - participant Skill as Skill + participant Claude + participant System + participant SkillInst as Skill Instructions + participant SkillRes as Skill Resources User->>Claude: "Review this code for security issues" Claude->>System: Check available skills (metadata) System-->>Claude: Skill descriptions loaded at startup Claude->>Claude: Match request to skill description - Claude->>Skill: bash: read code-review/SKILL.md - Skill-->>Claude: Instructions loaded into context + Claude->>SkillInst: Read code-review/SKILL.md + SkillInst-->>Claude: Level 2: Instructions loaded Claude->>Claude: Determine: Need templates? - Claude->>Skill: bash: read templates/checklist.md - Skill-->>Claude: Template loaded + Claude->>SkillRes: Read templates/checklist.md + SkillRes-->>Claude: Level 3: Template loaded Claude->>Claude: Execute skill instructions Claude->>User: Comprehensive code review ```