playful-design/router

reuse

Reaches for the project's own components, then a maintained library, then a native feature, before writing new code.

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/playful-design/router --skill reuse

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

Reuse

This skill sets the order for building anything new. The project's own parts come first, then a maintained library or a platform feature. Custom code comes last.

A duplicate is a finding

A new component, style or icon that duplicates one the project already has is a finding. Adding a primitive to the shared package and then using it is not. A project with no shared package is judged on the libraries it already depends on.

Cutting what nobody asked for belongs to restraint. Copying an outside app belongs to match.

The project's parts come first

Search the shared component package, the icon set and the tokens before writing UI. Name what you found. A raw <input> beside the project's Input is reuse-house-component-first.

Shipped components stay as shipped

Use a component's variants and data-* attributes. Restyling it with a local className is reuse-no-local-restyle.

One style per kind of thing

Keep one menu, one table and one dialog shell. A second dropdown style is reuse-one-standard.

Fix it once, in the primitive

When a fix applies to every instance, make it inside the shared component. Patching five call sites is reuse-fix-in-the-primitive. Then search for every sibling, remove its local fix and list the files. Fixing only the cited line is reuse-sweep-siblings.

Then a library or the platform

When the project has nothing, use a maintained library or a platform feature before custom code. Intl formats dates and numbers. The native context menu handles right-click. A hand-written formatter is reuse-library-before-custom.

Check that a library is maintained. When it is not, port the pattern instead of installing it. That is reuse-no-stale-dependency.

Read the docs before the props

Read a primitive's documentation before using it, and use its current APIs. A guessed prop is reuse-read-the-docs.

Icons from the set, at native size

Use the project's icon set at the size it was drawn for. A generated SVG, or an 18px icon scaled to 12px, is reuse-icon-set-native-size. A glyph the set lacks, drawn by icons and added to the shared icon package or folder, is not a finding.

The pair

Every check is a pair. The broken line sits beside the line that replaces it.

RuleBrokenReplacement
reuse-house-component-first<input className={styles.search} />The project's <Input />
reuse-no-local-restyle.menu { border-radius: 6px } beside the shared MenuMenu as shipped
reuse-one-standardThree dropdown styles on three screensOne Menu
reuse-fix-in-the-primitiveA scroll fade added at five call sitesThe fade inside ScrollArea
reuse-sweep-siblingsThe cited line fixed, its siblings leftEvery sibling fixed, files listed
reuse-library-before-customA hand-written relative date formatterIntl.RelativeTimeFormat
reuse-no-stale-dependencyAn unmaintained package installedIts pattern ported into the project
reuse-read-the-docsrender={<button />} on a trigger that is already a buttonThe prop the docs describe, or none
reuse-icon-set-native-sizeAn 18px icon at width: 12pxThe 12px icon from the set

Reporting

Severity. HIGH is a duplicate of an existing shared component, or a hand-built control a primitive covers. MEDIUM is a local restyle, an icon from outside the set or a shared fix applied at one call site. LOW is a library chosen without checking that it is maintained.

Format. One finding per root cause:

file:line - [rule-id] what is wrong

Then a Rule | Count | Severity summary. Block when any HIGH remains, Approve otherwise. Never Approve a file you did not read. Mark every check you could not run as Not verified.

del mismo repositorio

Más Skills

Todos los Skills
playful-design
Comunidad

alignment

Measures a running page for edges, gaps, centring and radii that miss by a pixel or two, then judges visual weight and returns a numbered report with proof.

Instalaciones / 1h
2
GitHub Stars
13
Actualizado
5 nov
playful-design
Comunidad

animate

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

Instalaciones / 1h
2
GitHub Stars
13
Actualizado
5 nov
playful-design
Comunidad

animate-expo

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web a

Instalaciones / 1h
2
GitHub Stars
13
Actualizado
5 nov
playful-design
Comunidad

animation-performance

Keep web animations inside the frame budget — animate composite-only properties, keep motion off the main thread when the page is busy, and find the cause when an animation drops frames. Covers the layout/paint/composite pipeline, cheaper property swaps, CSS vs WAAPI vs requestAnimationFrame, Motion's hardware-accelerated path, React re-rendering per frame, inherited CSS variable recalculation, blur cost, and when will-change actually helps. Use when an animation is janky, choppy, stutters, or d

Instalaciones / 1h
2
GitHub Stars
13
Actualizado
5 nov