Skip to content

Commit 21b2a25

Browse files
committed
Update changelog
1 parent f139d13 commit 21b2a25

File tree

2 files changed

+183
-0
lines changed

2 files changed

+183
-0
lines changed

CHANGELOG.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [0.9.0] - 2026-01-28
9+
10+
### Added
11+
12+
- **Skill Update Command** - New `ai-devkit skill update` command for updating skills from registries
13+
- **Update All Skills**: `ai-devkit skill update` - Updates all cached skill registries via git pull
14+
- **Update Specific Registry**: `ai-devkit skill update <registry-id>` - Updates only the specified registry (e.g., `ai-devkit skill update anthropic/skills`)
15+
- **Features**:
16+
- Continues updating on errors and reports summary at the end
17+
- Skips non-git directories gracefully with informative logging
18+
- Shows real-time progress for each registry being updated
19+
- Displays color-coded summary (✓ updated, ⊘ skipped, ✗ failed)
20+
- Provides helpful error tips for common issues (uncommitted changes, network errors)
21+
- Validates git repository status before attempting updates
22+
- 30-second timeout per registry to prevent hanging
23+
- **New Git Utilities**:
24+
- `isGitRepository()` - Checks if a directory is a git repository
25+
- `pullRepository()` - Pulls latest changes with timeout protection
26+
827
## [0.8.1] - 2026-01-26
928

1029
### Added

web/content/docs/7-skills.md

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -180,6 +180,113 @@ Note: Cached copy in ~/.ai-devkit/skills/ preserved for other projects.
180180

181181
The cached copy remains in `~/.ai-devkit/skills/` so you can quickly reinstall it in other projects without re-downloading.
182182

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+
183290
## Skill Registry
184291

185292
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
292399
### "SKILL.md not found"
293400

294401
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:
452+
453+
```bash
454+
cd ~/.ai-devkit/skills/<registry-id>
455+
git init
456+
git remote add origin <git-url>
457+
git pull origin main
458+
```

0 commit comments

Comments
 (0)