diff --git a/docs/design/deployment-v2.6.md b/docs/design/deployment-v2.6.md
index a69d6f7..8ae812d 100644
--- a/docs/design/deployment-v2.6.md
+++ b/docs/design/deployment-v2.6.md
@@ -71,6 +71,7 @@ sanguo-moziplus-v2
 │   │   │       ├── archive/
 │   │   │       └── data/
 │   │   └── experiences/                   ← per-project 经验库
+│   │   └── skills/                        ← per-project Skill 覆盖/扩展
 │   ├── sanguo_vnpy/
 │   │   └── ...
 │   └── _archived/                         ← 归档项目（只读）
diff --git a/docs/design/technical-design-v2.6.md b/docs/design/technical-design-v2.6.md
index 48753c4..d568e58 100644
--- a/docs/design/technical-design-v2.6.md
+++ b/docs/design/technical-design-v2.6.md
@@ -114,6 +114,17 @@ sanguo_moziplus_v2/                    # 项目根目录
 ├── inbox/                             # Inbox JSONL
 │   └── daemon.jsonl                   # 跨进程事件推送
 │
+├── skills/                            # 全局 Skill 库
+│   ├── builtins/                      # 系统内置 Skill
+│   │   ├── blackboard_operations/
+│   │   ├── code_review/
+│   │   └── data_validation/
+│   └── custom/                        # 蒸馏产出/用户创建
+│       └── {skill_id}/
+│           ├── SKILL.md               # 四要素
+│           ├── template.md            # 可选详细模板
+│           └── meta.yaml              # 版本/来源/tag
+│
 ├── tests/
 │   ├── unit/
 │   └── e2e/