diff --git a/README.md b/README.md
new file mode 100644
index 0000000..14dd744
--- /dev/null
+++ b/README.md
@@ -0,0 +1,78 @@
+# Qwen Code Skills
+
+分享一些实用的 Qwen Code Skills，即装即用。
+
+## 包含的 Skills
+
+| Skill | 描述 |
+|-------|------|
+| **mmx** | MiniMax CLI 工具，提供文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索等 AI 功能 |
+| **skills-helper** | Skills 管理助手 — 创建、查看、更新项目级或全局 Skills，自动处理 git 提交与同步 |
+
+---
+
+## 安装方式
+
+### 方式一：安装到全局（所有项目可用）
+
+推荐将 Skills 安装到全局目录 `~/.qwen/skills/`，这样在任意项目都能使用。
+
+```bash
+# 克隆仓库到临时目录
+git clone https://gitee.com/song_kang_shuai/qwen-skills.git /tmp/qwen-skills
+
+# 复制 skills 到全局目录
+cp -r /tmp/qwen-skills/* ~/.qwen/skills/
+
+# 清理临时目录
+rm -rf /tmp/qwen-skills
+```
+
+### 方式二：安装到指定目录
+
+如果你想把 Skills 安装到其他位置，可以手动复制：
+
+```bash
+# 克隆到任意位置
+git clone https://gitee.com/song_kang_shuai/qwen-skills.git ~/my-qwen-skills
+
+# 复制单个 skill（以 mmx 为例）
+cp -r ~/my-qwen-skills/mmx ~/.qwen/skills/
+cp -r ~/my-qwen-skills/skills-helper ~/.qwen/skills/
+```
+
+### 方式三：项目级安装（仅当前项目可用）
+
+如果你只想在特定项目中使用某个 Skill，可以安装到项目目录：
+
+```bash
+# 在你的项目目录下执行
+mkdir -p .qwen/skills
+git clone https://gitee.com/song_kang_shuai/qwen-skills.git /tmp/qwen-skills
+cp -r /tmp/qwen-skills/* .qwen/skills/
+rm -rf /tmp/qwen-skills
+```
+
+---
+
+## 使用方法
+
+安装完成后，在 Qwen Code 中直接使用 `/` 触发 Skills：
+
+- `/mmx` — 使用 MiniMax AI 工具
+- `/skills-helper` — 管理你的 Skills
+
+---
+
+## 更新 Skills
+
+```bash
+cd ~/.qwen/skills
+git pull
+```
+
+---
+
+## 自定义添加
+
+参考 [skills-helper](./skills-helper/SKILL.md) 创建你自己的 Skill。