polish-component
Refina componentes frontend recién creados o refactorizados para mejorar su calidad interna. Usa esta skill cuando un componente tenga props públicas, constantes, handlers, mappings, estilos configura
SKILL.mdmastra-poc/.agents/skills/frontend/react/polish-component/SKILL.md
GitHubPolish Component
Propósito
Refinar la calidad interna de un componente ya creado o refactorizado sin rediseñar toda la feature.
Cuándo usarla
Usala cuando un componente:
- es reusable o exportado;
- tiene props públicas relevantes;
- contiene constantes, mappings o helpers;
- concentra handlers o lógica derivada;
- expone estilos configurables;
- creció lo suficiente como para que valga la pena revisar su estructura interna.
Cuándo no usarla
No la uses para:
- wrappers triviales;
- componentes puramente presentacionales de pocas líneas;
- ajustes visuales mínimos sin impacto estructural.
Checklist de refinamiento
1. API de props
- Nombres claros.
- Responsabilidades entendibles.
- Evitá componentes ambiguos entre controlados y no controlados salvo que sea intencional.
- Evitá props genéricas que oculten decisiones importantes.
2. Constantes y mappings
- Si una constante o mapping es pequeño y local, puede quedar colocalizado.
- Si representa lógica reusable, crece demasiado o podría compartirse, evaluá extraerlo a:
*.constants.ts;- helper;
- util del dominio.
- No extraigas archivos por reflejo.
3. Handlers y lógica interna
- Revisá si los handlers están bien nombrados y son legibles.
- Extraé lógica a hooks o helpers solo cuando:
- se reutiliza;
- dificulta leer el componente;
- mezcla reglas de negocio con render.
- No agregues
useCallback,useMemoo memoización sin motivo real o patrón del repo.
4. Organización del archivo
- Orden lógico:
- tipos;
- constantes;
- helpers locales;
- componente;
- exports.
- Si el archivo queda sobrecargado, proponé una separación mínima y justificada.
5. Estilos configurables
- Si el componente reusable necesita adaptarse visualmente a varios contextos, revisá:
classNameraíz;classNamespor slots;- variantes del design system.
- Conservá defaults funcionales.
6. Accesibilidad e interacción
- Si hay interacción, revisá etiquetas, botones, feedback y estados disabled.
- No conviertas esta skill en una auditoría de accesibilidad completa, pero corregí problemas evidentes.
Salida esperada
- Qué se pulió.
- Qué se mantuvo colocalizado y por qué.
- Qué se extrajo y por qué.
- Riesgos o deuda menor restante, si aplica.