What problem does it solve?
It fixes shadcn ui Command component failures caused by drift between the shadcn registry-generated wrapper and the installed cmdk version, which can break filtering, clicking, focus, exports, and even crash rendering.
Core Features & Use Cases
- Diagnose drift causes quickly by mapping symptoms to the six common cmdk drift traps (filter signature mismatch, case-sensitive custom filtering, Vaul focus duel, shouldFilter=false full-list trap, CommandLoading export gap, and wrapper/core version mismatch).
- Apply correct, version-aware fixes including rewriting filter functions to the cmdk 1.0+ 3-argument signature, enforcing case normalization in custom filters, and regenerating or pinning cmdk so the wrapper matches the runtime API.
- Repair composition and runtime structure by ensuring CommandItem (and related subcomponents) are rendered under CommandList to avoid the Symbol.iterator crash, and by pairing shouldFilter=false with client/server filtering and a proper loading component.
Quick Start
Use the skill to troubleshoot a broken shadcn Command palette or Combobox by running the drift checks and then applying the matching fix strategy (pin cmdk, re-run shadcn add command --overwrite, or upgrade and migrate filter signatures).