What problem does it solve?
Plate's docs app is a forked product surface of the shadcn docs architecture, and keeping it aligned with upstream shadcn changes requires tedious manual diffing, classification, and decision tracking. This Skill automates the audit of upstream commits, inventories every added, modified, or deleted change, and produces reviewable merge plans so nothing is silently missed.
Core Features & Use Cases
- Range Planning and Inventory: Compares the tracked baseline commit against the current upstream target, classifies each change as adopt, smart-merge, fork, defer, or exclude, and writes a reviewable plan under docs/sync/shadcn.
- Status, Review, and Dashboard Commands: Provides
status checkpoints, freshness review audits against the current checkout, and a generated HTML dashboard for visually deciding each delta row.
- Micro-Overlap Direct Merges: Applies qualifying tiny upstream fixes to already-synced Plate components directly during planning, while stopping for user review on all substantive slices.
- Use Case: After shadcn ships new docs changes, run a scoped lane such as
sync-shadcn command-menu to get a plan with screenshots, owner files, and recommended merge slices before touching apps/www.
Quick Start
Ask the assistant to run sync-shadcn status to see the current baseline, pending upstream changes, and the recommended next sync step.