diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..3574257
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,45 @@
+# CLAUDE.md
+
+本仓库为 Claude Code Skills 集合，托管于 Gitea（git.geyoyo.top/glj/claude-code-skills.git），为 Claude Code + DeepSeek v4 提供技能扩展。
+
+## 仓库约定
+
+- 文档和提交信息使用**简体中文**
+- 技能目录命名使用 **kebab-case**（如 `code-review`、`spring-boot`）
+- 保持扁平结构，不按领域分层
+
+## 技能开发规范
+
+### 目录结构
+
+```
+skills/<skill-name>/
+└── SKILL.md
+```
+
+### SKILL.md 格式
+
+```markdown
+---
+name: <kebab-case-name>
+description: <一句话描述>
+---
+
+# <技能名称>
+
+<技能内容>
+```
+
+- `name` 需与目录名一致
+- `description` 用简体中文，一句话说明技能用途
+
+### 添加技能流程
+
+1. 在 `skills/` 下创建技能目录和 `SKILL.md`
+2. 更新 `skills/README.md` 的技能列表
+3. 提交并推送到远程
+
+## 提交规范
+
+- 提交信息用简体中文，格式：`<动词>: <简要描述>`，如 `添加 xxx 技能`
+- 每次提交聚焦一个变更