What problem does it solve? After upgrading a skills collection, the artifacts a previous run installed into your repository — tracker descriptors at .ai/trackers/<tracker>.md and browser-provider descriptors at .ai/browsers/<provider>.md — become stale, silently degrading or skipping operations they no longer define. This Skill reads the collection's UPGRADE_NOTES.md, diffs installed artifacts against the shipped versions, and brings them up to date without discarding local customizations. ## Core Features & Use Cases - Descriptor diffing: Compares installed tracker and browser descriptors operation-by-operation, classifying each difference as missing, safely replaceable, locally edited, or local-only. - Conflict-safe upgrades: Never overwrites team customizations silently — shows both versions side by side and asks per section, while --yes auto-applies purely additive changes. - Config and artifact checks: Adds missing config keys with documented defaults, verifies the browser provider resolves, and validates the config still parses with jq. - Use Case: After running npx skills add to upgrade your agent pipeline collection, run this Skill with --dry-run to preview exactly which operations (e.g. attach-image-evidence) your installed GitHub tracker descriptor is missing, then apply the additive changes and review the uncommitted diff. ## Quick Start Ask the agent to apply the upgrade notes from the skills collection and re-sync my installed tracker and browser descriptors, using --dry-run first to preview the changes.
