Agent skill · software engineering · jeremylongshore
apple-notes-upgrade-migration
Migrate Apple Notes automation scripts between macOS versions.
Why this skill is useful
Adds executable scripts for backing up and validating Apple Notes across macOS upgrades, which are not commonly documented.
What it needs
Requires jq installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Apple Notes Upgrade & Migration Overview Each macOS major release can change Apple Notes capabilities, JXA API behavior, and the underlying NoteStore database schema. Automation scripts that work on Ventura may fail on Sonoma due to new properties, changed Apple Events handling, or TCC permission resets. This guide covers version-specific changes, pre-upgrade backup procedures, post-upgrade validation, and a compatibility matrix for JXA features across macOS versions. Prerequisites A supported-device inventory, a tested encrypted backup, and a documented rollback/incident owner. A non-production test account or folder for optional mutation verification; routine post-upgrade validation is read-only. Reviewed release notes for the actual macOS version, rather than relying solely on the illustrative compatibility table. Instructions 1. Pause scheduled writes before the upgrade and capture a redacted pre-upgrade receipt with scope, count, checksum, and automation version. 2. After the upgrade, review consent in System Settings or MDM for the exact client and run only scoped read-only checks first. 3. Compare bounded reconciliation data to the pre-upgrade receipt; investigate discrepancies without changing Notes storage. 4. Re-enable writes only after an owner accepts the validation record; perform any write test in the dedicated test folder. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/apple-notes-upgrade-migration