Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MoizIbnYousaf/ai-agent-skills --skill update-installed-skills -a claude-code
Open on GitHub

What 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-run before 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-runner skill with ai-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-code

2Manually: put the files in place

~/.claude/skills/update-installed-skills/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/update-installed-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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set15

The whole set →
browse-and-evaluate The browse-and-evaluate skill helps you find, compare, and inspect catalog skills before adding them. Use it when catalog output needs to stay focused. CX Codex +1 177installs review-a-skill review-a-skill reviews a skill before it enters a library by checking metadata, structure, safety, and dependencies. Use it when the choice is keep, curate, or remove. CX Codex +1 177installs build-workspace-docs build-workspace-docs keeps README.md and WORK_AREAS.md aligned with a skills catalog. Run it after catalog changes or before committing workspace updates. CX Codex +1 172installs audit-library-health audit-library-health — a skill for diagnosing a skills library: validates structure, finds stale elements, checks documentation sync. Run before publishing or updating. CX Codex +1 170installs share-a-library share-a-library — a skill that automates publishing a finished local library to GitHub and generates an install command for your teammates. CX Codex +1 161installs install-from-remote-library install-from-remote-library guides safe skill installs from shared repos. Inspects targets via --list and previews every action with a dry-run flag. CX Codex +1 161installs curate-a-team-library curate-a-team-library — a skill for Claude Code, Codex, Cursor and other agents that walks an agent through building a team skills library: mapping shelves, adding entries with curator metadata, assembling a starter pack. CX Codex +1 160installs migrate-skills-between-libraries migrate-skills-between-libraries is a Claude Code skill that moves skills between library workspaces, including when switching from a personal library to a team one. CX Codex +1 158installs

Project sponsors

Companies that keep this analytics open