diff --git a/docs/skillhub/en/guide/review.md b/docs/skillhub/en/guide/review.md
index 56b5f18b0..09600d161 100644
--- a/docs/skillhub/en/guide/review.md
+++ b/docs/skillhub/en/guide/review.md
@@ -74,7 +74,9 @@ A user reports an inappropriate skill package, and an administrator investigates
- Download the full package for local testing
- Review the compliance snapshot and the diff from the previous published version
-
+
+
+The review section follows the PUBLIC / NAMESPACE_ONLY branch: scanning completes before the version waits for a review decision.
4. Make a decision:
- **Approve**: The skill package is officially published and the developer is notified
diff --git a/docs/skillhub/en/guide/skill-publish.md b/docs/skillhub/en/guide/skill-publish.md
index 9ccc2fb45..1577a36ed 100644
--- a/docs/skillhub/en/guide/skill-publish.md
+++ b/docs/skillhub/en/guide/skill-publish.md
@@ -128,7 +128,9 @@ file: skill-package.zip
visibility: PUBLIC
```
-
+
+
+The diagram covers ordinary uploads; scan failures, review rejection and privileged publishing are described below.
5. **Security Scan**
diff --git a/docs/skillhub/en/guide/skill-suites.md b/docs/skillhub/en/guide/skill-suites.md
index 7b0e4f416..37125edc6 100644
--- a/docs/skillhub/en/guide/skill-suites.md
+++ b/docs/skillhub/en/guide/skill-suites.md
@@ -12,6 +12,10 @@ A Skill Suite is a separately versioned collection of exact published Skill vers
A [Bundle](./suite-bundle) is an authoring format. A Suite is not a workflow runtime: coordination depends on the entry and member instructions. A Skill can still be installed independently.
+
+
+Installation ends at separate member files. Agent usage starts with an explicit task.
+
## Install a Suite
Follow the related Suites on a Skill detail page to inspect the entry, pinned members and installability. A related-Suite badge denotes membership, not a mandatory dependency. Ordinary `skillhub search` searches Skills, and same-named Suites require the explicit `suite` command.
diff --git a/docs/skillhub/guide/review.md b/docs/skillhub/guide/review.md
index c65928c7d..30194cd6d 100644
--- a/docs/skillhub/guide/review.md
+++ b/docs/skillhub/guide/review.md
@@ -77,7 +77,9 @@ SkillHub 提供了完整的审核工作流,确保发布到注册中心的技
- 在“审核记录”查看提交历史和已完成的审核意见;该页签打开时才请求历史
- 套件审核在内容区核对待审快照。快照加载失败时可重试,加载成功前“通过”按钮不可用
-
+
+
+本页的审核部分对应 PUBLIC / NAMESPACE_ONLY 分支:扫描完成后,版本等待审核决定。
4. 在页面底部固定的审核栏填写意见并做出决策;切换页签保留意见,切换到另一个审核对象时清空意见、驳回表单和未确认弹窗:
- **批准**:技能包正式发布,开发者收到通知
diff --git a/docs/skillhub/guide/skill-publish.md b/docs/skillhub/guide/skill-publish.md
index 917920bbe..9fbd6b096 100644
--- a/docs/skillhub/guide/skill-publish.md
+++ b/docs/skillhub/guide/skill-publish.md
@@ -132,7 +132,9 @@ file: skill-package.zip
visibility: PUBLIC
```
-
+
+
+图示覆盖普通上传;扫描失败、审核拒绝及特权发布的区别见下文。
5. **安全扫描**
diff --git a/docs/skillhub/guide/skill-suites.md b/docs/skillhub/guide/skill-suites.md
index 3515cb65e..1a699dab1 100644
--- a/docs/skillhub/guide/skill-suites.md
+++ b/docs/skillhub/guide/skill-suites.md
@@ -12,6 +12,10 @@ Skill Suite(技能套装)把一组已发布 Skill 的精确版本组织成
Bundle 是[创作与导入格式](./suite-bundle),不是安装后需要执行的程序。套装也不是工作流引擎:是否串联成员、如何分派任务,由入口及成员的 `SKILL.md` 决定。普通技能可以独立安装,不必安装它关联的所有套装。
+
+
+安装交付的是独立成员文件;在 Agent 中提出任务后才开始使用。
+
## 找到并安装套装
在技能详情中查看关联套装,进入套装详情,确认入口、成员版本和可安装状态。卡片上的关联标识只表示收录关系。普通 `skillhub search` 搜索 Skill;安装同名 Suite 必须显式使用 `suite` 子命令。
diff --git a/docs/skillhub/public/diagrams/skill-publish-lifecycle-en.svg b/docs/skillhub/public/diagrams/skill-publish-lifecycle-en.svg
new file mode 100644
index 000000000..df4f2c608
--- /dev/null
+++ b/docs/skillhub/public/diagrams/skill-publish-lifecycle-en.svg
@@ -0,0 +1,49 @@
+
diff --git a/docs/skillhub/public/diagrams/skill-publish-lifecycle-zh.svg b/docs/skillhub/public/diagrams/skill-publish-lifecycle-zh.svg
new file mode 100644
index 000000000..0ce350ce7
--- /dev/null
+++ b/docs/skillhub/public/diagrams/skill-publish-lifecycle-zh.svg
@@ -0,0 +1,49 @@
+
diff --git a/docs/skillhub/public/diagrams/skill-suite-usage-en.svg b/docs/skillhub/public/diagrams/skill-suite-usage-en.svg
new file mode 100644
index 000000000..520109d89
--- /dev/null
+++ b/docs/skillhub/public/diagrams/skill-suite-usage-en.svg
@@ -0,0 +1,32 @@
+
diff --git a/docs/skillhub/public/diagrams/skill-suite-usage-zh.svg b/docs/skillhub/public/diagrams/skill-suite-usage-zh.svg
new file mode 100644
index 000000000..7702db6ed
--- /dev/null
+++ b/docs/skillhub/public/diagrams/skill-suite-usage-zh.svg
@@ -0,0 +1,32 @@
+