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/install

Despué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 agente

El 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.

Informe de marzo

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 agente

Có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

R$ 1.111,11R$ 8.888,88

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 agente

El 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.

hsl 30 50%hsl 150 50%hsl 250 50%hsl 320 50%
Genera la rampa de la marca #0ea5e9 en OKLCH y los tokens para los dos temas

/a11y

la llama el agente

Teclado 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 agente

Agrupació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.

Nombre:Ana Souza
E-mail:ana@acme.com
Plan:Pro
Cobro:Mensual
La configuración parece una lista de compras. Agrúpala sin llenarla de divisores

/microcopy

la llama el agente

El 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.

¿Estás seguro?Esta acción no se puede deshacer. Confirma para continuar.
NoOK
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.

ProR$ 49Proyectos ilimitadosSuscribir
/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.

Copiar página
/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ó.

PRB-128Checkout falla128
/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.

Checkout falla con descuentoLa búsqueda devuelve datos viejosLa subida del avatar expira
/states la lista de problemas

/handoff

la llama el agente

Construye 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.

Figma · node 12:345
Implementa este frame: figma.com/design/…?node-id=12-345

Ingenierí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 agente

Proyecto 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 agente

Rojo, 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 agente

Bugs 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 agente

El 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 empezar

Má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.