What problem does it solve? After upgrading an agent-skills collection, the artifacts previously installed into your repository (tracker descriptors at .ai/trackers/<tracker>.md and browser-provider descriptors at .ai/browsers/<provider>.md) stay stale, which can degrade or skip operations the new skills expect. This Skill diffs installed artifacts against the freshly shipped versions, applies safe updates, and reports exactly what changed. ## Core Features & Use Cases - Descriptor diffing: Compares installed tracker and browser descriptors operation-by-operation against shipped versions, classifying each difference as missing, changed, locally edited, or local-only. - Customization preservation: Never overwrites a locally edited section silently; shows both versions and asks the operator to keep, replace, or merge, while always keeping local-only operations. - Upgrade-notes migration: Walks the collection's UPGRADE_NOTES.md, adds missing config keys with documented defaults, and verifies expected artifacts exist. - Custom-provider gap reports: For trackers or browser providers not shipped in the collection, reports newly required operations with their contract text instead of inventing an implementation. - Use Case: After running npx skills update -p, invoke this Skill to re-sync your repo's .ai/ pipeline artifacts, preview everything with --dry-run, and get a report of conflicts needing a decision. ## Quick Start Run the ot-apply-upgrade-notes skill with --dry-run to preview which tracker and browser descriptor updates the latest skills upgrade would apply to this repository.
