U
update-installed-skills
About update-installed-skills
A workflow skill for updating installed skills while reducing the risk of disrupting an agent's workflow or overwriting local edits. It uses installed-skill listings, update checks, and dry runs before applying individual or bulk updates.
Key features
- 01List installed skills
- 02Check for available updates
- 03Preview changes with dry runs
- 04Apply reviewed updates
- 05Preview bulk updates
Use cases
- 01Reviewing skill updates before applying them
- 02Updating selected installed skills
- 03Assessing bulk updates before execution
- 04Logging structured update results
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ moizibnyousaf/ ai-agent-skills --skill update-installed-skillsAfter installing, type/update-installed-skillsin Claude Code to confirm it loaded.
Details
From the project READMEUpdate Installed Skills
Goal
Keep installed skills current without breaking the agent's workflow or silently overwriting local customizations.
Guardrails
- Always use
--dry-runbefore running a real update. - Check what is currently installed before updating:
npx ai-agent-skills list --installed. - Never update all skills at once in production without reviewing the dry-run output.
- Use
--format jsonto capture structured update results for logging.
Workflow
- List currently installed skills.
npx ai-agent-skills list --installed --format json --fields name
- Check for available updates.
npx ai-agent-skills check
- Dry-run the update.
npx ai-agent-skills sync <skill-name> --dry-run
- Apply the update after reviewing.
npx ai-agent-skills sync <skill-name>
- For bulk updates, review each skill's dry-run output.
npx ai-agent-skills sync --all --dry-run
Gotchas
- Skills installed from GitHub will attempt a fresh clone during sync. If the upstream repo is gone, the update will fail gracefully.
- Manually edited SKILL.md files will be overwritten by sync. Back up customizations before syncing.
- The
checkcommand makes network requests to verify upstream sources. It may be slow or fail if sources are unreachable.
Comments
Markdown supported