add-skill-lazy 1.0.30

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 (4) hide show
  1. package/README.md +269 -0
  2. package/dist/index.d.ts +1 -0
  3. package/dist/index.js +2557 -0
  4. package/package.json +90 -0
package/README.md ADDED
@@ -0,0 +1,269 @@
1
+ # add-skill lazy
2
+
3
+ A fork of [add-skill](https://github.com/vercel-labs/add-skill) that install agent skills onto your coding agents from any git repository **with search feature**.
4
+
5
+ <!-- agent-list:start -->
6
+
7
+ Supports **Opencode**, **Claude Code**, **Codex**, **Cursor**, and [21 more](#available-agents).
8
+
9
+ <!-- agent-list:end -->
10
+
11
+ ## Quick Start
12
+
13
+ ```bash
14
+ npx add-skill rpfilomeno/agent-skills-lazy
15
+ ```
16
+
17
+ ## What are Agent Skills?
18
+
19
+ Agent skills are reusable instruction sets that extend your coding agent's capabilities. They're defined in `SKILL.md` files with YAML frontmatter containing a `name` and `description`.
20
+
21
+ Skills let agents perform specialized tasks like:
22
+
23
+ - Generating release notes from git history
24
+ - Creating PRs following your team's conventions
25
+ - Integrating with external tools (Linear, Notion, etc.)
26
+
27
+ ## Usage
28
+
29
+ ### Source Formats
30
+
31
+ The `<source>` argument accepts multiple formats:
32
+
33
+ ```bash
34
+ # GitHub shorthand
35
+ npx add-skill rpfilomeno/agent-skills-lazy
36
+
37
+ # Full GitHub URL
38
+ npx add-skill https://github.com/rpfilomeno/agent-skills-lazy
39
+
40
+ # Direct path to a skill in a repo
41
+ npx add-skill https://github.com/rpfilomeno/agent-skills-lazy/tree/main/skills/frontend-design
42
+
43
+ # GitLab URL
44
+ npx add-skill https://gitlab.com/org/repo
45
+
46
+ # Any git URL
47
+ npx add-skill git@github.com:rpfilomeno/agent-skills-lazy.git
48
+ ```
49
+
50
+ ### Options
51
+
52
+ | Option | Description |
53
+ | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
54
+ | `-q, --query <query>` | Search for skills across GitHub and GitLab |
55
+ | `-g, --global` | Install to user directory instead of project |
56
+ | `-a, --agent <agents...>` | <!-- agent-names:start -->Target specific agents (e.g., `claude-code`, `codex`). See [Available Agents](#available-agents)<!-- agent-names:end --> |
57
+ | `-s, --skill <skills...>` | Install specific skills by name |
58
+ | `-l, --list` | List available skills without installing |
59
+ | `-y, --yes` | Skip all confirmation prompts |
60
+ | `-V, --version` | Show version number |
61
+ | `-h, --help` | Show help |
62
+
63
+ ### Examples
64
+
65
+ ```bash
66
+ # Search for skills (e.g. "python")
67
+ npx add-skill -q "python"
68
+
69
+ # List skills in a repository
70
+ npx add-skill rpfilomeno/agent-skills-lazy --list
71
+
72
+ # Install multiple specific skills
73
+ npx add-skill rpfilomeno/agent-skills-lazy --skill frontend-design --skill skill-creator
74
+
75
+ # Install to specific agents
76
+ npx add-skill rpfilomeno/agent-skills-lazy -a claude-code -a opencode
77
+
78
+ # Non-interactive installation (CI/CD friendly)
79
+ npx add-skill rpfilomeno/agent-skills-lazy --skill frontend-design -g -a claude-code -y
80
+
81
+ # Install all skills from a repo
82
+ npx add-skill rpfilomeno/agent-skills-lazy -y -g
83
+ ```
84
+
85
+ ## Available Agents
86
+
87
+ Skills can be installed to any of these supported agents. Use `-g, --global` to install to the global path instead of project-level.
88
+
89
+ <!-- available-agents:start -->
90
+
91
+ | Agent | `--agent` | Project Path | Global Path |
92
+ | -------------- | ---------------- | ---------------------- | ------------------------------- |
93
+ | Amp | `amp` | `.agents/skills/` | `~/.config/agents/skills/` |
94
+ | Antigravity | `antigravity` | `.agent/skills/` | `~/.gemini/antigravity/skills/` |
95
+ | Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
96
+ | Clawdbot | `clawdbot` | `skills/` | `~/.clawdbot/skills/` |
97
+ | Cline | `cline` | `.cline/skills/` | `~/.cline/skills/` |
98
+ | Codex | `codex` | `.codex/skills/` | `~/.codex/skills/` |
99
+ | Command Code | `command-code` | `.commandcode/skills/` | `~/.commandcode/skills/` |
100
+ | Cursor | `cursor` | `.cursor/skills/` | `~/.cursor/skills/` |
101
+ | Droid | `droid` | `.factory/skills/` | `~/.factory/skills/` |
102
+ | Gemini CLI | `gemini-cli` | `.gemini/skills/` | `~/.gemini/skills/` |
103
+ | GitHub Copilot | `github-copilot` | `.github/skills/` | `~/.copilot/skills/` |
104
+ | Goose | `goose` | `.goose/skills/` | `~/.config/goose/skills/` |
105
+ | Kilo Code | `kilo` | `.kilocode/skills/` | `~/.kilocode/skills/` |
106
+ | Kiro CLI | `kiro-cli` | `.kiro/skills/` | `~/.kiro/skills/` |
107
+ | MCPJam | `mcpjam` | `.mcpjam/skills/` | `~/.mcpjam/skills/` |
108
+ | OpenCode | `opencode` | `.opencode/skills/` | `~/.config/opencode/skills/` |
109
+ | OpenHands | `openhands` | `.openhands/skills/` | `~/.openhands/skills/` |
110
+ | Pi | `pi` | `.pi/skills/` | `~/.pi/agent/skills/` |
111
+ | Qoder | `qoder` | `.qoder/skills/` | `~/.qoder/skills/` |
112
+ | Qwen Code | `qwen-code` | `.qwen/skills/` | `~/.qwen/skills/` |
113
+ | Roo Code | `roo` | `.roo/skills/` | `~/.roo/skills/` |
114
+ | Trae | `trae` | `.trae/skills/` | `~/.trae/skills/` |
115
+ | Windsurf | `windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
116
+ | Zencoder | `zencoder` | `.zencoder/skills/` | `~/.zencoder/skills/` |
117
+ | Neovate | `neovate` | `.neovate/skills/` | `~/.neovate/skills/` |
118
+
119
+ <!-- available-agents:end -->
120
+
121
+ > [!NOTE]
122
+ > **Kiro CLI users:** After installing skills, you need to manually add them to your custom agent's `resources` in `.kiro/agents/<agent>.json`:
123
+ >
124
+ > ```json
125
+ > {
126
+ > "resources": ["skill://.kiro/skills/**/SKILL.md"]
127
+ > }
128
+ > ```
129
+
130
+ ## Agent Detection
131
+
132
+ The CLI automatically detects which coding agents you have installed by checking for their configuration directories. If none are detected, you'll be prompted to select which agents to install to.
133
+
134
+ ## Creating Skills
135
+
136
+ Skills are directories containing a `SKILL.md` file with YAML frontmatter:
137
+
138
+ ```markdown
139
+ ---
140
+ name: my-skill
141
+ description: What this skill does and when to use it
142
+ ---
143
+
144
+ # My Skill
145
+
146
+ Instructions for the agent to follow when this skill is activated.
147
+
148
+ ## When to Use
149
+
150
+ Describe the scenarios where this skill should be used.
151
+
152
+ ## Steps
153
+
154
+ 1. First, do this
155
+ 2. Then, do that
156
+ ```
157
+
158
+ ### Required Fields
159
+
160
+ - `name`: Unique identifier (lowercase, hyphens allowed)
161
+ - `description`: Brief explanation of what the skill does
162
+
163
+ ### Skill Discovery
164
+
165
+ The CLI searches for skills in these locations within a repository:
166
+
167
+ <!-- skill-discovery:start -->
168
+
169
+ - Root directory (if it contains `SKILL.md`)
170
+ - `skills/`
171
+ - `skills/.curated/`
172
+ - `skills/.experimental/`
173
+ - `skills/.system/`
174
+ - `.agents/skills/`
175
+ - `.agent/skills/`
176
+ - `.claude/skills/`
177
+ - `./skills/`
178
+ - `.cline/skills/`
179
+ - `.codex/skills/`
180
+ - `.commandcode/skills/`
181
+ - `.cursor/skills/`
182
+ - `.factory/skills/`
183
+ - `.gemini/skills/`
184
+ - `.github/skills/`
185
+ - `.goose/skills/`
186
+ - `.kilocode/skills/`
187
+ - `.kiro/skills/`
188
+ - `.mcpjam/skills/`
189
+ - `.opencode/skills/`
190
+ - `.openhands/skills/`
191
+ - `.pi/skills/`
192
+ - `.qoder/skills/`
193
+ - `.qwen/skills/`
194
+ - `.roo/skills/`
195
+ - `.trae/skills/`
196
+ - `.windsurf/skills/`
197
+ - `.zencoder/skills/`
198
+ - `.neovate/skills/`
199
+ <!-- skill-discovery:end -->
200
+
201
+ If no skills are found in standard locations, a recursive search is performed.
202
+
203
+ ## Compatibility
204
+
205
+ Skills are generally compatible across agents since they follow a shared [Agent Skills specification](https://agentskills.io). However, some features may be agent-specific:
206
+
207
+ | Feature | OpenCode | OpenHands | Claude Code | Cline | Codex | Command Code | Kiro CLI | Cursor | Antigravity | Roo Code | Github Copilot | Amp | Clawdbot | Neovate | Pi | Qoder | Zencoder |
208
+ | --------------- | -------- | --------- | ----------- | ----- | ----- | ------------ | -------- | ------ | ----------- | -------- | -------------- | --- | -------- | ------- | --- | ----- | -------- |
209
+ | Basic skills | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
210
+ | `allowed-tools` | Yes | Yes | Yes | Yes | Yes | Yes | No | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No |
211
+ | `context: fork` | No | No | Yes | No | No | No | No | No | No | No | No | No | No | No | No | No | No |
212
+ | Hooks | No | No | Yes | Yes | No | No | No | No | No | No | No | No | No | No | No | No | No |
213
+
214
+ ## Troubleshooting
215
+
216
+ ### "No skills found"
217
+
218
+ Ensure the repository contains valid `SKILL.md` files with both `name` and `description` in the frontmatter.
219
+
220
+ ### Skill not loading in agent
221
+
222
+ - Verify the skill was installed to the correct path
223
+ - Check the agent's documentation for skill loading requirements
224
+ - Ensure the `SKILL.md` frontmatter is valid YAML
225
+
226
+ ### Permission errors
227
+
228
+ Ensure you have write access to the target directory.
229
+
230
+ ## Telemetry
231
+
232
+ This CLI collects anonymous usage data to help improve the tool. No personal information is collected.
233
+
234
+ To disable telemetry, set either of these environment variables:
235
+
236
+ ```bash
237
+ DISABLE_TELEMETRY=1 npx add-skill rpfilomeno/agent-skills-lazy
238
+ # or
239
+ DO_NOT_TRACK=1 npx add-skill rpfilomeno/agent-skills-lazy
240
+ ```
241
+
242
+ Telemetry is also automatically disabled in CI environments.
243
+
244
+ ## Related Links
245
+
246
+ - [Agent Skills Specification](https://agentskills.io)
247
+ - [Amp Skills Documentation](https://ampcode.com/manual#agent-skills)
248
+ - [Antigravity Skills Documentation](https://antigravity.google/docs/skills)
249
+ - [Claude Code Skills Documentation](https://code.claude.com/docs/en/skills)
250
+ - [Clawdbot Skills Documentation](https://docs.clawd.bot/tools/skills)
251
+ - [Cline Skills Documentation](https://docs.cline.bot/features/skills)
252
+ - [Codex Skills Documentation](https://developers.openai.com/codex/skills)
253
+ - [Command Code Skills Documentation](https://commandcode.ai/docs/skills)
254
+ - [Cursor Skills Documentation](https://cursor.com/docs/context/skills)
255
+ - [Gemini CLI Skills Documentation](https://geminicli.com/docs/cli/skills/)
256
+ - [GitHub Copilot Agent Skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)
257
+ - [Kiro CLI Skills Documentation](https://kiro.dev/docs/cli/custom-agents/configuration-reference/#skill-resources)
258
+ - [OpenCode Skills Documentation](https://opencode.ai/docs/skills)
259
+ - [Qwen Code Skills Documentation](https://qwenlm.github.io/qwen-code-docs/en/users/features/skills/)
260
+ - [OpenHands Skills Documentation](https://docs.openhands.ai/modules/usage/how-to/using-skills)
261
+ - [Pi Skills Documentation](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/skills.md)
262
+ - [Qoder Skills Documentation](https://docs.qoder.com/cli/Skills)
263
+ - [Roo Code Skills Documentation](https://docs.roocode.com/features/skills)
264
+ - [Trae Skills Documentation](https://docs.trae.ai/ide/skills)
265
+ - [Vercel Agent Skills Repository](https://github.com/rpfilomeno/agent-skills-lazy)
266
+
267
+ ## License
268
+
269
+ MIT
package/dist/index.d.ts ADDED
@@ -0,0 +1 @@
1
+ #!/usr/bin/env node