What problem does it solve?
Deprecating a component, prop, or design token in a design system requires touching many files at once: JSDoc annotations, Rootage YAML specs, documentation pages, and a central deprecation tracker. This Skill standardizes that entire lifecycle so version numbers, replacement guidance, and removal schedules stay consistent everywhere.
Core Features & Use Cases
- Standardized deprecation notices: Adds JSDoc
@deprecated tags to TypeScript/TSX code and @deprecated notes to Rootage YAML specs with reason, removal version, and replacement.
- Documentation synchronization: Updates design guidelines, React docs, and the central
deprecations.mdx migration tracker with matching version information.
- Removal tracking: Guides the final cleanup when the removal version arrives, including regenerating Rootage artifacts and moving entries to the history section.
- Use Case: You want to deprecate the
rounded prop on a button component in favor of borderRadius="r2". The Skill walks you through annotating the code, updating the YAML spec, documenting the migration path, and scheduling removal in the next major release.
Quick Start
Ask the assistant to deprecate a specific component prop or token, providing the target, current version, removal version, replacement, and reason.
