Index of every page on this site: llms.txt
All skills
moizibnyousaf avatar

/update-installed-skills

@6d95c78
Run it yourself

Use when syncing or updating previously installed skills to their latest version. Always dry-run updates before applying, and check for breaking changes.

Use this Skill: https://skilld.dev/gh/moizibnyousaf/ai-agent-skills/update-installed-skills

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈45 tokens for metadata: the name and description. ≈333 when used: this file.

Description uses 2.2% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈179 characters, or 2.2%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.
npx ai-agent-skills list --installed --format json --fields name
  1. Check for available updates.
npx ai-agent-skills check
  1. Dry-run the update.
npx ai-agent-skills sync <skill-name> --dry-run
  1. Apply the update after reviewing.
npx ai-agent-skills sync <skill-name>
  1. 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 check command makes network requests to verify upstream sources. It may be slow or fail if sources are unreachable.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    This skill provides a standard workflow for updating and synchronizing AI agent skills using a command-line utility. It includes safety recommendations like using dry-run modes and reviewing changes before applying them.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: MEDIUM · 1 issue

Signed by skilld at 6d95c78. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 8 months ago
category
workflow
version
4.1.0

README badge

README badge for moizibnyousaf/ai-agent-skills/update-installed-skills