pull-change

name	pull-change
description	Pull a specific version (X.Y.Z) from the upstream Claude Code CHANGELOG and scaffold its change folder + categorized.json. Use when the user names a particular release rather than asking for the latest. Markdown derivatives and the PDF are produced separately by render-derivatives.

pull-change

Fetches one named version from https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md and scaffolds it into the repo using the same layout as sync-latest-change. For the latest release, use sync-latest-change instead.

How to run

python3 scripts/pull_change.py 2.1.118

Argument is the version triple X.Y.Z (major.minor.patch). The script:

1. Fetches the upstream CHANGELOG.
2. Locates the ## X.Y.Z heading; errors out if absent.
3. Writes/refreshes changes/X/Y/Z/change.md.
4. Creates derivatives/X/Y/Z/categorized.json if missing (seeded from the change bullets, does not clobber existing JSON).
5. Upserts versions[X][Y][Z] in the root metadata.json.

After scaffolding, edit categorized.json (fill in summary and category fields, correct booleans), then run:

python3 scripts/render_derivatives.py 2.1.118

to produce by-type.md, by-cat.md, combined.md, and combined.pdf.

Layout & schema

See sync-latest-change/SKILL.md for the full layout, categorized.json shape, and metadata.json structure — both skills produce identical scaffolding.