update-installed-skills — Claude Code skill: how to install
update-installed-skills syncs previously installed agent skills to their upstream versions. Helps you inspect changes safely with dry-run flags before overwriting local setups.
MIT 168 installs ★ 1,161 updated 2026-09-21
npx skills add MoizIbnYousaf/ai-agent-skills --skill update-installed-skills -a claude-codeWhat update-installed-skills does
This skill guides agents through updating dependencies via the ai-agent-skills CLI. It queries installed components with npx ai-agent-skills list --installed --format json --fields name and polls remote repositories using the check command to detect incoming revisions.
Syncing individual tools relies on npx ai-agent-skills sync <skill-name>, while --all handles batch updates. The workflow enforces running --dry-run first to spot breaking adjustments. Any manual tweaks inside local SKILL.md files get overwritten during sync, so backing up custom changes beforehand is required.
What it helps with
- inspect upstream repositories for new skill releases
- preview skill updates safely via
--dry-runbefore applying - sync agent skills from GitHub sources in batch or individually
- export installed skill names as structured JSON for logging
Example prompts for the agent
- Check upstream updates for all installed skills and run a dry-run first.
- Sync the
test-runnerskill withai-agent-skills sync <skill-name>. - Export our installed skills to JSON using
ai-agent-skills list.
How to install update-installed-skills
1Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill update-installed-skills -a claude-code2Manually: put the files in place
~/.claude/skills/update-installed-skills/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/update-installed-skills/
1Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill update-installed-skills -a codex2Manually: put the files in place
.agents/skills/update-installed-skills/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill update-installed-skills -a cursor2Manually: put the files in place
.cursor/skills/update-installed-skills/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MoizIbnYousaf/ai-agent-skills skills/update-installed-skills2Manually: put the files in place
.github/skills/update-installed-skills/SKILL.md1Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill update-installed-skills -a gemini-cli2Platform CLI
gemini skills install https://github.com/MoizIbnYousaf/ai-agent-skills --path skills/update-installed-skillsManually: put the files in place
.devin/skills/update-installed-skills/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MoizIbnYousaf/ai-agent-skills --skill update-installed-skills -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about update-installed-skills
How to install update-installed-skills in Claude Code?
Run npx skills add MoizIbnYousaf/ai-agent-skills --skill update-installed-skills -a claude-code. You can also place the skill file directly at ~/.claude/skills/update-installed-skills/SKILL.md.
What does update-installed-skills do?
It orchestrates checking, previewing, and applying upstream updates for installed agent skills via the ai-agent-skills CLI.
Will syncing overwrite custom edits in SKILL.md?
Yes, running sync overwrites manual edits in SKILL.md with upstream content. Back up local customizations before syncing.
Source text
SKILL.md · MIT
--- name: update-installed-skills description: Use when syncing or updating previously installed skills to their latest version. Always dry-run updates before applying, and check for breaking changes. category: workflow version: 4.1.0 --- # Update Installed Skills ## Goal Keep installed skills current without breaking the agent's workflow or silently overwriting local customizations. ## Guardrails - Always use `--dry-run` before 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 json` to capture structured update results for logging. ## Workflow 1. List currently installed skills. ```bash npx ai-agent-skills list --installed --format json --fields name ``` 2. Check for available updates. ```bash npx ai-agent-skills check ``` 3. Dry-run the update. ```bash npx ai-agent-skills sync <skill-name> --dry-run ``` 4. Apply the update after reviewing. ```bash npx ai-agent-skills sync <skill-name> ``` 5. For bulk updates, review each skill's dry-run output. ```bash 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 `check` command makes network requests to verify upstream sources. It may be slow or fail if sources are unreachable.
© MoizIbnYousaf · MIT · MoizIbnYousaf/ai-agent-skills