| name | upgrade-universal-plugin |
| description | Use this skill when upgrading pinned `npx universal-plugin@0.2.2` calls across a project to a newer version. |
Upgrade Universal Plugin
When to use
When the user wants to bump the pinned universal-plugin version in hook commands, SKILL.md files, docs, or any other project files from the current pinned version to a target version (latest or a specific semver).
Instructions
Step 1 — Resolve the target version
If the user supplied a version (e.g. 2.1.0), use it directly.
Otherwise, fetch the latest published version:
npm view universal-plugin version
Step 2 — Find all pinned calls
Search the project for every occurrence of npx universal-plugin@:
grep -rn "npx universal-plugin@" . \
--include="*.md" --include="*.json" --include="*.yaml" --include="*.yml" \
--include="*.ts" --include="*.js" \
| grep -v node_modules
Report a summary: how many files, which files, and the versions currently pinned.
If zero occurrences are found, report that there is nothing to upgrade and stop — do not modify files or create a commit.
Step 3 — Confirm with the user
Show the list of files and the planned replacement, then ask for confirmation before making any changes.
Example summary:
Found npx universal-plugin@0.2.2 in 4 files:
<skill>/SKILL.md (2 occurrences)
<hooks-file> (1 occurrence)
<docs-file> (1 occurrence)
Replace all with npx universal-plugin@0.2.2 (y/n)
