Las skills que uso todos los días
Matheus Cardosoactualizado el
Skills de agente que uso todos los días en Claude Code. Mitad interfaz, mitad ingeniería, cada una con el valor exacto y el criterio de terminado que un prompt de memoria no trae.
Instalación
Dos puertas. El plugin instala el conjunto como paquete gestionado que se actualiza cuando publico. El clon pone los archivos donde puedes editarlos. Elige una: instalar las dos te deja con cada skill dos veces.
# plugin: atualiza junto com o repositório
/plugin marketplace add matheuscarddoso/skills
/plugin install mcardoso-skills@mcardoso
# ou clone, se você quer editar as skills
git clone https://github.com/matheuscarddoso/skills.git ~/Projects/skills
~/Projects/skills/scripts/installDespués, /ask y una frase describiendo tu situación. Decide qué skill resuelve y la llama.
Si solo vas a adoptar tres, adopta /grill, /review y /designer. Una evita construir mal, otra evita entregar mal, y la tercera evita entregar feo.
Interfaz
Seis especialistas, una por disciplina, que el agente consulta mientras construye. Una revisión que pasa por todas. Cinco herramientas que producen en vez de juzgar.
/designer
la llamas túRevisa una pantalla, un flujo, una rama o un PR pasando por todas las skills de interfaz, y devuelve un veredicto, ordenado, con archivo y línea en cada hallazgo.
¡Se ve bien! Algunas sugerencias:
- mejorar el contraste
- ajustar algunos espacios
- quizás revisar los textos
/designer revisa el checkout, incluidos el estado vacío y el de error/polish
la llama el agenteEl acabado con valores exactos: radio concéntrico, sombra en lugar de borde, contorno de imagen, alineación óptica, presión en 0.96, cambio de ícono, entradas, salidas y gestos.
radio 12 por fuera y por dentro · borde sólido · imagen sin contorno
Dale acabado a esta tarjeta: el radio, la sombra y la presión del botón/typography
la llama el agenteCómo se renderiza el texto: elegir y cargar fuentes, la escala, el interlineado, el ajuste con balance y pretty, números tabulares, truncado y puntuación.
Los detalles que hacen que una interfaz se sienta bien
text-wrap: wrap · proportional-nums
El título deja una palabra sola en la última línea y el precio tiembla cuando cambia/color
la llama el agenteEl sistema de color: rampas en OKLCH, tokens por función, conversión de formato, gamut, contraste medido en el par que realmente se renderiza y tema oscuro.
Genera la rampa de la marca #0ea5e9 en OKLCH y los tokens para los dos temas/a11y
la llama el agenteTeclado y foco, nombre accesible, semántica, formularios, lector de pantalla, área táctil y movimiento reducido, según WCAG 2.2.
¿Este formulario de registro funciona solo con teclado y lector de pantalla?/layout
la llama el agenteAgrupación, alineación, orden de lectura, breakpoints que salen del contenido y espacio para el texto traducido, para que el layout aguante ser redimensionado, traducido o espejado.
La configuración parece una lista de compras. Agrúpala sin llenarla de divisores/microcopy
la llama el agenteEl texto de la interfaz: etiquetas que nombran la acción, errores que dicen qué hacer, estados vacíos que enseñan y confirmaciones que nombran la consecuencia.
Reescribe el diálogo de eliminar sitio y el estado vacío de proyectos/variant
la llamas túTres versiones realmente distintas de un componente, en un eje que tú nombras, detrás de un selector en la página real. Alternas y promueves la que gane.
/variant la tarjeta de plan, variando la densidad/teardown
la llamas túExplica cómo se hizo una interfaz, un efecto o una animación de otro sitio, separando lo medido de lo deducido, y cierra con la receta que se lleva a tu proyecto.
/teardown ¿cómo está hecha la animación del botón de copiar de interfaces.dev?/break
la llamas túRenderiza un componente bajo todo escenario que lo alcanza en producción, texto enorme, cero elementos, 320px, RTL, en una página temporal, y marca lo que se rompió.
/break la tarjeta de problema/states
la llamas túUn banco de trabajo con cada estado de un componente, cargando, vacío, error, plan y permiso, con datos de prueba y un selector por teclado, para trabajar uno a la vez.
/states la lista de problemas/handoff
la llama el agenteConstruye a partir de un enlace de Figma o una captura, con los tokens y componentes del proyecto, y compara lado a lado antes de darlo por terminado.
Implementa este frame: figma.com/design/…?node-id=12-345Ingeniería
Alinear antes de construir, construir con tests, diagnosticar, auditar y desplegar. Ninguna asume un lenguaje: lo específico de cada stack vive en referencias.
/grill
la llamas túUna entrevista dura antes de construir, una pregunta a la vez, hasta que no quede decisión abierta.
1. ¿Quién puede cancelar: la persona, soporte, o los dos? Recomiendo los dos, con motivo obligatorio para soporte.
/grill quiero agregar suscripciones con cobro recurrente/kickoff
la llama el agenteProyecto nuevo: stack con justificación escrita, seguridad desde el día uno, infraestructura reproducible y el ciclo de feedback antes del primer commit.
Stack Next.js + Postgres, porque… Seguridad headers, secrets fuera del repo, CI con auditoría Ciclo lint + tipos + tests antes del 1er commit
Empieza un panel de cobros desde cero/tdd
la llama el agenteRojo, verde, refactoriza, una porción vertical a la vez.
✗ prorates a mid-cycle upgrade rojo, por la razón correcta ✓ prorates a mid-cycle upgrade verde, lo mínimo ↺ extrae daysLeft() refactoriza, sigue verde
Haz el cálculo de prorrateo con TDD/investigate
la llama el agenteBugs difíciles y regresiones de rendimiento, en seis fases con un control entre ellas: reproducir, aislar, minimizar, explicar, corregir, bloquear.
Fase 1 Reproducido: 2 entregas con 40ms de diferencia Fase 3 Mínimo: sin lock en la clave de idempotencia Control test en rojo antes del fix, verde después
El webhook de pago a veces se procesa dos veces/review
la llama el agenteEl diff en dos ejes que no se contaminan, estándar y spec, en subagentes paralelos.
Estándar 2 hallazgos catch genérico en billing.ts:88 Spec 1 hallazgo falta el reembolso parcial del issue
Revisa el diff antes del PR/engineer
la llamas túAuditoría en todas las capas, seguridad primero, a partir de un mínimo innegociable de diez puntos, con el fix específico en cada hallazgo.
[CRÍTICO] query sin límite en payouts.ts:41 [ALTO] retry sin backoff en el gateway Veredicto corrige antes
/engineer el módulo de repasses/qa
la llamas túCinco checks obligatorios, flujos reales de punta a punta, casos límite, y lo que debería estar testeado y no lo está.
✓ build, tipos, lint, tests, flujo feliz ✗ cupón vencido en medio del checkout: 500 Gap: ningún test cubre cambio de moneda
/qa el flujo de checkout/security
la llamas túAuditoría en tres niveles, y el tercero encadena hallazgos medios hasta volverlos críticos.
Cadena: ID secuencial + ruta sin chequeo de dueño + email en la respuesta
= cualquiera lista todos los clientes [CRÍTICO]/security antes de abrir la API pública/deploy
la llamas túUn control de seguridad, reproducibilidad desde un clon limpio, y los checks de cada modelo de distribución.
✓ un clon limpio compila y arranca ✗ a .env.example le falta STRIPE_WEBHOOK_SECRET ✓ migraciones reversibles, healthcheck real
/deploy la primera versión en producción/ask
la llamas túEl enrutador sobre todas las demás. Describe la situación y te dice qué skill la resuelve, y por qué.
/break: renderiza la tarjeta con el peor contenido en una página y dice qué skill es dueña de cada rotura.
/ask la tarjeta se rompe con un nombre largo y no sé por dónde empezarMás
Todo esto, con las referencias de cada skill y el presupuesto de tokens, está en matheuscarddoso/skills. La suite de interfaz parte de las skills de Jakub Krehel y de los principios de Emil Kowalski, ambos con licencia MIT.
Cada regla de estas skills es una clase, con demo y ejercicio, en craft.ocardoso.com.