skills 1.5.8 → 1.5.10

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.
Files changed (3) hide show
  1. package/README.md +89 -59
  2. package/dist/cli.mjs +893 -156
  3. package/package.json +18 -2
package/README.md CHANGED
@@ -3,9 +3,7 @@
3
3
  The CLI for the open agent skills ecosystem.
4
4
 
5
5
  <!-- agent-list:start -->
6
-
7
- Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [51 more](#supported-agents).
8
-
6
+ Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [67 more](#supported-agents).
9
7
  <!-- agent-list:end -->
10
8
 
11
9
  [![skills.sh](https://skills.sh/b/vercel-labs/skills)](https://skills.sh/vercel-labs/skills)
@@ -16,6 +14,17 @@ Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [51 more](#su
16
14
  npx skills add vercel-labs/agent-skills
17
15
  ```
18
16
 
17
+ ## Use a Skill Without Installing
18
+
19
+ Generate a prompt for one skill, or start a supported coding agent interactively:
20
+
21
+ ```bash
22
+ npx skills use vercel-labs/agent-skills@nextjs | claude
23
+ npx skills use vercel-labs/agent-skills --skill nextjs --agent claude-code
24
+ ```
25
+
26
+ `skills use` resolves sources the same way as `skills add`, writes the selected skill files to a temporary directory, and prints only the generated prompt to stdout unless `--agent` is provided. With `--agent`, it starts one supported agent interactively with the generated prompt.
27
+
19
28
  ### Source Formats
20
29
 
21
30
  ```bash
@@ -98,6 +107,7 @@ When installing interactively, you can choose:
98
107
 
99
108
  | Command | Description |
100
109
  | ---------------------------- | --------------------------------------------- |
110
+ | `npx skills use <source>` | Use one skill without installing |
101
111
  | `npx skills list` | List installed skills (alias: `ls`) |
102
112
  | `npx skills find [query]` | Search for skills interactively or by keyword |
103
113
  | `npx skills remove [skills]` | Remove installed skills from agents |
@@ -227,60 +237,71 @@ Discover skills at **[skills.sh](https://skills.sh)**
227
237
  Skills can be installed to any of these agents:
228
238
 
229
239
  <!-- supported-agents:start -->
230
-
231
- | Agent | `--agent` | Project Path | Global Path |
232
- | ------------------------------------- | ---------------------------------------- | ------------------------ | ------------------------------- |
233
- | AiderDesk | `aider-desk` | `.aider-desk/skills/` | `~/.aider-desk/skills/` |
234
- | Amp, Kimi Code CLI, Replit, Universal | `amp`, `kimi-cli`, `replit`, `universal` | `.agents/skills/` | `~/.config/agents/skills/` |
235
- | Antigravity | `antigravity` | `.agents/skills/` | `~/.gemini/antigravity/skills/` |
236
- | Augment | `augment` | `.augment/skills/` | `~/.augment/skills/` |
237
- | IBM Bob | `bob` | `.bob/skills/` | `~/.bob/skills/` |
238
- | Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
239
- | OpenClaw | `openclaw` | `skills/` | `~/.openclaw/skills/` |
240
- | Cline, Dexto, Warp | `cline`, `dexto`, `warp` | `.agents/skills/` | `~/.agents/skills/` |
241
- | CodeArts Agent | `codearts-agent` | `.codeartsdoer/skills/` | `~/.codeartsdoer/skills/` |
242
- | CodeBuddy | `codebuddy` | `.codebuddy/skills/` | `~/.codebuddy/skills/` |
243
- | Codemaker | `codemaker` | `.codemaker/skills/` | `~/.codemaker/skills/` |
244
- | Code Studio | `codestudio` | `.codestudio/skills/` | `~/.codestudio/skills/` |
245
- | Codex | `codex` | `.agents/skills/` | `~/.codex/skills/` |
246
- | Command Code | `command-code` | `.commandcode/skills/` | `~/.commandcode/skills/` |
247
- | Continue | `continue` | `.continue/skills/` | `~/.continue/skills/` |
248
- | Cortex Code | `cortex` | `.cortex/skills/` | `~/.snowflake/cortex/skills/` |
249
- | Crush | `crush` | `.crush/skills/` | `~/.config/crush/skills/` |
250
- | Cursor | `cursor` | `.agents/skills/` | `~/.cursor/skills/` |
251
- | Deep Agents | `deepagents` | `.agents/skills/` | `~/.deepagents/agent/skills/` |
252
- | Devin for Terminal | `devin` | `.devin/skills/` | `~/.config/devin/skills/` |
253
- | Droid | `droid` | `.factory/skills/` | `~/.factory/skills/` |
254
- | Firebender | `firebender` | `.agents/skills/` | `~/.firebender/skills/` |
255
- | ForgeCode | `forgecode` | `.forge/skills/` | `~/.forge/skills/` |
256
- | Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.gemini/skills/` |
257
- | GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.copilot/skills/` |
258
- | Goose | `goose` | `.goose/skills/` | `~/.config/goose/skills/` |
259
- | Hermes Agent | `hermes-agent` | `.hermes/skills/` | `~/.hermes/skills/` |
260
- | Junie | `junie` | `.junie/skills/` | `~/.junie/skills/` |
261
- | iFlow CLI | `iflow-cli` | `.iflow/skills/` | `~/.iflow/skills/` |
262
- | Kilo Code | `kilo` | `.kilocode/skills/` | `~/.kilocode/skills/` |
263
- | Kiro CLI | `kiro-cli` | `.kiro/skills/` | `~/.kiro/skills/` |
264
- | Kode | `kode` | `.kode/skills/` | `~/.kode/skills/` |
265
- | MCPJam | `mcpjam` | `.mcpjam/skills/` | `~/.mcpjam/skills/` |
266
- | Mistral Vibe | `mistral-vibe` | `.vibe/skills/` | `~/.vibe/skills/` |
267
- | Mux | `mux` | `.mux/skills/` | `~/.mux/skills/` |
268
- | OpenCode | `opencode` | `.agents/skills/` | `~/.config/opencode/skills/` |
269
- | OpenHands | `openhands` | `.openhands/skills/` | `~/.openhands/skills/` |
270
- | Pi | `pi` | `.pi/skills/` | `~/.pi/agent/skills/` |
271
- | Qoder | `qoder` | `.qoder/skills/` | `~/.qoder/skills/` |
272
- | Qwen Code | `qwen-code` | `.qwen/skills/` | `~/.qwen/skills/` |
273
- | Rovo Dev | `rovodev` | `.rovodev/skills/` | `~/.rovodev/skills/` |
274
- | Roo Code | `roo` | `.roo/skills/` | `~/.roo/skills/` |
275
- | Tabnine CLI | `tabnine-cli` | `.tabnine/agent/skills/` | `~/.tabnine/agent/skills/` |
276
- | Trae | `trae` | `.trae/skills/` | `~/.trae/skills/` |
277
- | Trae CN | `trae-cn` | `.trae/skills/` | `~/.trae-cn/skills/` |
278
- | Windsurf | `windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
279
- | Zencoder | `zencoder` | `.zencoder/skills/` | `~/.zencoder/skills/` |
280
- | Neovate | `neovate` | `.neovate/skills/` | `~/.neovate/skills/` |
281
- | Pochi | `pochi` | `.pochi/skills/` | `~/.pochi/skills/` |
282
- | AdaL | `adal` | `.adal/skills/` | `~/.adal/skills/` |
283
-
240
+ | Agent | `--agent` | Project Path | Global Path |
241
+ |-------|-----------|--------------|-------------|
242
+ | AiderDesk | `aider-desk` | `.aider-desk/skills/` | `~/.aider-desk/skills/` |
243
+ | Amp, Replit, Universal | `amp`, `replit`, `universal` | `.agents/skills/` | `~/.config/agents/skills/` |
244
+ | Antigravity | `antigravity` | `.agents/skills/` | `~/.gemini/antigravity/skills/` |
245
+ | Antigravity CLI | `antigravity-cli` | `.agents/skills/` | `~/.gemini/antigravity-cli/skills/` |
246
+ | AstrBot | `astrbot` | `data/skills/` | `~/.astrbot/data/skills/` |
247
+ | Autohand Code CLI | `autohand-code` | `.autohand/skills/` | `~/.autohand/skills/` |
248
+ | Augment | `augment` | `.augment/skills/` | `~/.augment/skills/` |
249
+ | IBM Bob | `bob` | `.bob/skills/` | `~/.bob/skills/` |
250
+ | Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
251
+ | OpenClaw | `openclaw` | `skills/` | `~/.openclaw/skills/` |
252
+ | Cline, Dexto, Kimi Code CLI, Loaf, Warp, Zed | `cline`, `dexto`, `kimi-code-cli`, `loaf`, `warp`, `zed` | `.agents/skills/` | `~/.agents/skills/` |
253
+ | CodeArts Agent | `codearts-agent` | `.codeartsdoer/skills/` | `~/.codeartsdoer/skills/` |
254
+ | CodeBuddy | `codebuddy` | `.codebuddy/skills/` | `~/.codebuddy/skills/` |
255
+ | Codemaker | `codemaker` | `.codemaker/skills/` | `~/.codemaker/skills/` |
256
+ | Code Studio | `codestudio` | `.codestudio/skills/` | `~/.codestudio/skills/` |
257
+ | Codex | `codex` | `.agents/skills/` | `~/.codex/skills/` |
258
+ | Command Code | `command-code` | `.commandcode/skills/` | `~/.commandcode/skills/` |
259
+ | Continue | `continue` | `.continue/skills/` | `~/.continue/skills/` |
260
+ | Cortex Code | `cortex` | `.cortex/skills/` | `~/.snowflake/cortex/skills/` |
261
+ | Crush | `crush` | `.crush/skills/` | `~/.config/crush/skills/` |
262
+ | Cursor | `cursor` | `.agents/skills/` | `~/.cursor/skills/` |
263
+ | Deep Agents | `deepagents` | `.agents/skills/` | `~/.deepagents/agent/skills/` |
264
+ | Devin for Terminal | `devin` | `.devin/skills/` | `~/.config/devin/skills/` |
265
+ | Droid | `droid` | `.factory/skills/` | `~/.factory/skills/` |
266
+ | Firebender | `firebender` | `.agents/skills/` | `~/.firebender/skills/` |
267
+ | ForgeCode | `forgecode` | `.forge/skills/` | `~/.forge/skills/` |
268
+ | Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.gemini/skills/` |
269
+ | GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.copilot/skills/` |
270
+ | Goose | `goose` | `.goose/skills/` | `~/.config/goose/skills/` |
271
+ | Hermes Agent | `hermes-agent` | `.hermes/skills/` | `~/.hermes/skills/` |
272
+ | inference.sh | `inference-sh` | `.inferencesh/skills/` | `~/.inferencesh/skills/` |
273
+ | Jazz | `jazz` | `.jazz/skills/` | `~/.jazz/skills/` |
274
+ | Junie | `junie` | `.junie/skills/` | `~/.junie/skills/` |
275
+ | iFlow CLI | `iflow-cli` | `.iflow/skills/` | `~/.iflow/skills/` |
276
+ | Kilo Code | `kilo` | `.kilocode/skills/` | `~/.kilocode/skills/` |
277
+ | Kiro CLI | `kiro-cli` | `.kiro/skills/` | `~/.kiro/skills/` |
278
+ | Kode | `kode` | `.kode/skills/` | `~/.kode/skills/` |
279
+ | Lingma | `lingma` | `.lingma/skills/` | `~/.lingma/skills/` |
280
+ | MCPJam | `mcpjam` | `.mcpjam/skills/` | `~/.mcpjam/skills/` |
281
+ | Mistral Vibe | `mistral-vibe` | `.vibe/skills/` | `~/.vibe/skills/` |
282
+ | Moxby | `moxby` | `.moxby/skills/` | `~/.moxby/skills/` |
283
+ | Mux | `mux` | `.mux/skills/` | `~/.mux/skills/` |
284
+ | OpenCode | `opencode` | `.agents/skills/` | `~/.config/opencode/skills/` |
285
+ | OpenHands | `openhands` | `.openhands/skills/` | `~/.openhands/skills/` |
286
+ | Ona | `ona` | `.ona/skills/` | `~/.ona/skills/` |
287
+ | Pi | `pi` | `.pi/skills/` | `~/.pi/agent/skills/` |
288
+ | Qoder | `qoder` | `.qoder/skills/` | `~/.qoder/skills/` |
289
+ | Qoder CN | `qoder-cn` | `.qoder/skills/` | `~/.qoder-cn/skills/` |
290
+ | Qwen Code | `qwen-code` | `.qwen/skills/` | `~/.qwen/skills/` |
291
+ | Reasonix | `reasonix` | `.reasonix/skills/` | `~/.reasonix/skills/` |
292
+ | Rovo Dev | `rovodev` | `.rovodev/skills/` | `~/.rovodev/skills/` |
293
+ | Roo Code | `roo` | `.roo/skills/` | `~/.roo/skills/` |
294
+ | Tabnine CLI | `tabnine-cli` | `.tabnine/agent/skills/` | `~/.tabnine/agent/skills/` |
295
+ | Terramind | `terramind` | `.terramind/skills/` | `~/.terramind/skills/` |
296
+ | Tinycloud | `tinycloud` | `.tinycloud/skills/` | `~/.tinycloud/skills/` |
297
+ | Trae | `trae` | `.trae/skills/` | `~/.trae/skills/` |
298
+ | Trae CN | `trae-cn` | `.trae/skills/` | `~/.trae-cn/skills/` |
299
+ | Windsurf | `windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
300
+ | Zencoder, Zenflow | `zencoder`, `zenflow` | `.zencoder/skills/` | `~/.zencoder/skills/` |
301
+ | Neovate | `neovate` | `.neovate/skills/` | `~/.neovate/skills/` |
302
+ | Pochi | `pochi` | `.pochi/skills/` | `~/.pochi/skills/` |
303
+ | PromptScript | `promptscript` | `.agents/skills/` | N/A (project-only) |
304
+ | AdaL | `adal` | `.adal/skills/` | `~/.adal/skills/` |
284
305
  <!-- supported-agents:end -->
285
306
 
286
307
  > [!NOTE]
@@ -351,7 +372,6 @@ to also discover `SKILL.md` files outside these container directories
351
372
  (e.g. under `examples/` or `tests/`).
352
373
 
353
374
  <!-- skill-discovery:start -->
354
-
355
375
  - Root directory (if it contains `SKILL.md`)
356
376
  - `skills/`
357
377
  - `skills/.curated/`
@@ -359,6 +379,8 @@ to also discover `SKILL.md` files outside these container directories
359
379
  - `skills/.system/`
360
380
  - `.aider-desk/skills/`
361
381
  - `.agents/skills/`
382
+ - `data/skills/`
383
+ - `.autohand/skills/`
362
384
  - `.augment/skills/`
363
385
  - `.bob/skills/`
364
386
  - `.claude/skills/`
@@ -375,21 +397,29 @@ to also discover `SKILL.md` files outside these container directories
375
397
  - `.forge/skills/`
376
398
  - `.goose/skills/`
377
399
  - `.hermes/skills/`
400
+ - `.inferencesh/skills/`
401
+ - `.jazz/skills/`
378
402
  - `.junie/skills/`
379
403
  - `.iflow/skills/`
380
404
  - `.kilocode/skills/`
381
405
  - `.kiro/skills/`
382
406
  - `.kode/skills/`
407
+ - `.lingma/skills/`
383
408
  - `.mcpjam/skills/`
384
409
  - `.vibe/skills/`
410
+ - `.moxby/skills/`
385
411
  - `.mux/skills/`
386
412
  - `.openhands/skills/`
413
+ - `.ona/skills/`
387
414
  - `.pi/skills/`
388
415
  - `.qoder/skills/`
389
416
  - `.qwen/skills/`
417
+ - `.reasonix/skills/`
390
418
  - `.rovodev/skills/`
391
419
  - `.roo/skills/`
392
420
  - `.tabnine/agent/skills/`
421
+ - `.terramind/skills/`
422
+ - `.tinycloud/skills/`
393
423
  - `.trae/skills/`
394
424
  - `.windsurf/skills/`
395
425
  - `.zencoder/skills/`
@@ -486,7 +516,7 @@ Telemetry is automatically disabled in CI environments.
486
516
  - [Gemini CLI Skills Documentation](https://geminicli.com/docs/cli/skills/)
487
517
  - [GitHub Copilot Agent Skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)
488
518
  - [iFlow CLI Skills Documentation](https://platform.iflow.cn/en/cli/examples/skill)
489
- - [Kimi Code CLI Skills Documentation](https://moonshotai.github.io/kimi-cli/en/customization/skills.html)
519
+ - [Kimi Code CLI Skills Documentation](https://moonshotai.github.io/kimi-code/en/customization/skills)
490
520
  - [Kiro CLI Skills Documentation](https://kiro.dev/docs/cli/custom-agents/configuration-reference/#skill-resources)
491
521
  - [Kode Skills Documentation](https://github.com/shareAI-lab/kode/blob/main/docs/skills.md)
492
522
  - [OpenCode Skills Documentation](https://opencode.ai/docs/skills)