diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d3867c5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,57 @@
+# QQzot
+
+QQzot 是从 QQnote 中拆分出来的 Zotero 专用 skill。它负责 Zotero 侧的文献库操作，避免 QQnote 同时承担 Zotero、Obsidian、Dataview 和笔记维护，导致职责过重。
+
+## 职责范围
+
+QQzot 负责：
+
+- 检索 Zotero 本地文献库。
+- 使用 Zotero item key、DOI、题名、作者和年份定位文献。
+- 生成 Zotero AI child notes。
+- 审计哪些 Zotero 条目缺少 AI child notes。
+- 将指定 Zotero 文献汇总为 Markdown 对比表。
+- 为 qqcites、qqsci 和 QQnote 提供 Zotero 侧的文献输入。
+
+QQzot 不负责：
+
+- Obsidian 文献笔记组织。
+- Dataview 文献看板。
+- Markdown 笔记清理。
+- 论文写作和科学逻辑判断。
+- 按句子推荐引用文献。
+
+## 与其他 QQ Skill 的分工
+
+| Skill | 职责 |
+|---|---|
+| QQzot | Zotero 文献库、item key、AI child notes、Zotero 元数据和文献表格 |
+| QQnote | Obsidian 文献笔记、Markdown 组织、Dataview 看板和 vault 维护 |
+| qqcites | 按句子或 claim 推荐引用、排序、去重和验证 |
+| qqsci | 论文写作、科学逻辑、故事线、claim-evidence 和审稿风险 |
+| qqwrite | Word 模板、排版、插图、批注和投稿文件执行 |
+
+## 常用场景
+
+- “帮我查 Zotero 里有没有这篇文献。”
+- “给这些 Zotero key 生成 AI 笔记。”
+- “审计一下哪些文献还没有 AI child note。”
+- “把这几篇 Zotero 文献整理成对比表。”
+- “先从 Zotero 找候选文献，再交给 qqcites 排引用。”
+
+## 内置脚本
+
+| 脚本 | 用途 |
+|---|---|
+| `scripts/generate_zotero_ai_note.py` | 为 Zotero 条目生成 AI child notes |
+| `scripts/audit_zotero_ai_notes.py` | 审计缺失的 Zotero AI child notes |
+| `scripts/summarize_zotero_table.py` | 将 Zotero 条目汇总为 Markdown 对比表 |
+
+## 运行前提
+
+- Zotero Desktop 已打开。
+- Zotero Local API 可访问：`http://127.0.0.1:23119`。
+- 需要写入 Zotero Web API 时，环境变量中存在 `ZOTERO_API_KEY`。
+- 需要调用 LLM 生成笔记或表格时，使用 AwesomeGPT 或 DeepSeek 相关环境配置。
+
+不要把 API key 写入 skill 文件、Obsidian 笔记、Git 提交、终端输出或聊天记录。