aweskill 0.1.5 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -3,15 +3,15 @@
3
3
  <h1>aweskill: One Skill Store for All Your Coding Agents</h1>
4
4
  <p><strong>Local skill orchestration CLI for AI coding agents.</strong></p>
5
5
  <p>
6
- <a href="https://github.com/mugpeng/aweskill/releases"><img src="https://img.shields.io/badge/version-0.1.5-7C3AED?style=flat-square" alt="Version"></a>
6
+ <a href="https://github.com/mugpeng/aweskill/releases"><img src="https://img.shields.io/badge/version-0.1.7-7C3AED?style=flat-square" alt="Version"></a>
7
7
  <a href="https://github.com/mugpeng/aweskill"><img src="https://img.shields.io/badge/node-%E2%89%A520-0EA5E9?style=flat-square" alt="Node"></a>
8
8
  <a href="https://github.com/mugpeng/aweskill/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-22C55E?style=flat-square" alt="License"></a>
9
9
  <a href="./README.zh-CN.md"><img src="https://img.shields.io/badge/README-%E4%B8%AD%E6%96%87-64748B?style=flat-square" alt="Chinese README"></a>
10
10
  </p>
11
11
  <p>
12
12
  <img src="https://img.shields.io/badge/status-beta-c96a3d?style=flat-square" alt="Status">
13
- <img src="https://img.shields.io/badge/agents-10_supported-0ea5a4?style=flat-square" alt="Supported agents">
14
- <img src="https://img.shields.io/badge/projection-symlink%20%7C%20copy-1f2328?style=flat-square" alt="Projection modes">
13
+ <img src="https://img.shields.io/badge/agents-47_supported-0ea5a4?style=flat-square" alt="Supported agents">
14
+ <img src="https://img.shields.io/badge/projection-symlink-1f2328?style=flat-square" alt="Projection mode">
15
15
  <img src="https://img.shields.io/badge/platform-local%20CLI-334155?style=flat-square" alt="Local CLI">
16
16
  </p>
17
17
  </div>
@@ -28,6 +28,49 @@ Instead of copying the same skill folders into every tool by hand, `aweskill` ke
28
28
  - **Managed enable/disable model** without a separate global activation file
29
29
  - **Backup, restore, dedupe, and recovery** built into the CLI
30
30
 
31
+ ## Install
32
+
33
+ ### Install from npm (recommended)
34
+
35
+ Requires [Node.js](https://nodejs.org/) 20 or later.
36
+
37
+ ```bash
38
+ npm install -g aweskill
39
+ aweskill --help
40
+ ```
41
+
42
+ To pin a specific release:
43
+
44
+ ```bash
45
+ npm install -g aweskill@0.1.7
46
+ ```
47
+
48
+ Package page: [npmjs.com/package/aweskill](https://www.npmjs.com/package/aweskill)
49
+
50
+ ### Install from this repository
51
+
52
+ ```bash
53
+ npm install
54
+ npm run build
55
+ npm install -g .
56
+ ```
57
+
58
+ ### Local development link
59
+
60
+ ```bash
61
+ npm install
62
+ npm link
63
+ aweskill --help
64
+ ```
65
+
66
+ ### Install from packed tarball
67
+
68
+ ```bash
69
+ npm install
70
+ npm pack
71
+ npm install -g ./aweskill-0.1.7.tgz
72
+ ```
73
+
31
74
  ## Quick Start
32
75
 
33
76
  ```bash
@@ -62,7 +105,7 @@ aweskill agent list
62
105
 
63
106
  That projection is the activation model.
64
107
 
65
- - If a managed symlink or copy exists, the skill is enabled
108
+ - If a managed symlink exists, the skill is enabled
66
109
  - If it does not exist, the skill is disabled
67
110
  - There is no separate global activation registry to reconcile
68
111
 
@@ -70,7 +113,7 @@ That projection is the activation model.
70
113
 
71
114
  Supported agents currently include:
72
115
 
73
- `amp`, `claude-code`, `cline`, `codex`, `cursor`, `gemini-cli`, `goose`, `opencode`, `roo`, `windsurf`
116
+ `adal`, `amp`, `antigravity`, `augment`, `bob`, `claude-code`, `cline`, `codebuddy`, `command-code`, `continue`, `codex`, `copilot`, `cortex`, `crush`, `cursor`, `deepagents`, `droid`, `firebender`, `gemini-cli`, `github-copilot`, `goose`, `iflow-cli`, `junie`, `kilo`, `kilo-code`, `kimi-cli`, `kiro-cli`, `kode`, `mcpjam`, `mistral-vibe`, `mux`, `neovate`, `openclaw`, `openclaude-ide`, `openhands`, `opencode`, `pi`, `pochi`, `qoder`, `qwen-code`, `replit`, `roo`, `trae`, `trae-cn`, `warp`, `windsurf`, `zencoder`
74
117
 
75
118
  Key directories:
76
119
 
@@ -78,6 +121,7 @@ Key directories:
78
121
  - Duplicate holding area: `~/.aweskill/dup_skills/`
79
122
  - Backup archive: `~/.aweskill/backup/`
80
123
  - Bundles: `~/.aweskill/bundles/*.yaml`
124
+ - Repo resources: `resources/bundle_templates/` and `resources/skill_archives/`
81
125
 
82
126
  ## Common Workflows
83
127
 
@@ -108,45 +152,21 @@ aweskill agent add bundle backend --global --agent all
108
152
  ### Keep the store clean
109
153
 
110
154
  ```bash
111
- aweskill store backup
155
+ aweskill store backup --both
112
156
  aweskill agent sync
113
157
  aweskill agent recover --global --agent codex
114
158
  aweskill doctor dedupe --fix
115
159
  ```
116
160
 
117
- ## Install
118
-
119
- ### Install from this repository
120
-
121
- ```bash
122
- npm install
123
- npm run build
124
- npm install -g .
125
- ```
126
-
127
- ### Local development link
128
-
129
- ```bash
130
- npm install
131
- npm link
132
- aweskill --help
133
- ```
134
-
135
- ### Install from packed tarball
136
-
137
- ```bash
138
- npm install
139
- npm pack
140
- npm install -g ./aweskill-0.1.5.tgz
141
- ```
161
+ By default, `store backup` and `store restore` only operate on `skills/`. Add `--both` to include `bundles/`, and pass an optional archive path to `store backup` if you want to export to a specific location.
142
162
 
143
163
  ## Command Surface
144
164
 
145
165
  | Command | Description |
146
166
  | --- | --- |
147
167
  | `aweskill store init [--scan] [--verbose]` | Create the `~/.aweskill` layout |
148
- | `aweskill store backup` | Archive the central skill store |
149
- | `aweskill store restore <archive> [--override]` | Restore a previous backup |
168
+ | `aweskill store backup [archive] [--both]` | Archive the central skill store, optionally to a specific path |
169
+ | `aweskill store restore <archive> [--override] [--both]` | Restore a previous backup |
150
170
  | `aweskill skill scan [--verbose]` | Scan supported agent skill directories |
151
171
  | `aweskill skill import <path> [--mode cp\|mv] [--override]` | Import a skill or an entire skills root |
152
172
  | `aweskill skill import --scan [--mode cp\|mv] [--override]` | Import the current scan results |
@@ -179,7 +199,7 @@ npm install -g ./aweskill-0.1.5.tgz
179
199
 
180
200
  ### Managed-only removal
181
201
 
182
- `aweskill` removes only entries it can identify as its own managed symlinks or managed copies. It does not blindly delete arbitrary skill directories.
202
+ `aweskill` removes only entries it can identify as its own managed symlinks. It does not blindly delete arbitrary skill directories.
183
203
 
184
204
  ## Bundle File Format
185
205
 
@@ -195,9 +215,7 @@ skills:
195
215
  ## Projection Model
196
216
 
197
217
  1. **Central source of truth for skill content**: `~/.aweskill/skills/<skill-name>/`.
198
- 2. **`agent add`** creates, for each selected agent and scope:
199
- - a **symlink** to that directory (most agents), or
200
- - a **recursive copy** with a small marker file (for example Cursor).
218
+ 2. **`agent add`** creates, for each selected agent and supported scope, a **symlink** to that directory.
201
219
  3. **`agent remove`** removes only entries that are **managed by aweskill**.
202
220
  4. **`agent sync`** removes managed projections whose central skill path is missing.
203
221
 
@@ -234,24 +252,74 @@ aweskill agent remove bundle backend --global --agent codex
234
252
  aweskill agent recover --global --agent codex
235
253
  ```
236
254
 
237
- ## Templates
255
+ ## Templates And Archives
256
+
257
+ Reference bundle templates now live in [resources/bundle_templates/K-Dense-AI-scientific-skills.yaml](/Users/peng/Desktop/Project/aweskills/resources/bundle_templates/K-Dense-AI-scientific-skills.yaml). Runtime bundles still live under `~/.aweskill/bundles/`.
258
+
259
+ `resources/skill_archives/` is reserved for repository-level `tar.gz` backups that you want to keep in-tree and share with other users. `aweskill` does not generate or restore these archives automatically.
238
260
 
239
- Reference bundle templates live in [template/bundles/K-Dense-AI-scientific-skills.yaml](/Users/peng/Desktop/Project/aweskills/template/bundles/K-Dense-AI-scientific-skills.yaml). Runtime bundles still live under `~/.aweskill/bundles/`.
261
+ For a shareable archive collection maintained outside this repository, see [oh-my-skills](https://github.com/mugpeng/oh-my-skills), a separate backup repository for skill bundles and full-snapshot archives.
240
262
 
241
263
  ## Supported Agents
242
264
 
243
- | Agent | Global Path | Project Path | Mode |
244
- | --- | --- | --- | --- |
245
- | `amp` | `~/.amp/skills/` | `<project>/.amp/skills/` | `symlink` |
246
- | `claude-code` | `~/.claude/skills/` | `<project>/.claude/skills/` | `symlink` |
247
- | `cline` | `~/.cline/skills/` | `<project>/.cline/skills/` | `symlink` |
248
- | `codex` | `~/.codex/skills/` | `<project>/.codex/skills/` | `symlink` |
249
- | `cursor` | `~/.cursor/skills/` | `<project>/.cursor/skills/` | `copy` |
250
- | `gemini-cli` | `~/.gemini/skills/` | `<project>/.gemini/skills/` | `symlink` |
251
- | `goose` | `~/.goose/skills/` | `<project>/.goose/skills/` | `symlink` |
252
- | `opencode` | `~/.opencode/skills/` | `<project>/.opencode/skills/` | `symlink` |
253
- | `roo` | `~/.roo/skills/` | `<project>/.roo/skills/` | `symlink` |
254
- | `windsurf` | `~/.windsurf/skills/` | `<project>/.windsurf/skills/` | `symlink` |
265
+ Works with 47 agents including:
266
+
267
+ **Claude Code** · **Cursor** · **Windsurf** · **Codex** · **GitHub Copilot** · **Gemini CLI** · **OpenCode** · **Goose** · **Amp** · **Roo Code** · **Kiro CLI** · **Kilo Code** · **Trae** · **Cline** · **Antigravity** · **Droid** · **Augment** · **OpenClaw** · **CodeBuddy** · **Command Code** · **Crush** · **Kode** · **Mistral Vibe** · **Mux** · **OpenClaude IDE** · **OpenHands** · **Qoder** · **Qwen Code** · **Replit** · **Trae CN** · **Neovate** · **AdaL**
268
+
269
+ <details>
270
+ <summary>All supported agents</summary>
271
+
272
+ | Agent | Global Path | Project Path |
273
+ | --- | --- | --- |
274
+ | `adal` | `~/.adal/skills/` | `<project>/.adal/skills/` |
275
+ | `amp` | `~/.agents/skills/` | `<project>/.agents/skills/` |
276
+ | `antigravity` | `~/.gemini/antigravity/skills/` | `<project>/.gemini/antigravity/skills/` |
277
+ | `augment` | `~/.augment/skills/` | `<project>/.augment/skills/` |
278
+ | `bob` | `~/.bob/skills/` | `<project>/.bob/skills/` |
279
+ | `claude-code` | `~/.claude/skills/` | `<project>/.claude/skills/` |
280
+ | `cline` | `~/.cline/skills/` | `<project>/.cline/skills/` |
281
+ | `codebuddy` | `~/.codebuddy/skills/` | `<project>/.codebuddy/skills/` |
282
+ | `command-code` | `~/.commandcode/skills/` | `<project>/.commandcode/skills/` |
283
+ | `continue` | `~/.continue/skills/` | `<project>/.continue/skills/` |
284
+ | `codex` | `~/.codex/skills/` | `<project>/.codex/skills/` |
285
+ | `copilot` | `~/.copilot/skills/` | `<project>/.copilot/skills/` |
286
+ | `cortex` | `~/.snowflake/cortex/skills/` | `<project>/.cortex/skills/` |
287
+ | `crush` | `~/.config/crush/skills/` | `<project>/.config/crush/skills/` |
288
+ | `cursor` | `~/.cursor/skills/` | `<project>/.cursor/skills/` |
289
+ | `deepagents` | `~/.deepagents/agent/skills/` | `<project>/.deepagents/agent/skills/` |
290
+ | `droid` | `~/.factory/skills/` | `<project>/.factory/skills/` |
291
+ | `firebender` | `~/.firebender/skills/` | `<project>/.firebender/skills/` |
292
+ | `gemini-cli` | `~/.gemini/skills/` | `<project>/.gemini/skills/` |
293
+ | `github-copilot` | `~/.copilot/skills/` | `<project>/.copilot/skills/` |
294
+ | `goose` | `~/.goose/skills/` | `<project>/.goose/skills/` |
295
+ | `iflow-cli` | `~/.iflow/skills/` | `<project>/.iflow/skills/` |
296
+ | `junie` | `~/.junie/skills/` | `<project>/.junie/skills/` |
297
+ | `kilo` | `~/.kilocode/skills/` | `<project>/.kilocode/skills/` |
298
+ | `kiro-cli` | `~/.kiro/skills/` | `<project>/.kiro/skills/` |
299
+ | `kilo-code` | `~/.kilocode/skills/` | `<project>/.kilocode/skills/` |
300
+ | `kimi-cli` | `~/.kimi/skills/` | `<project>/.kimi/skills/` |
301
+ | `kode` | `~/.kode/skills/` | `<project>/.kode/skills/` |
302
+ | `mcpjam` | `~/.mcpjam/skills/` | `<project>/.mcpjam/skills/` |
303
+ | `mistral-vibe` | `~/.vibe/skills/` | `<project>/.vibe/skills/` |
304
+ | `mux` | `~/.mux/skills/` | `<project>/.mux/skills/` |
305
+ | `neovate` | `~/.neovate/skills/` | `<project>/.neovate/skills/` |
306
+ | `openclaw` | `~/.openclaw/skills/` | `<project>/.openclaw/skills/` |
307
+ | `openclaude-ide` | `~/.openclaude/skills/` | `<project>/.openclaude/skills/` |
308
+ | `openhands` | `~/.openhands/skills/` | `<project>/.openhands/skills/` |
309
+ | `opencode` | `~/.opencode/skills/` | `<project>/.opencode/skills/` |
310
+ | `pi` | `~/.pi/agent/skills/` | `<project>/.pi/agent/skills/` |
311
+ | `pochi` | `~/.pochi/skills/` | `<project>/.pochi/skills/` |
312
+ | `qoder` | `~/.qoder/skills/` | `<project>/.qoder/skills/` |
313
+ | `qwen-code` | `~/.qwen/skills/` | `<project>/.qwen/skills/` |
314
+ | `replit` | `-` | `<project>/.agent/skills/` |
315
+ | `roo` | `~/.roo/skills/` | `<project>/.roo/skills/` |
316
+ | `trae` | `~/.trae/skills/` | `<project>/.trae/skills/` |
317
+ | `trae-cn` | `~/.trae-cn/skills/` | `<project>/.trae-cn/skills/` |
318
+ | `warp` | `~/.warp/skills/` | `<project>/.warp/skills/` |
319
+ | `windsurf` | `~/.codeium/windsurf/skills/` | `<project>/.codeium/windsurf/skills/` |
320
+ | `zencoder` | `~/.zencoder/skills/` | `<project>/.zencoder/skills/` |
321
+
322
+ </details>
255
323
 
256
324
  ## Related Tools
257
325
 
package/README.zh-CN.md CHANGED
@@ -3,15 +3,15 @@
3
3
  <h1>aweskill:为所有编码代理准备的一套 Skill 中央仓库</h1>
4
4
  <p><strong>面向 AI 编码代理的本地 Skill 编排命令行工具。</strong></p>
5
5
  <p>
6
- <a href="https://github.com/mugpeng/aweskill/releases"><img src="https://img.shields.io/badge/version-0.1.5-7C3AED?style=flat-square" alt="Version"></a>
6
+ <a href="https://github.com/mugpeng/aweskill/releases"><img src="https://img.shields.io/badge/version-0.1.7-7C3AED?style=flat-square" alt="Version"></a>
7
7
  <a href="https://github.com/mugpeng/aweskill"><img src="https://img.shields.io/badge/node-%E2%89%A520-0EA5E9?style=flat-square" alt="Node"></a>
8
8
  <a href="https://github.com/mugpeng/aweskill/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-22C55E?style=flat-square" alt="License"></a>
9
9
  <a href="./README.md"><img src="https://img.shields.io/badge/README-English-64748B?style=flat-square" alt="English README"></a>
10
10
  </p>
11
11
  <p>
12
12
  <img src="https://img.shields.io/badge/status-beta-c96a3d?style=flat-square" alt="Status">
13
- <img src="https://img.shields.io/badge/agents-10_supported-0ea5a4?style=flat-square" alt="Supported agents">
14
- <img src="https://img.shields.io/badge/projection-symlink%20%7C%20copy-1f2328?style=flat-square" alt="Projection modes">
13
+ <img src="https://img.shields.io/badge/agents-47_supported-0ea5a4?style=flat-square" alt="Supported agents">
14
+ <img src="https://img.shields.io/badge/projection-symlink-1f2328?style=flat-square" alt="Projection mode">
15
15
  <img src="https://img.shields.io/badge/platform-local%20CLI-334155?style=flat-square" alt="Local CLI">
16
16
  </p>
17
17
  </div>
@@ -28,6 +28,49 @@
28
28
  - **托管启用/停用模型**:不依赖额外的全局 activation 文件
29
29
  - **自带维护能力**:备份、恢复、查重、recover、sync 都在 CLI 内部
30
30
 
31
+ ## 安装
32
+
33
+ ### 从 npm 安装(推荐)
34
+
35
+ 需要 [Node.js](https://nodejs.org/) 20 及以上。
36
+
37
+ ```bash
38
+ npm install -g aweskill
39
+ aweskill --help
40
+ ```
41
+
42
+ 固定到某一版本:
43
+
44
+ ```bash
45
+ npm install -g aweskill@0.1.7
46
+ ```
47
+
48
+ 包主页:[npmjs.com/package/aweskill](https://www.npmjs.com/package/aweskill)
49
+
50
+ ### 直接从当前仓库安装
51
+
52
+ ```bash
53
+ npm install
54
+ npm run build
55
+ npm install -g .
56
+ ```
57
+
58
+ ### 本地开发模式
59
+
60
+ ```bash
61
+ npm install
62
+ npm link
63
+ aweskill --help
64
+ ```
65
+
66
+ ### 用打包产物安装
67
+
68
+ ```bash
69
+ npm install
70
+ npm pack
71
+ npm install -g ./aweskill-0.1.7.tgz
72
+ ```
73
+
31
74
  ## 快速开始
32
75
 
33
76
  ```bash
@@ -62,7 +105,7 @@ aweskill agent list
62
105
 
63
106
  投影状态就是启用状态:
64
107
 
65
- - 有托管的 symlink 或 copy,就表示启用
108
+ - 有托管的 symlink,就表示启用
66
109
  - 没有,就表示停用
67
110
  - 不存在额外的全局 activation 注册表
68
111
 
@@ -70,7 +113,7 @@ aweskill agent list
70
113
 
71
114
  当前支持的 agent:
72
115
 
73
- `amp`、`claude-code`、`cline`、`codex`、`cursor`、`gemini-cli`、`goose`、`opencode`、`roo`、`windsurf`
116
+ `adal`、`amp`、`antigravity`、`augment`、`bob`、`claude-code`、`cline`、`codebuddy`、`command-code`、`continue`、`codex`、`copilot`、`cortex`、`crush`、`cursor`、`deepagents`、`droid`、`firebender`、`gemini-cli`、`github-copilot`、`goose`、`iflow-cli`、`junie`、`kilo`、`kilo-code`、`kimi-cli`、`kiro-cli`、`kode`、`mcpjam`、`mistral-vibe`、`mux`、`neovate`、`openclaw`、`openclaude-ide`、`openhands`、`opencode`、`pi`、`pochi`、`qoder`、`qwen-code`、`replit`、`roo`、`trae`、`trae-cn`、`warp`、`windsurf`、`zencoder`
74
117
 
75
118
  关键目录:
76
119
 
@@ -78,6 +121,7 @@ aweskill agent list
78
121
  - 重复项暂存区:`~/.aweskill/dup_skills/`
79
122
  - 备份目录:`~/.aweskill/backup/`
80
123
  - Bundle 文件:`~/.aweskill/bundles/*.yaml`
124
+ - 仓库资源目录:`resources/bundle_templates/` 和 `resources/skill_archives/`
81
125
 
82
126
  ## 常见工作流
83
127
 
@@ -108,45 +152,21 @@ aweskill agent add bundle backend --global --agent all
108
152
  ### 维护本地仓库
109
153
 
110
154
  ```bash
111
- aweskill store backup
155
+ aweskill store backup --both
112
156
  aweskill agent sync
113
157
  aweskill agent recover --global --agent codex
114
158
  aweskill doctor dedupe --fix
115
159
  ```
116
160
 
117
- ## 安装
118
-
119
- ### 直接从当前仓库安装
120
-
121
- ```bash
122
- npm install
123
- npm run build
124
- npm install -g .
125
- ```
126
-
127
- ### 本地开发模式
128
-
129
- ```bash
130
- npm install
131
- npm link
132
- aweskill --help
133
- ```
134
-
135
- ### 用打包产物安装
136
-
137
- ```bash
138
- npm install
139
- npm pack
140
- npm install -g ./aweskill-0.1.5.tgz
141
- ```
161
+ 默认情况下,`store backup` 和 `store restore` 只处理 `skills/`。加上 `--both` 会同时处理 `bundles/`;如果想导出到指定位置,也可以给 `store backup` 传一个可选的 archive 路径。
142
162
 
143
163
  ## 命令面
144
164
 
145
165
  | 命令 | 说明 |
146
166
  | --- | --- |
147
167
  | `aweskill store init [--scan] [--verbose]` | 初始化 `~/.aweskill` 布局 |
148
- | `aweskill store backup` | 归档中央 skill 仓库 |
149
- | `aweskill store restore <archive> [--override]` | 从备份恢复 |
168
+ | `aweskill store backup [archive] [--both]` | 归档中央 skill 仓库,也可导出到指定路径 |
169
+ | `aweskill store restore <archive> [--override] [--both]` | 从备份恢复 |
150
170
  | `aweskill skill scan [--verbose]` | 扫描支持的 agent skill 目录 |
151
171
  | `aweskill skill import <path> [--mode cp\|mv] [--override]` | 导入单个 skill 或整个 skills 根目录 |
152
172
  | `aweskill skill import --scan [--mode cp\|mv] [--override]` | 导入当前扫描结果 |
@@ -179,7 +199,7 @@ npm install -g ./aweskill-0.1.5.tgz
179
199
 
180
200
  ### 只删除托管项
181
201
 
182
- `aweskill` 只删除它能够明确识别为自己创建的 symlink 或托管 copy,不会盲删任意 skill 目录。
202
+ `aweskill` 只删除它能够明确识别为自己创建的托管 symlink,不会盲删任意 skill 目录。
183
203
 
184
204
  ## Bundle 文件格式
185
205
 
@@ -195,9 +215,7 @@ skills:
195
215
  ## 投影模型
196
216
 
197
217
  1. **Skill 内容的唯一事实来源**:`~/.aweskill/skills/<skill-name>/`
198
- 2. **`agent add`** 会在指定 agent scope 下创建:
199
- - 指向中央仓库的 **symlink**
200
- - 或带标记的 **递归 copy**(例如 Cursor)
218
+ 2. **`agent add`** 会在指定 agent 和支持的 scope 下创建一个指向中央仓库的 **symlink**
201
219
  3. **`agent remove`** 只会删除能识别为 `aweskill` 托管的条目
202
220
  4. **`agent sync`** 会移除中央 skill 已不存在时留下的失效托管投影
203
221
 
@@ -234,6 +252,14 @@ aweskill agent remove bundle backend --global --agent codex
234
252
  aweskill agent recover --global --agent codex
235
253
  ```
236
254
 
255
+ ## 模板与归档
256
+
257
+ 内置 bundle 模板现在位于 [resources/bundle_templates/K-Dense-AI-scientific-skills.yaml](/Users/peng/Desktop/Project/aweskills/resources/bundle_templates/K-Dense-AI-scientific-skills.yaml)。运行时 bundle 仍然位于 `~/.aweskill/bundles/`。
258
+
259
+ `resources/skill_archives/` 预留给你手动维护的整仓库 `tar.gz` 归档,用于随仓库分发给其他用户。`aweskill` 不会自动生成或恢复这些归档。
260
+
261
+ 如果你希望使用一个独立于本仓库、可直接分享给其他用户的技能归档集合,可以参考 [oh-my-skills](https://github.com/mugpeng/oh-my-skills)。它是一个单独维护的备份仓库,用来存放可分发的 bundle 和整库快照归档。
262
+
237
263
  ## 相关工具
238
264
 
239
265
  如果你在关注更广的 skills 生态,下面这些项目都值得使用和研究:
@@ -252,18 +278,64 @@ aweskill agent recover --global --agent codex
252
278
 
253
279
  ## 支持的 Agent
254
280
 
255
- | Agent | 全局路径 | 项目路径 | 投影方式 |
256
- | --- | --- | --- | --- |
257
- | `amp` | `~/.amp/skills/` | `<project>/.amp/skills/` | `symlink` |
258
- | `claude-code` | `~/.claude/skills/` | `<project>/.claude/skills/` | `symlink` |
259
- | `cline` | `~/.cline/skills/` | `<project>/.cline/skills/` | `symlink` |
260
- | `codex` | `~/.codex/skills/` | `<project>/.codex/skills/` | `symlink` |
261
- | `cursor` | `~/.cursor/skills/` | `<project>/.cursor/skills/` | `copy` |
262
- | `gemini-cli` | `~/.gemini/skills/` | `<project>/.gemini/skills/` | `symlink` |
263
- | `goose` | `~/.goose/skills/` | `<project>/.goose/skills/` | `symlink` |
264
- | `opencode` | `~/.opencode/skills/` | `<project>/.opencode/skills/` | `symlink` |
265
- | `roo` | `~/.roo/skills/` | `<project>/.roo/skills/` | `symlink` |
266
- | `windsurf` | `~/.windsurf/skills/` | `<project>/.windsurf/skills/` | `symlink` |
281
+ 支持 47 agent,包括:
282
+
283
+ **Claude Code** · **Cursor** · **Windsurf** · **Codex** · **GitHub Copilot** · **Gemini CLI** · **OpenCode** · **Goose** · **Amp** · **Roo Code** · **Kiro CLI** · **Kilo Code** · **Trae** · **Cline** · **Antigravity** · **Droid** · **Augment** · **OpenClaw** · **CodeBuddy** · **Command Code** · **Crush** · **Kode** · **Mistral Vibe** · **Mux** · **OpenClaude IDE** · **OpenHands** · **Qoder** · **Qwen Code** · **Replit** · **Trae CN** · **Neovate** · **AdaL**
284
+
285
+ <details>
286
+ <summary>所有支持的 agent</summary>
287
+
288
+ | Agent | 全局路径 | 项目路径 |
289
+ | --- | --- | --- |
290
+ | `adal` | `~/.adal/skills/` | `<project>/.adal/skills/` |
291
+ | `amp` | `~/.agents/skills/` | `<project>/.agents/skills/` |
292
+ | `antigravity` | `~/.gemini/antigravity/skills/` | `<project>/.gemini/antigravity/skills/` |
293
+ | `augment` | `~/.augment/skills/` | `<project>/.augment/skills/` |
294
+ | `bob` | `~/.bob/skills/` | `<project>/.bob/skills/` |
295
+ | `claude-code` | `~/.claude/skills/` | `<project>/.claude/skills/` |
296
+ | `cline` | `~/.cline/skills/` | `<project>/.cline/skills/` |
297
+ | `codebuddy` | `~/.codebuddy/skills/` | `<project>/.codebuddy/skills/` |
298
+ | `command-code` | `~/.commandcode/skills/` | `<project>/.commandcode/skills/` |
299
+ | `continue` | `~/.continue/skills/` | `<project>/.continue/skills/` |
300
+ | `codex` | `~/.codex/skills/` | `<project>/.codex/skills/` |
301
+ | `copilot` | `~/.copilot/skills/` | `<project>/.copilot/skills/` |
302
+ | `cortex` | `~/.snowflake/cortex/skills/` | `<project>/.cortex/skills/` |
303
+ | `crush` | `~/.config/crush/skills/` | `<project>/.config/crush/skills/` |
304
+ | `cursor` | `~/.cursor/skills/` | `<project>/.cursor/skills/` |
305
+ | `deepagents` | `~/.deepagents/agent/skills/` | `<project>/.deepagents/agent/skills/` |
306
+ | `droid` | `~/.factory/skills/` | `<project>/.factory/skills/` |
307
+ | `firebender` | `~/.firebender/skills/` | `<project>/.firebender/skills/` |
308
+ | `gemini-cli` | `~/.gemini/skills/` | `<project>/.gemini/skills/` |
309
+ | `github-copilot` | `~/.copilot/skills/` | `<project>/.copilot/skills/` |
310
+ | `goose` | `~/.goose/skills/` | `<project>/.goose/skills/` |
311
+ | `iflow-cli` | `~/.iflow/skills/` | `<project>/.iflow/skills/` |
312
+ | `junie` | `~/.junie/skills/` | `<project>/.junie/skills/` |
313
+ | `kilo` | `~/.kilocode/skills/` | `<project>/.kilocode/skills/` |
314
+ | `kiro-cli` | `~/.kiro/skills/` | `<project>/.kiro/skills/` |
315
+ | `kilo-code` | `~/.kilocode/skills/` | `<project>/.kilocode/skills/` |
316
+ | `kimi-cli` | `~/.kimi/skills/` | `<project>/.kimi/skills/` |
317
+ | `kode` | `~/.kode/skills/` | `<project>/.kode/skills/` |
318
+ | `mcpjam` | `~/.mcpjam/skills/` | `<project>/.mcpjam/skills/` |
319
+ | `mistral-vibe` | `~/.vibe/skills/` | `<project>/.vibe/skills/` |
320
+ | `mux` | `~/.mux/skills/` | `<project>/.mux/skills/` |
321
+ | `neovate` | `~/.neovate/skills/` | `<project>/.neovate/skills/` |
322
+ | `openclaw` | `~/.openclaw/skills/` | `<project>/.openclaw/skills/` |
323
+ | `openclaude-ide` | `~/.openclaude/skills/` | `<project>/.openclaude/skills/` |
324
+ | `openhands` | `~/.openhands/skills/` | `<project>/.openhands/skills/` |
325
+ | `opencode` | `~/.opencode/skills/` | `<project>/.opencode/skills/` |
326
+ | `pi` | `~/.pi/agent/skills/` | `<project>/.pi/agent/skills/` |
327
+ | `pochi` | `~/.pochi/skills/` | `<project>/.pochi/skills/` |
328
+ | `qoder` | `~/.qoder/skills/` | `<project>/.qoder/skills/` |
329
+ | `qwen-code` | `~/.qwen/skills/` | `<project>/.qwen/skills/` |
330
+ | `replit` | `-` | `<project>/.agent/skills/` |
331
+ | `roo` | `~/.roo/skills/` | `<project>/.roo/skills/` |
332
+ | `trae` | `~/.trae/skills/` | `<project>/.trae/skills/` |
333
+ | `trae-cn` | `~/.trae-cn/skills/` | `<project>/.trae-cn/skills/` |
334
+ | `warp` | `~/.warp/skills/` | `<project>/.warp/skills/` |
335
+ | `windsurf` | `~/.codeium/windsurf/skills/` | `<project>/.codeium/windsurf/skills/` |
336
+ | `zencoder` | `~/.zencoder/skills/` | `<project>/.zencoder/skills/` |
337
+
338
+ </details>
267
339
 
268
340
  ## 开发
269
341