Skip to content

Commit 3ccafac

Browse files
committed
Update skill docs
1 parent 0f8a4f0 commit 3ccafac

File tree

1 file changed

+6
-92
lines changed

1 file changed

+6
-92
lines changed

web/content/docs/7-skills.md

Lines changed: 6 additions & 92 deletions
Original file line numberDiff line numberDiff line change
@@ -105,23 +105,6 @@ This command will:
105105
3. Verify the skill exists and contains a valid `SKILL.md`
106106
4. Symlink the skill into your project's skill directories
107107

108-
**Output:**
109-
110-
```
111-
Validating skill: frontend-design from anthropics/skills
112-
Fetching registry from GitHub...
113-
Checking local cache...
114-
→ Cloning anthropics/skills (this may take a moment)...
115-
Loading project configuration...
116-
Installing skill to project...
117-
→ .cursor/skills/frontend-design (symlinked)
118-
→ .claude/skills/frontend-design (symlinked)
119-
120-
Successfully installed: frontend-design
121-
Source: anthropics/skills
122-
Installed to: cursor, claude
123-
```
124-
125108
### `ai-devkit skill list`
126109

127110
List all skills installed in your project.
@@ -142,7 +125,7 @@ Installed Skills:
142125
frontend-design anthropics/skills cursor, claude
143126
api-patterns vercel-labs/agent-skills cursor, claude
144127
145-
Total: 2 skill(s)
128+
Total: 2 skill(s)
146129
```
147130

148131
The list shows:
@@ -167,17 +150,6 @@ ai-devkit skill remove <skill-name>
167150
ai-devkit skill remove frontend-design
168151
```
169152

170-
**Output:**
171-
172-
```
173-
Removing skill: frontend-design
174-
→ Removed from .cursor/skills
175-
→ Removed from .claude/skills
176-
177-
Successfully removed from 2 location(s).
178-
Note: Cached copy in ~/.ai-devkit/skills/ preserved for other projects.
179-
```
180-
181153
The cached copy remains in `~/.ai-devkit/skills/` so you can quickly reinstall it in other projects without re-downloading.
182154

183155
### `ai-devkit skill update`
@@ -218,61 +190,6 @@ The update command pulls the latest changes from skill registries using `git pul
218190
4. Continues updating even if some registries fail
219191
5. Reports a summary of results
220192

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-
276193
**When to Update:**
277194

278195
- **After installing skills**: Get the latest improvements and bug fixes
@@ -285,7 +202,6 @@ Errors:
285202
- Since skills are symlinked, updates are immediately available in all projects using those skills
286203
- Non-git directories are skipped (e.g., manually created folders)
287204
- The command continues even if some registries fail to update
288-
- A 30-second timeout prevents hanging on network issues
289205

290206
## Skill Registry
291207

@@ -400,9 +316,7 @@ Your project doesn't have any skill-compatible environments. Run `ai-devkit init
400316

401317
The skill folder exists but doesn't contain a `SKILL.md` file, meaning it's not a valid skill. Contact the registry maintainer.
402318

403-
### Update Errors
404-
405-
#### "You have unstaged changes" or "uncommitted changes"
319+
### "You have unstaged changes" or "uncommitted changes"
406320

407321
The registry has local modifications that prevent git pull. To fix:
408322

@@ -425,15 +339,15 @@ git stash pop
425339
ai-devkit skill update <registry-id>
426340
```
427341

428-
#### "Registry not found in cache"
342+
### "Registry not found in cache"
429343

430344
You're trying to update a registry that hasn't been installed yet. Install a skill from that registry first:
431345

432346
```bash
433347
ai-devkit skill add <registry-id> <skill-name>
434348
```
435349

436-
#### Network or timeout errors
350+
### Network or timeout errors
437351

438352
If updates fail due to network issues:
439353

@@ -446,7 +360,7 @@ cd ~/.ai-devkit/skills/<registry-id>
446360
git pull
447361
```
448362

449-
#### "Not a git repository" (skipped)
363+
### "Not a git repository" (skipped)
450364

451365
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:
452366

@@ -455,4 +369,4 @@ cd ~/.ai-devkit/skills/<registry-id>
455369
git init
456370
git remote add origin <git-url>
457371
git pull origin main
458-
```
372+
```

0 commit comments

Comments
 (0)