What problem does it solve?
Keeping the mirrored lexicons/chat/ directory in the atproto monorepo in sync with the private bluesky-social/chat repo is error-prone: a plain copy leaves generated clients stale, wrong mtimes make builds skip regeneration, and missing changesets break release conventions. This Skill walks through the full copy-plus-codegen-plus-changeset workflow so nothing is silently left out of date.
Core Features & Use Cases
- Safe mirroring: Refreshes the sibling
../chat checkout first, then uses rsync -a --delete scoped strictly to lexicons/chat/, never touching app/, com/, or tools/ lexicons.
- Correct regeneration: Runs
pnpm codegen instead of pnpm build so packages/api and packages/ozone regenerate unconditionally despite preserved source mtimes.
- Release conventions: Adds a
.changeset/ file with a patch bump on @atproto/api (or minor for breaking removals), then verifies with package builds, tests, and full root checks.
- Use Case: A maintainer is asked to "update chat lexicons" after new chat convo or moderation definitions land upstream; the Skill performs the sync, regenerates types, adds the changeset, and validates the result before commit.
Quick Start
Ask the assistant to update the chat lexicons from the chat repo and regenerate the derived code with a changeset.
