Initial commit

2025-11-30 08:36:46 +08:00
commit 85a7070a82
6 changed files with 733 additions and 0 deletions
--- a/commands/update-skill.md
+++ b/commands/update-skill.md
@@ -0,0 +1,161 @@
+---
+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)
+```