162 lines
3.5 KiB
Markdown
162 lines
3.5 KiB
Markdown
---
|
|
name: update-skill
|
|
description: Update locally installed skills from their GitHub repositories
|
|
arguments:
|
|
- name: target
|
|
description: "Repository name to update, or --all to update all repos"
|
|
required: false
|
|
---
|
|
|
|
# Update Locally Installed Skills
|
|
|
|
You are updating Claude Code skills that were installed via `/install-skill`.
|
|
|
|
## Parse the Input
|
|
|
|
Parse the target argument: `$ARGUMENTS.target`
|
|
|
|
- If empty or not provided: List installed skills and ask which to update
|
|
- If `--all`: Update all updateable skills
|
|
- Otherwise: Update the specified skill or repo
|
|
|
|
## Update Process
|
|
|
|
### Step 1: Read registry
|
|
|
|
Read `.claude/local-plugins.yaml`.
|
|
|
|
**Migration check:** If `.claude/local-plugins.json` exists but `.yaml` doesn't, run migration first.
|
|
|
|
If no registry found:
|
|
```
|
|
No locally installed skills found.
|
|
|
|
Use /install-skill to install skills from GitHub.
|
|
```
|
|
|
|
### Step 2: Identify what to update
|
|
|
|
**If `--all`:**
|
|
- Get all skills from registry
|
|
- Group by mode for appropriate update method
|
|
|
|
**If specific target:**
|
|
- Check if it's a skill name in `skills` section
|
|
- Check if it's a repo name in `submodules` section
|
|
- If not found, list available options
|
|
|
|
**If no target:**
|
|
- List all skills with their mode and source
|
|
- Ask user which to update
|
|
|
|
### Step 3: Update based on mode
|
|
|
|
#### For submodule-based skills:
|
|
|
|
Update the entire submodule (updates all skills from that repo):
|
|
|
|
Capture old and new SHA:
|
|
```bash
|
|
# BEFORE fetch/pull
|
|
OLD_SHA=$(git -C .claude/submodules/<repo> rev-parse HEAD)
|
|
|
|
# Fetch and pull
|
|
git -C .claude/submodules/<repo> fetch origin
|
|
git -C .claude/submodules/<repo> pull origin <branch>
|
|
|
|
# AFTER pull
|
|
NEW_SHA=$(git -C .claude/submodules/<repo> rev-parse HEAD)
|
|
```
|
|
|
|
Update all skills from this repo in registry with new `commitSha`.
|
|
|
|
#### For copy-based skills:
|
|
|
|
Re-download and overwrite:
|
|
|
|
```bash
|
|
TEMP_DIR=$(mktemp -d)
|
|
git clone --depth=1 --branch <branch> https://github.com/<owner>/<repo>.git "$TEMP_DIR"
|
|
NEW_SHA=$(git -C "$TEMP_DIR" rev-parse HEAD)
|
|
```
|
|
|
|
Compare with stored `commitSha`. If same:
|
|
```
|
|
Skill "<name>" is already up to date (sha: <sha>)
|
|
```
|
|
|
|
If different:
|
|
```bash
|
|
rm -rf ".claude/skills/<skill-name>"
|
|
cp -r "$TEMP_DIR/<skillPath>" ".claude/skills/<skill-name>"
|
|
rm -rf "$TEMP_DIR"
|
|
```
|
|
|
|
Update `commitSha` in registry.
|
|
|
|
### Step 4: Verify integrity
|
|
|
|
**For submodule skills:**
|
|
- Check symlinks still point to valid targets
|
|
- If skill was removed from upstream repo, warn user
|
|
|
|
**For copy skills:**
|
|
- Verify files were copied successfully
|
|
|
|
### Step 5: Update registry
|
|
|
|
Write updated `.claude/local-plugins.yaml` with new `commitSha` values.
|
|
|
|
### Step 6: Report results
|
|
|
|
**No changes:**
|
|
```
|
|
Updating <skill-name>...
|
|
└── Already up to date (sha: abc123)
|
|
```
|
|
|
|
**Updated (submodule):**
|
|
```
|
|
Updating submodule <repo>...
|
|
├── Previous: abc123
|
|
├── Updated to: def456
|
|
├── Skills updated: brainstorming, tdd
|
|
└── Symlinks verified: OK
|
|
|
|
Skills updated successfully.
|
|
```
|
|
|
|
**Updated (copy):**
|
|
```
|
|
Updating skill <name>...
|
|
├── Previous: abc123
|
|
├── Updated to: def456
|
|
├── Files replaced in: .claude/skills/<name>
|
|
└── Status: Updated successfully
|
|
```
|
|
|
|
## Error Handling
|
|
|
|
**Submodule directory missing:**
|
|
```
|
|
Error: Submodule not found: .claude/submodules/<repo>
|
|
|
|
Run `git submodule update --init` or reinstall with /install-skill.
|
|
```
|
|
|
|
**Network error:**
|
|
```
|
|
Error: Failed to fetch updates
|
|
|
|
Check your network connection and try again.
|
|
```
|
|
|
|
**Skill not in registry:**
|
|
```
|
|
Error: Skill "<name>" not found in registry.
|
|
|
|
Installed skills:
|
|
- skill-a (copy mode)
|
|
- skill-b (submodule mode)
|
|
```
|