0oooooooo0 · webbrain-one · Jul 27, 2026
diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -0,0 +1,187 @@
+<div align="center">
+
+<img src="./assets/logo.png" alt="skillless" width="600" />
+
+**你无需了解什么是 skills。**
+
+一个 Claude Code 插件，能够自动发现并推荐能力 —— 让你可以专注于构建产品，而不是寻找工具。
+
+[한국어](./README.ko.md) · [快速入门](#getting-started) · [工作原理](#how-it-works)
+
+</div>
+
+---
+
+## 问题所在
+
+Claude Code 安装了 **883+ 个 skills**，在 marketplace 和 GitHub 上还有更多。但问题在于：你必须*知道*它们的存在才能使用它们。
+
+大多数用户从未输入过 `/skill`，因为他们根本不知道有这个功能。他们错过了针对 React、Kubernetes、Terraform 以及数百种其他工具的专业能力 —— 仅仅是因为没有人告诉他们。
+
+## 解决方案
+
+**skillless** 完全消除了知识壁垒。
+
+- **智能规划** — `/plans` 会在您开始规划之前分析您的项目并安装正确的工具。
+- **自动推荐** — 正在使用 Docker？相关的 Docker 专业工具会自动被推荐。无需输入命令。
+- **显式搜索** — 需要特定功能？`/discover kubernetes` 会一次性在所有来源中进行搜索。
+- **零术语化** — 该插件永远不会向用户提及 "skill" 或 "plugin"。它改用 "工具 (tools)"、"能力 (capabilities)" 和 "专业知识 (expertise)" 来表述。
+
+## 快速入门
+
+### 安装
+
+一条命令即可：
+
+```bash
+npx skillless
+```
+
+就这样。插件将被安装到 `~/.claude/plugins/skillless`。
+
+<details>
+<summary>另一种方案：手动安装</summary>
+
+```bash
+git clone https://github.com/0oooooooo0/skillless.git
+cc --plugin-dir /path/to/skillless
+```
+
+</details>
+
+### 使用方法
+
+#### `/plans` — 使用正确的工具进行规划
+
+这是使用 skillless 的推荐方式。它会分析您的项目，推荐工具，并进入规划模式 —— 全部在一步内完成：
+
+```
+/plans React + Supabase dashboard with auth
+```
+
+执行流程：
+1. 扫描 `package.json`、`tsconfig.json` 和其他项目文件
+2. 检测您的技术栈（React, Supabase, TypeScript 等）
+3. 在所有来源中搜索匹配的工具
+4. 显示推荐结果并让您选择安装项
+5. 在安装好工具后进入规划模式，准备开始工作
+
+```
+Detected: React, TypeScript, Supabase
+Already installed: typescript-expert
+
+Recommended:
+| # | Name                 | Source    | Description                    |
+|---|----------------------|----------|--------------------------------|
+| 1 | react-best-practices | skills.sh | React patterns and hooks      |
+| 2 | supabase-automation  | skills.sh | Supabase auth and DB patterns |
+
+Select tools to install (1,2 / skip):
+```
+
+#### 直接正常工作
+
+您不需要做任何特殊操作。当您在使用特定框架或工具，且存在相关能力时，**skillless** 会自然地给出建议：
+
+> 顺便提一下，我发现了一个 **Kubernetes 专业工具**，可以帮助进行集群设置、清单生成和故障排除。
+> 需要我为您配置吗？
+
+#### 显式搜索
+
+```
+/discover react
+/discover "ci/cd pipeline"
+/discover terraform
+```
+
+这将搜索 3 个来源并显示统一的结果表：
+
+```
+| # | Name                 | Source    | Description                          | Installed |
+|---|----------------------|----------|--------------------------------------|-----------|
+| 1 | react-patterns       | local    | Advanced React patterns and hooks    | Yes       |
+| 2 | vercel-labs/react    | skills.sh | React development patterns (12K+)   | No        |
+| 3 | anthropics/react-pro | github   | React best practices collection      | No        |
+```
+
+选择数字进行安装，或输入 `cancel` 跳过。
+
+## 工作原理
+
+**skillless** 搜索三个来源，并优先考虑您机器上已有的内容：
+
+```
+┌───────────────────────────────────────────┐
+│          /plans  /discover                │
+│           or auto-discovery               │
+└───────────────────┬───────────────────────┘
+                    │
+       ┌────────────┼────────────┐
+       ▼            ▼            ▼
+  ┌─────────┐ ┌──────────┐ ┌────────┐
+  │  Local   │ │skills.sh │ │ GitHub │
+  │ ~/.claude│ │Directory │ │Search  │
+  │ /skills/ │ │  (Web)   │ │(fallback)│
+  └─────────┘ └──────────┘ └────────┘
+       │            │            │
+       └────────────┴────────────┘
+                    │
+                    ▼
+             Unified Results
+                    │
+                    ▼
+             skill-installer
+        (confirm → install → verify)
+```
+
+1. **本地 (Local)** — 扫描 `~/.claude/skills/*/SKILL.md` 以寻找已安装的 skills
+2. **[skills.sh](https://skills.sh)** — 搜索开放的 skill 目录（通过 `npx skillsadd` 安装）
+3. **GitHub** — 当其他来源结果较少时，回退到网页搜索
+
+### 安装流程
+
+| 来源 | 安装方式 |
+|--------|----------------|
+| 已安装 | 告知您已准备好使用 |
+| skills.sh | 运行 `npx skillsadd <owner/repo>` |
+| GitHub | 引导您运行 `/plugin install <url>` 或直接下载 SKILL.md |
+
+每次安装都需要 **用户显式确认**。没有任何内容会被静默安装。
+
+## 项目结构
+
+```
+skillless/
+├── .claude-plugin/
+│   └── plugin.json              # 插件清单
+├── bin/
+│   └── cli.mjs                  # npx skillless CLI
+├── skills/
+│   ├── auto-discovery/
+│   │   └── SKILL.md             # 后台自动推荐
+│   ├── skill-search/
+│   │   └── SKILL.md             # 多源搜索引擎
+│   └── skill-installer/
+│       └── SKILL.md             # 安装处理器
+└── commands/
+    ├── discover.md              # /discover 用户命令
+    └── plans.md                 # /plans — 带自动工具设置的规划
+```
+
+## 贡献
+
+欢迎在 [github.com/0oooooooo0/skillless](https://github.com/0oooooooo0/skillless) 提交 Issue 和 PR。
+
+## 许可证
+
+MIT
+
+---
+
+<div align="center">
+
+Built by [@0oooooooo0](https://github.com/0oooooooo0)
+
+*最好的工具，就是那些你无需寻找就能触达的工具。*
+
+</div>