check-upstream-skills
Report what changed upstream in the vendored skills' source repos since the last sync, then sync what the user picks.
SKILL.md.claude/skills/check-upstream-skills/SKILL.md
GitHub.claude/skills/upstream.json is the manifest: each upstream source, its syncedSha, and every upstream path with a status (vendored, reference-only, declined), a reason for declined, and notes recording deliberate divergences of the local copy, and a derivedInto list of its forks: a bare name is a skill at .claude/skills/<name>/, an entry with a slash a repo-relative path.
1. Run the report
node .claude/skills/check-upstream-skills/check.ts <scratchpad>/upstream-check. It clones or fetches each source and prints the report; it writes nothing in the repo. Exit 1 means something moved; exit 0 prints "Up to date." and you are done.
2. Brief the user
Read the .patch file it names. For every changed tracked path, give a one-line verdict: what changed, and whether to take it. Its report line ends forks: <paths> when it has forks; give each fork its own one-line verdict on whether to apply the same change at that path. Name each unclassified skill, each path gone upstream, and each promoted-set change, with a suggested status. Mention declined and in-progress changes only when one looks like a reason to revisit the decision.
Done when every line of the report has a verdict, and the user has chosen what to take.
3. Sync what the user chose
- Take a vendored change: copy the upstream folder over
.claude/skills/<name>/, then reapply every divergence itsnotesrecord, so the copy differs from upstream only by those notes. - Take a change into a fork: edit the fork by hand to apply the change the user chose. A fork is this repo's own, so upstream is never copied over it.
- Classify a skill: add its path with a status; a declined one gets a one-line
reason. - Bump the
syncedShaof each path you synced or reviewed; once every path is reviewed, bump the source'ssyncedShaand copy the upstreamplugin.jsonskillslist intopromoted.
Done when a rerun of step 1 lists only the changes the user chose to leave.