skills 1.3.9 → 1.4.1
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 +31 -27
- package/dist/cli.mjs +686 -90
- package/package.json +4 -2
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
The CLI for the open agent skills ecosystem.
|
|
4
4
|
|
|
5
5
|
<!-- agent-list:start -->
|
|
6
|
-
Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [
|
|
6
|
+
Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [37 more](#available-agents).
|
|
7
7
|
<!-- agent-list:end -->
|
|
8
8
|
|
|
9
9
|
## Install a Skill
|
|
@@ -42,6 +42,7 @@ npx skills add ./my-local-skills
|
|
|
42
42
|
| `-a, --agent <agents...>` | <!-- agent-names:start -->Target specific agents (e.g., `claude-code`, `codex`). See [Available Agents](#available-agents)<!-- agent-names:end --> |
|
|
43
43
|
| `-s, --skill <skills...>` | Install specific skills by name (use `'*'` for all skills) |
|
|
44
44
|
| `-l, --list` | List available skills without installing |
|
|
45
|
+
| `--copy` | Copy files instead of symlinking to agent directories |
|
|
45
46
|
| `-y, --yes` | Skip all confirmation prompts |
|
|
46
47
|
| `--all` | Install all skills to all agents without prompts |
|
|
47
48
|
|
|
@@ -91,14 +92,14 @@ When installing interactively, you can choose:
|
|
|
91
92
|
|
|
92
93
|
## Other Commands
|
|
93
94
|
|
|
94
|
-
| Command | Description
|
|
95
|
-
| ---------------------------- |
|
|
96
|
-
| `npx skills list` | List installed skills (alias: `ls`)
|
|
97
|
-
| `npx skills find [query]` | Search for skills interactively or by keyword
|
|
98
|
-
| `npx skills remove [skills]` | Remove installed skills from agents
|
|
99
|
-
| `npx skills check` | Check for available skill updates
|
|
100
|
-
| `npx skills update` | Update all installed skills to latest versions
|
|
101
|
-
| `npx skills init [name]` | Create a new SKILL.md template
|
|
95
|
+
| Command | Description |
|
|
96
|
+
| ---------------------------- | ---------------------------------------------- |
|
|
97
|
+
| `npx skills list` | List installed skills (alias: `ls`) |
|
|
98
|
+
| `npx skills find [query]` | Search for skills interactively or by keyword |
|
|
99
|
+
| `npx skills remove [skills]` | Remove installed skills from agents |
|
|
100
|
+
| `npx skills check` | Check for available skill updates |
|
|
101
|
+
| `npx skills update` | Update all installed skills to latest versions |
|
|
102
|
+
| `npx skills init [name]` | Create a new SKILL.md template |
|
|
102
103
|
|
|
103
104
|
### `skills list`
|
|
104
105
|
|
|
@@ -180,13 +181,13 @@ npx skills remove my-skill --agent '*'
|
|
|
180
181
|
npx skills rm my-skill
|
|
181
182
|
```
|
|
182
183
|
|
|
183
|
-
| Option
|
|
184
|
-
|
|
|
185
|
-
| `-g, --global`
|
|
186
|
-
| `-a, --agent`
|
|
187
|
-
| `-s, --skill`
|
|
188
|
-
| `-y, --yes`
|
|
189
|
-
| `--all`
|
|
184
|
+
| Option | Description |
|
|
185
|
+
| -------------- | ------------------------------------------------ |
|
|
186
|
+
| `-g, --global` | Remove from global scope (~/) instead of project |
|
|
187
|
+
| `-a, --agent` | Remove from specific agents (use `'*'` for all) |
|
|
188
|
+
| `-s, --skill` | Specify skills to remove (use `'*'` for all) |
|
|
189
|
+
| `-y, --yes` | Skip confirmation prompts |
|
|
190
|
+
| `--all` | Shorthand for `--skill '*' --agent '*' -y` |
|
|
190
191
|
|
|
191
192
|
## What are Agent Skills?
|
|
192
193
|
|
|
@@ -208,18 +209,19 @@ Skills can be installed to any of these agents:
|
|
|
208
209
|
<!-- supported-agents:start -->
|
|
209
210
|
| Agent | `--agent` | Project Path | Global Path |
|
|
210
211
|
|-------|-----------|--------------|-------------|
|
|
211
|
-
| Amp, Kimi Code CLI, Replit | `amp`, `kimi-cli`, `replit` | `.agents/skills/` | `~/.config/agents/skills/` |
|
|
212
|
+
| Amp, Kimi Code CLI, Replit, Universal | `amp`, `kimi-cli`, `replit`, `universal` | `.agents/skills/` | `~/.config/agents/skills/` |
|
|
212
213
|
| Antigravity | `antigravity` | `.agent/skills/` | `~/.gemini/antigravity/skills/` |
|
|
213
214
|
| Augment | `augment` | `.augment/skills/` | `~/.augment/skills/` |
|
|
214
215
|
| Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
|
|
215
|
-
| OpenClaw | `openclaw` | `skills/` | `~/.
|
|
216
|
+
| OpenClaw | `openclaw` | `skills/` | `~/.openclaw/skills/` |
|
|
216
217
|
| Cline | `cline` | `.cline/skills/` | `~/.cline/skills/` |
|
|
217
218
|
| CodeBuddy | `codebuddy` | `.codebuddy/skills/` | `~/.codebuddy/skills/` |
|
|
218
219
|
| Codex | `codex` | `.agents/skills/` | `~/.codex/skills/` |
|
|
219
220
|
| Command Code | `command-code` | `.commandcode/skills/` | `~/.commandcode/skills/` |
|
|
220
221
|
| Continue | `continue` | `.continue/skills/` | `~/.continue/skills/` |
|
|
222
|
+
| Cortex Code | `cortex` | `.cortex/skills/` | `~/.snowflake/cortex/skills/` |
|
|
221
223
|
| Crush | `crush` | `.crush/skills/` | `~/.config/crush/skills/` |
|
|
222
|
-
| Cursor | `cursor` | `.
|
|
224
|
+
| Cursor | `cursor` | `.agents/skills/` | `~/.cursor/skills/` |
|
|
223
225
|
| Droid | `droid` | `.factory/skills/` | `~/.factory/skills/` |
|
|
224
226
|
| Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.gemini/skills/` |
|
|
225
227
|
| GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.copilot/skills/` |
|
|
@@ -323,8 +325,8 @@ The CLI searches for skills in these locations within a repository:
|
|
|
323
325
|
- `.codebuddy/skills/`
|
|
324
326
|
- `.commandcode/skills/`
|
|
325
327
|
- `.continue/skills/`
|
|
328
|
+
- `.cortex/skills/`
|
|
326
329
|
- `.crush/skills/`
|
|
327
|
-
- `.cursor/skills/`
|
|
328
330
|
- `.factory/skills/`
|
|
329
331
|
- `.goose/skills/`
|
|
330
332
|
- `.junie/skills/`
|
|
@@ -356,11 +358,13 @@ If `.claude-plugin/marketplace.json` or `.claude-plugin/plugin.json` exists, ski
|
|
|
356
358
|
// .claude-plugin/marketplace.json
|
|
357
359
|
{
|
|
358
360
|
"metadata": { "pluginRoot": "./plugins" },
|
|
359
|
-
"plugins": [
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
361
|
+
"plugins": [
|
|
362
|
+
{
|
|
363
|
+
"name": "my-plugin",
|
|
364
|
+
"source": "my-plugin",
|
|
365
|
+
"skills": ["./skills/review", "./skills/test"]
|
|
366
|
+
}
|
|
367
|
+
]
|
|
364
368
|
}
|
|
365
369
|
```
|
|
366
370
|
|
|
@@ -373,7 +377,7 @@ If no skills are found in standard locations, a recursive search is performed.
|
|
|
373
377
|
Skills are generally compatible across agents since they follow a
|
|
374
378
|
shared [Agent Skills specification](https://agentskills.io). However, some features may be agent-specific:
|
|
375
379
|
|
|
376
|
-
| Feature | OpenCode | OpenHands | Claude Code | Cline | CodeBuddy | Codex | Command Code | Kiro CLI | Cursor | Antigravity | Roo Code | Github Copilot | Amp |
|
|
380
|
+
| Feature | OpenCode | OpenHands | Claude Code | Cline | CodeBuddy | Codex | Command Code | Kiro CLI | Cursor | Antigravity | Roo Code | Github Copilot | Amp | OpenClaw | Neovate | Pi | Qoder | Zencoder |
|
|
377
381
|
| --------------- | -------- | --------- | ----------- | ----- | --------- | ----- | ------------ | -------- | ------ | ----------- | -------- | -------------- | --- | -------- | ------- | --- | ----- | -------- |
|
|
378
382
|
| Basic skills | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
|
|
379
383
|
| `allowed-tools` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No |
|
|
@@ -423,7 +427,7 @@ Telemetry is automatically disabled in CI environments.
|
|
|
423
427
|
- [Antigravity Skills Documentation](https://antigravity.google/docs/skills)
|
|
424
428
|
- [Factory AI / Droid Skills Documentation](https://docs.factory.ai/cli/configuration/skills)
|
|
425
429
|
- [Claude Code Skills Documentation](https://code.claude.com/docs/en/skills)
|
|
426
|
-
- [
|
|
430
|
+
- [OpenClaw Skills Documentation](https://docs.openclaw.ai/tools/skills)
|
|
427
431
|
- [Cline Skills Documentation](https://docs.cline.bot/features/skills)
|
|
428
432
|
- [CodeBuddy Skills Documentation](https://www.codebuddy.ai/docs/ide/Features/Skills)
|
|
429
433
|
- [Codex Skills Documentation](https://developers.openai.com/codex/skills)
|