diff --git a/README.md b/README.md
index 56a6051..1047262 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,75 @@
-1
\ No newline at end of file
+# KB-Skills 知识库技能集
+
+OpenClaw 知识库工作流技能集合，用于内容采集、处理与分析。
+
+## 技能列表
+
+### 📺 Bilibili
+
+| 技能 | 描述 |
+|------|------|
+| [kb-bilibili-metadata](kb-bilibili-metadata/) | 提取视频/专栏/UP主元数据 |
+| [kb-bilibili-content](kb-bilibili-content/) | 下载视频、提取字幕与文章内容 |
+
+### 📝 知乎
+
+| 技能 | 描述 |
+|------|------|
+| [kb-zhihu-metadata](kb-zhihu-metadata/) | 提取问题/回答/用户元数据，爬取专栏文章 |
+| [kb-zhihu-content](kb-zhihu-content/) | 下载视频、从 MediaCrawler 读取文章内容 |
+
+### 🎙️ 语音识别
+
+| 技能 | 描述 |
+|------|------|
+| [kb-whisper](kb-whisper/) | Whisper 本地语音识别转录 |
+| [kb-whisper-diarization](kb-whisper-diarization/) | Whisper + pyannote 说话者分离 |
+| [kb-funasr](kb-funasr/) | 阿里 FunASR 本地语音识别 |
+
+### 🔧 工具类
+
+| 技能 | 描述 |
+|------|------|
+| [kb-link-parser](kb-link-parser/) | 多平台 URL 解析（Bilibili/YouTube/知乎） |
+| [kb-ocr-processor](kb-ocr-processor/) | 视频截帧 OCR 文字提取 |
+| [kb-deep-analyzer](kb-deep-analyzer/) | AI 驱动深度内容分析 |
+| [kb-workflow](kb-workflow/) | 知识库工作流编排（入口技能） |
+
+## 快速开始
+
+每个技能目录下都有 `SKILL.md` 说明文档，包含：
+- 功能特性
+- 环境变量配置
+- 使用命令示例
+
+### 通用环境变量
+
+| 变量名 | 用途 | 适用技能 |
+|--------|------|----------|
+| `BILIBILI_COOKIE` | B站登录态 | kb-bilibili-* |
+| `ZHIHU_COOKIE` | 知乎登录态 | kb-zhihu-* |
+| `AI_API_KEY` | AI 服务密钥 | kb-deep-analyzer |
+| `HF_TOKEN` | HuggingFace Token | kb-whisper-diarization |
+
+### 推荐工作流
+
+```
+kb-workflow（入口）
+    ├── kb-link-parser（解析 URL）
+    ├── kb-*-metadata（提取元数据）
+    ├── kb-*-content（下载/提取内容）
+    ├── kb-whisper / kb-funasr（语音转文字）
+    ├── kb-ocr-processor（OCR 提取）
+    └── kb-deep-analyzer（AI 深度分析）
+```
+
+## 开发规范
+
+- 每个技能独立目录，包含 `SKILL.md` 文档
+- 支持命令行调用和 Python 模块导入
+- 输出统一使用 JSON 格式
+- 依赖通过 `requirements.txt` 或 `.env.example` 声明
+
+## 维护者
+
+由 OpenClaw agent 维护，仓库地址：`ssh://sc-gitea@192.168.1.22:2223/starmen1265/kb-skills.git`
diff --git a/common-require/README.md b/common-require/README.md
deleted file mode 100644
index 6e348ba..0000000
--- a/common-require/README.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# common-require
-
-通用规则技能，所有代理必须遵守。
-
-## 简介
-
-本技能定义了代理在执行任务时必须遵守的通用规则，包括沟通方式、子代理使用、安全规范等。
-
-## 包含规则
-
-### 1. 沟通规则
-- 用中文沟通
-- 收到消息立刻先回复"收到！"，再继续安排工作
-
-### 2. 子代理使用规则
-- **代码开发和耗时操作**：必须交给子代理处理
-- **子代理模型**：优先使用 `g5`
-- **汇报机制**：
-  - 子代理开始工作时，立刻向用户汇报
-  - 汇报格式：「已安排代理处理[任务]」
-  - 每5分钟查询一下子代理状态，汇总之后简报给用户
-
-### 3. 文件存放规则
-- 除非用户或者技能明确指定要求链接，否则禁止链接目录到 `~/.openclaw` 目录下
-- 所有工作产出放在 `~/work/` 对应工作的子目录中
-
-### 4. 安全规则
-
-#### rm 命令使用规则
-- 使用 rm 命令之前必须向用户汇报具体操作命令
-- 禁止直接执行 rm 命令
-- 等待用户确认后才能执行
-
-#### OpenClaw 配置修改规则
-- OpenClaw.json 做任何改动之前，先汇报具体修改内容
-- 禁止未汇报就直接修改 OpenClaw.json
-- 等待用户确认之后才能执行
-- 用户确认可以执行，操作之前先备份 openclaw.json
-
-## 使用方式
-
-在 `openclaw.json` 的 agent 配置中添加：
-
-```json
-{
-  "id": "your-agent",
-  "skills": ["common-require"]
-}
-```
-
-## 更新日志
-
-### 2026-02-15
-- 初始版本
diff --git a/common-require/SKILL.md b/common-require/SKILL.md
deleted file mode 100644
index c31fae9..0000000
--- a/common-require/SKILL.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# common-require
-
-通用规则，所有代理必须遵守。
-
-## 沟通规则
-- 用中文沟通
-- 收到消息立刻先回复"收到！"，再继续安排工作
-
-## 子代理使用规则
-
-1. **代码开发和耗时操作**
-   - 必须交给子代理处理
-   - 子代理优先使用模型：`g5`
-
-2. **汇报机制**
-   - 子代理开始工作时，立刻向用户汇报
-   - 汇报格式：「已安排代理处理[任务]」
-   - 每5分钟查询一下子代理状态，汇总之后简报给用户
-
-## 文件存放
-
-- **除非用户或者技能明确指定要求链接，否则禁止链接目录到 ~/.openclaw 目录下**
-- 所有工作产出放在 `~/work/` 对应工作的子目录中
-
-## ⚠ 安全规则
-
-### rm 命令使用规则
-- **使用 rm 命令之前必须向用户汇报具体操作命令**
-- **禁止直接执行 rm 命令**
-- 等待用户确认后才能执行
-
-### OpenClaw 配置修改规则
-- **OpenClaw.json 做任何改动之前，先汇报具体修改内容**
-- **禁止未汇报就直接修改 OpenClaw.json**
-- 等待用户确认之后才能执行
-- 用户确认可以执行，操作之前先备份 openclaw.json