You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: web/content/docs/7-skills.md
+164Lines changed: 164 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -180,6 +180,113 @@ Note: Cached copy in ~/.ai-devkit/skills/ preserved for other projects.
180
180
181
181
The cached copy remains in `~/.ai-devkit/skills/` so you can quickly reinstall it in other projects without re-downloading.
182
182
183
+
### `ai-devkit skill update`
184
+
185
+
Update skills from registries to get the latest changes.
186
+
187
+
**Syntax:**
188
+
189
+
```bash
190
+
# Update all cached skill registries
191
+
ai-devkit skill update
192
+
193
+
# Update a specific registry
194
+
ai-devkit skill update <registry-id>
195
+
```
196
+
197
+
**Parameters:**
198
+
199
+
-`<registry-id>` (optional): The registry identifier to update (e.g., `anthropics/skills`)
200
+
201
+
**Examples:**
202
+
203
+
```bash
204
+
# Update all registries
205
+
ai-devkit skill update
206
+
207
+
# Update only the anthropics/skills registry
208
+
ai-devkit skill update anthropics/skills
209
+
```
210
+
211
+
**How It Works:**
212
+
213
+
The update command pulls the latest changes from skill registries using `git pull`. It:
214
+
215
+
1. Scans the cache directory (`~/.ai-devkit/skills/`) for installed registries
216
+
2. Checks if each directory is a git repository
217
+
3. Runs `git pull` to fetch the latest changes
218
+
4. Continues updating even if some registries fail
219
+
5. Reports a summary of results
220
+
221
+
**Example Output (Update All):**
222
+
223
+
```
224
+
Updating all skills...
225
+
226
+
→ anthropics/skills...
227
+
✓ Updated
228
+
229
+
→ vercel-labs/agent-skills...
230
+
✓ Updated
231
+
232
+
→ my-org/custom-skills...
233
+
⊘ Skipped (Not a git repository)
234
+
235
+
236
+
Summary:
237
+
✓ 2 updated
238
+
⊘ 1 skipped
239
+
```
240
+
241
+
**Example Output (Update Specific Registry):**
242
+
243
+
```
244
+
Updating registry: anthropics/skills...
245
+
246
+
→ anthropics/skills...
247
+
✓ Updated
248
+
249
+
250
+
Summary:
251
+
✓ 1 updated
252
+
```
253
+
254
+
**Example Output (With Errors):**
255
+
256
+
```
257
+
Updating all skills...
258
+
259
+
→ anthropics/skills...
260
+
✗ Failed
261
+
262
+
→ vercel-labs/agent-skills...
263
+
✓ Updated
264
+
265
+
266
+
Summary:
267
+
✓ 1 updated
268
+
✗ 1 failed
269
+
270
+
271
+
Errors:
272
+
• anthropics/skills: Git pull failed: You have unstaged changes
273
+
Tip: Run 'git status' in ~/.ai-devkit/skills/anthropics/skills to see details.
274
+
```
275
+
276
+
**When to Update:**
277
+
278
+
-**After installing skills**: Get the latest improvements and bug fixes
279
+
-**Periodically**: Keep skills up-to-date with community contributions
280
+
-**Before starting new projects**: Ensure you're using the latest patterns
281
+
282
+
**Notes:**
283
+
284
+
- Updates only affect the cached registries in `~/.ai-devkit/skills/`
285
+
- Since skills are symlinked, updates are immediately available in all projects using those skills
286
+
- Non-git directories are skipped (e.g., manually created folders)
287
+
- The command continues even if some registries fail to update
288
+
- A 30-second timeout prevents hanging on network issues
289
+
183
290
## Skill Registry
184
291
185
292
AI DevKit uses a centralized registry file to map registry identifiers to their GitHub repositories. The registry is hosted at:
@@ -292,3 +399,60 @@ Your project doesn't have any skill-compatible environments. Run `ai-devkit init
292
399
### "SKILL.md not found"
293
400
294
401
The skill folder exists but doesn't contain a `SKILL.md` file, meaning it's not a valid skill. Contact the registry maintainer.
402
+
403
+
### Update Errors
404
+
405
+
#### "You have unstaged changes" or "uncommitted changes"
406
+
407
+
The registry has local modifications that prevent git pull. To fix:
408
+
409
+
```bash
410
+
# Navigate to the registry
411
+
cd~/.ai-devkit/skills/<registry-id>
412
+
413
+
# Check what changed
414
+
git status
415
+
416
+
# Option 1: Discard local changes
417
+
git reset --hard HEAD
418
+
419
+
# Option 2: Stash changes and update
420
+
git stash
421
+
git pull
422
+
git stash pop
423
+
424
+
# Then retry the update
425
+
ai-devkit skill update <registry-id>
426
+
```
427
+
428
+
#### "Registry not found in cache"
429
+
430
+
You're trying to update a registry that hasn't been installed yet. Install a skill from that registry first:
431
+
432
+
```bash
433
+
ai-devkit skill add <registry-id><skill-name>
434
+
```
435
+
436
+
#### Network or timeout errors
437
+
438
+
If updates fail due to network issues:
439
+
440
+
1. Check your internet connection
441
+
2. Try updating a specific registry instead of all at once
442
+
3. Increase timeout by manually pulling:
443
+
444
+
```bash
445
+
cd~/.ai-devkit/skills/<registry-id>
446
+
git pull
447
+
```
448
+
449
+
#### "Not a git repository" (skipped)
450
+
451
+
This is normal for manually created directories in the skills cache. The update command will skip these automatically. If you want to convert a manual directory to use git:
0 commit comments