PluginInstalls cleanly
Keep copied skills up to date safely
skill-update
Free MIT skill that finds where your copied skills came from, shows upstream changes, flags risky ones like new scripts, then merges and backs up.
- Works with
- Claude Code, Codex CLI
- Good for
- Everyone
What it does
Most skills are installed by copying a folder from GitHub. After that, nothing remembers where it came from, and updating means copying again and losing your own tweaks. Skill Update fixes that.
It looks through your skills folder (sub-folders too), works out which repository and commit each skill was copied from, and checks what changed upstream and what you changed yourself. Before you accept an update, it points out changes worth a look: new scripts, lines that download and run code, newly pre-approved tools, hook or MCP settings and licence changes. Then it merges the update with your edits, backs up every file it replaces and writes a dated log. You can undo an update, pin a skill to its current version, or add a new skill from a URL.
Example prompts
- "Check my skills for updates."
- "Update my skills and keep my edits."
- "Show me exactly what the update to this skill changes."
- "Undo the last update to the brag skill."
How to install
/plugin marketplace add Kowjirow/skill-update/plugin install skill-update@skill-updateHow to use it
Type /skill-update, or ask "check my skills for updates". Use /skill-update check to see changes without touching anything.
Check it works
Run /skill-update check. The first time, it asks which folder holds your skills (default ~/.claude/skills). Then you should get a report listing your skills, where each comes from, and whether an update is waiting. Nothing is changed by check.
Common problems
- "git not found" or Node errors — install git and Node.js 18 or newer — https://github.com/Kowjirow/skill-update
- A skill's origin is not found — give the URL once with
/skill-update track <skill> <url>— https://github.com/Kowjirow/skill-update - The session-start reminder stops working after a plugin update — the plugin's cached folder has the version in its path, so point the hook at the new folder or copy the skill to a fixed place — https://github.com/Kowjirow/skill-update
- Update reported as a conflict — your edits overlap upstream; the skill is left untouched, so merge by hand or pin it — https://github.com/Kowjirow/skill-update
Other assistants
- Codex:
npx skills add Kowjirow/skill-update -a codex, then use$skill-update. This uses Vercel's skills CLI, which collects anonymous usage data unless you setDISABLE_TELEMETRY=1orDO_NOT_TRACK=1— https://github.com/Kowjirow/skill-update - Gemini CLI: not named in the README and not in the Gemini CLI extensions gallery (checked 2026-11-05) — https://geminicli.com/extensions/
What to watch out for
- Runs a bundled Node.js script (needs Node 18+ and git) that fetches from the git repositories your skills came from
- find sends each untracked skill's name (and an owner name taken from links in the skill's own files) to the public skills.sh search API; the full /skill-update run sends you to find for untracked skills, so add --no-search (or --offline) to keep it local
- Risk flags (new scripts, curl | sh, changed allowed-tools, hook or MCP config, licence changes) come from pattern matching on added lines; an update can still bring instructions you don't want, so read the diff
- Writes outside your project: config, last check, backups, dated logs and a cache with a bare git clone of every source repository under ~/.claude/skill-update/ (or ~/.agents/skill-update/ without Claude Code); a .skill-update-lock.json file in each skills folder; and the skill files themselves on update. In Codex the sandbox asks for network and write access
- An optional afterUpdate command (set with config --after-update) runs through your shell after every update, revert or add that writes a log, and gets the report as JSON on its input
- The plugin ships no hook. The optional reminder is a SessionStart hook you add to ~/.claude/settings.json yourself (or ask the skill to); it reads the last check, puts one line and a list of waiting skills into the session, and only when that check is 7 or more days old starts a new check (git fetches) in the background. Its errors are silent
- plugin.json says 0.4.2 while the latest GitHub release is v0.4.1 (2026-11-03); the plugin install follows main, so you get 0.4.2, one commit past the release (as of 2026-11-05)
Licence and author
- Licence
- MIT
- Author
- Guillaume (Kowjirow)
- Source code
- github.com/Kowjirow/skill-update
How we tested it
We installed it on an empty test computer on 5 Nov 2026. Installed and started in a clean test system. Not yet used in a real AI session.
Not yet used on real work.
Technical details of the test
- Date
- 5 Nov 2026
- Method
- Intake sandbox run on 2026-11-05 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed skill-update@skill-update with the Claude Code command line.
Checked again on 5 Nov 2026
Alternatives
- Snyk Agent Scan — scans installed skills and MCP servers for security issues
- geiger — lists every agent, MCP server, plugin and hook on your computer and what each can reach
FAQ
- Q: Does it delete anything? A: The README says replaced or removed files are backed up first and a skill with a conflict is not touched. Keep your own backup of important skills anyway.
- Q: Does it need a GitHub token? A: No. It reads repositories with git, so any git host works.
- Q: Does it update Claude Code plugins? A: It lists plugins that are behind their marketplace and gives the command to update them.
Sources
- github.com/Kowjirow/skill-update
- github.com/Kowjirow/skill-update/blob/7139d3c9966dda14bb32e500655e0dc0a8156959/.claude-plugin/plugin.json
- github.com/Kowjirow/skill-update/blob/7139d3c9966dda14bb32e500655e0dc0a8156959/skills/skill-update/scripts/risks.mjs
- github.com/Kowjirow/skill-update/blob/7139d3c9966dda14bb32e500655e0dc0a8156959/skills/skill-update/scripts/origin.mjs
- github.com/Kowjirow/skill-update/blob/7139d3c9966dda14bb32e500655e0dc0a8156959/skills/skill-update/scripts/skill-update.mjs
- github.com/Kowjirow/skill-update/releases/tag/v0.4.1