# AI Agent Skills Update > Update skills installed FROM THE AI-Agent-skills GitHub REPO (github.com/whobat/AI-Agent-skills) to their latest published versions — it does not touch skills from any other source (plugins, other repos, hand-written skills). Runs the repo installer in update mode across Claude Code, Codex, and OpenCode, installs nothing new, and preserves local config.json files. Use when the user says "update my AI-Agent-skills", "update my skills from the repo", "opdater skills", "are my skills up to date?", or after being told a skill from this repo has a new version. - Skill: `whobat/ai-agent-skills-update` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add whobat/ai-agent-skills-update` - Raw SKILL.md: https://api.skillmd.com/api/skills/whobat/ai-agent-skills-update/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - License: MIT - Author: whobat (https://skillmd.com/u/whobat) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/whobat/ai-agent-skills-update --- # AI-Agent-skills Update Updates every skill **originating from the [AI-Agent-skills repo](https://github.com/whobat/AI-Agent-skills)** that is installed on this machine to the latest published version. Skills from other sources (plugins, other repos, hand-written skills) are never touched — the installer only considers folders whose name matches a skill in this repo. Installs **nothing new** — only refreshes what is already there. A `config.json` inside a skill folder is preserved. ## How to run **Primary (no clone needed — fetches the latest repo automatically):** ```bash npx -y github:whobat/AI-Agent-skills --update --agent all --yes ``` - `--agent all` covers Claude Code (`~/.claude/skills`), Codex (`~/.agents/skills`) and OpenCode (`~/.config/opencode/skills`) in one run. Use `--agent claude` etc. to limit it. - Drop `--yes` if the user wants to confirm the update list first (the installer then shows `name: old -> new` and asks). - Requires **Node.js 18+**. **Fallback (no Node):** from a local clone of the repo (run `git pull` first — the comparison is against the clone): ```powershell ./install.ps1 -Agent all -Update -Yes # Windows ``` ```bash ./install.sh --agent all --update --yes # macOS / Linux / Git-Bash ``` ## What you (the agent) do with the result 1. Parse the output: each agent section lists either `updated -> ` lines or `all installed skills are up to date.` 2. **Report per agent**: which skills were updated (`old -> new`) and which were already current. If a runtime warning appears (e.g. a missing prerequisite for an updated skill), relay it. 3. If an expected update does not show up, the npm cache may be serving a stale copy of the repo — run `npm cache clean --force` and retry once. 4. Skills updated in the **current** agent are not reloaded mid-session — mention that new skill versions take effect in the next session. ## Gotchas **Skills from plugins, other repos, or hand-written folders are silently skipped — this is not a bug.** The installer only recognises skill folders whose name matches a skill published in this repo. If the user expects "update my skills" to refresh a plugin-installed skill or one they wrote themselves, those will not appear in the output at all. Clarify scope before the user concludes that a non-repo skill "failed to update". **"Nothing was updated" does not mean the skill is already current — it may mean the metadata version was never bumped.** Update detection compares `metadata.version` in the installed skill against the repo's published value. If a skill was patched without incrementing that field, the installer sees no delta and reports it as current. If a user suspects a skill is stale despite the "up to date" message, ask them to check the `version` field in the installed `SKILL.md` against the repo's HEAD. **`npx` needs Node 18+; the script fallback does not — and the two compare against different sources.** Running `npx -y github:whobat/AI-Agent-skills` fetches and runs the latest repo via npm. Running `./install.ps1 -Update` or `./install.sh --update` compares against the *local clone*. If the local clone is behind HEAD, the script path will not offer newer versions — run `git pull` in the repo folder before using it as the fallback. **A preserved `config.json` can mask a new required config key added in the update.** The update keeps the existing `config.json` intact, so secrets are safe. But if the updated skill adds a new required key that does not exist in the preserved file, the skill will silently lack that value at runtime. After updating a skill that has a `config.json`, check its `config.example.json` (if present) for any keys not yet in the local copy. **Environment-specific gotchas (local).** At the start of a run, read `gotchas.local.md` in this skill's folder if it exists — it records traps learned in *this* environment (real server/database names, local quirks, naming conventions). When you discover a new environment-specific pitfall here, **append it to `gotchas.local.md`** (not to this file, which must stay generic and company-agnostic). The file is gitignored and is preserved across skill updates, so this skill gets more useful every time it runs in your environment. ## Verification Run these checks before and after the update to confirm the operation did exactly what was expected — nothing more, nothing less. ### Before updating 1. **Inventory installed repo skills and their current versions.** For each agent (`~/.claude/skills`, `~/.agents/skills`, `~/.config/opencode/skills`), list every skill folder whose name matches a skill published in this repo and note its `metadata.version` from `SKILL.md`. These are the only candidates — skills from other sources are out of scope and must not appear in the diff. 2. **Ensure the source clone is current (script-fallback path only).** If you are using `./install.ps1 -Update` or `./install.sh --update` instead of `npx`, the comparison runs against the *local clone*. A stale clone offers no updates even when newer versions exist in the repo. Confirm the clone's HEAD matches origin before proceeding: ```bash git -C fetch --dry-run ``` If the clone is behind, run `git pull` before the update run. 3. **Confirm `config.json` and `gotchas.local.md` exist where expected.** For every installed skill that has local overrides, note their paths now. You will verify they are still present and byte-identical after the run. ### After updating 1. **Version bump confirmed.** For every skill the installer reported as updated, read the installed `SKILL.md` and assert that `metadata.version` now matches the version in the repo. **Fail loud** if a skill the installer said it updated still shows the old version string. 2. **No unintended installs.** The installed skill list must not contain any skill folder that was absent before the run. If a new folder appeared, flag it — `--update` mode must not install new skills. 3. **Non-repo skills untouched.** Any skill folder whose name does not match a skill in this repo must be byte-identical before and after. Spot-check at least one to confirm. 4. **Local overrides survived.** For every skill that had a `config.json` or `gotchas.local.md` before the run, confirm the file is still present and its contents are unchanged. If either file is missing or differs, the update must be treated as failed — surface this immediately rather than continuing.