Las skills que uso todos los días

Matheus Cardoso

Diecinueve skills para Claude Code, en un repositorio público. La mitad es ingeniería y la mitad es interfaz. Cada una es un modo de trabajo: pone al agente en un rol específico, con un trabajo específico y un criterio de listo que no puede fingir haber cumplido.

El problema

Cada vez que abres Claude Code, empiezas de cero. El agente no sabe dónde está tu barra. No sabe que "funciona en mi máquina" no alcanza, que la seguridad no es la última etapa, que una interfaz de plantilla no pasa.

Entonces te repites. "Revisa seguridad en todas las capas." "Corre los tests antes de decir que terminaste." Dices las mismas cosas con palabras distintas cada sesión, y el resultado depende de qué tan bien tradujiste tu estándar en ese momento. Eso es varianza, y varianza en un proceso es un bug.

Una skill es ese estándar escrito una sola vez. Un archivo markdown con frontmatter. Sin build, sin runtime, sin dependencias.

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.

Las diecinueve

Interfaz

/designerCoordina las ocho de abajo y devuelve un veredicto único.
/layoutEstructura, agrupación, orden de lectura, breakpoints del contenido.
/typographyElección de fuente, escala, medida, altura de línea, truncamiento.
/colorPaleta en oklch, color semántico, contraste, token, tema.
/a11ySemántica, foco, teclado, ARIA, formulario, área de toque.
/polishEl acabado: radio, sombra, superficie, icono, movimiento.
/microcopyTexto de interfaz, del rótulo de botón al error y estado vacío.
/variantTres versiones distintas detrás de un selector en la página real.
/teardownDesarma interfaz de terceros y explica el mecanismo.

Ingeniería

/grillEntrevista dura antes de construir, una pregunta a la vez.
/kickoffProyecto nuevo: stack justificado, seguridad el día uno.
/tddRojo, verde, refactoriza, una porción vertical a la vez.
/investigateBug difícil en seis fases, con traba entre ellas.
/reviewDiff en dos ejes que no se contaminan: estándar y spec.
/engineerAuditoría en todas las capas, desde un mínimo no negociable.
/qaCinco checks, flujos reales, y lo que debería estar probado.
/securityTres niveles, y el tercero encadena hallazgos hasta volverlos críticos.
/deployTraba de seguridad, y reproducibilidad desde un clon limpio.
/askEnrutador sobre todas. Describe la situación y dice cuál resuelve.

Si solo vas a adoptar tres, adopta /grill, /review y /designer. Una evita construir lo equivocado, la otra evita entregarlo, y la tercera evita entregarlo feo.

Cómo está hecha una skill

La descripción no es adorno: es lo que decide si el agente llega a la skill. Tiene que decir qué es la skill y listar los disparadores, incluidas las frases que la persona realmente escribe cuando tiene el problema.

---
name: investigate
description: Diagnóstico disciplinado de bug difícil ou regressão de
  performance, por fases com trava entre elas. Use quando algo está
  quebrado e a causa é desconhecida, quando o usuário disser "tá lento",
  "não funciona", "por que isso quebrou".
---

## Fase 3: Minimize

Corte tudo que não é necessário pro vermelho. Metade da entrada,
metade do caminho de código, uma dependência de cada vez. Continua
vermelho, o corte fica. Ficou verde, o corte tocou a causa.

**Trava:** nada mais pode ser removido sem o vermelho virar verde.

El resto son pasos con criterio de listo verificable. "Hasta estar alineado" invita al agente a declarar victoria temprano. "Nada más puede quitarse sin que el rojo se vuelva verde" no invita.

Quién la llama

Las diecinueve se dividen en un solo eje: quién puede llamarlas. Diez solo responden cuando escribes, porque una auditoría completa que el agente dispara solo sale cara y cae en medio de tu trabajo.

Las otras nueve responden al agente también, y ahí está la diferencia que más noto. Cuando alguien dice "está lento y no sé por qué", va al diagnóstico por fases en vez de adivinar. Y mientras escribe un componente alcanza a11y y polish sobre la marcha, en vez de que yo encuentre el problema en la revisión.

Lo que cuesta en tokens

Una skill es contexto, y el contexto es dinero y atención. Una suite que cobra caro por llamada se vuelve una suite que dejas de usar, y la mejor skill del mundo, sin usar, no hace nada. Así que el costo acá es restricción de diseño, no optimización para después.

La descripción de toda skill instalada está en el contexto en cada sesión, se haya usado o no. Es el único costo que pagas siempre, y por eso tiene el presupuesto más duro. El cuerpo carga solo lo que toda ejecución necesita; lo que solo algunas alcanzan vive en references/, detrás de un link con la condición escrita.

1.550 tokenssiempre cargado
1.378 tokensllamada más cara
42.276 tokenstodo de una vez

En la práctica: la suite entera suma 42 mil tokens y ninguna sesión paga eso. /security en una pasada rápida cuesta mil, y la auditoría completa con los catorce dominios cuesta casi cuatro mil. Pagas por lo que usas.

$ node scripts/skills.mjs bill

  skill         chamada     + references  refs  descrição
  --------------------------------------------------------------
  ask           571         571           0       47
  grill         946         946           0       90
  a11y          1226        3296          3       98
  color         1210        3194          3       72
  designer      1341        2584          2       89
  layout        1345        2720          2       85
  microcopy     1137        1965          1       56
  polish        1378        3376          3       95
  teardown      1159        1796          1       80
  typography    1230        2485          2       79
  variant       1245        1857          1       77
  deploy        705         1240          1       75
  engineer      1258        4613          6      105
  investigate   849         849           0       79
  kickoff       1011        3620          4       79
  qa            751         1213          1       83
  review        798         1284          1       79
  security      998         3937          4       92
  tdd           737         737           0       61
  --------------------------------------------------------------

  Sempre carregado (soma das descrições): 1550 tokens de 1600
  Chamada mais cara: 1378 tokens

Y el presupuesto rompe el build. Duplicar la suite de once a diecinueve skills llevó el siempre-cargado de 899 a 1.550 tokens, y el techo de 1.600 no subió: lo que pagó la cuenta fue recortar las listas de disparadores a los términos que de verdad distinguen una skill de su vecina. Un presupuesto que no rompe el build no es un presupuesto, es una intención.

Ninguna asume un lenguaje

El cuerpo de cada skill habla en capacidad, no en herramienta: "el analizador estático del proyecto, en el nivel que mantiene", y no "PHPStan en nivel 6". Eso no es diplomacia. Es lo que hace que la skill siga valiendo cuando cambias de stack a mitad de un proyecto.

Lo específico vive en references/stacks/, y la skill lee solo el archivo del stack que detectó. Agregar Python y TypeScript a /engineer subió su costo profundo y casi no movió el de la llamada, porque un proyecto Python no paga por los otros dos.

Más

El repositorio es MIT y las skills son markdown que puedes leer de una sentada. Tres repositorios lo moldearon, y vale leer los tres: las skills de Rodrigo dieron la sustancia, las de Matt Pocock la arquitectura, y la gstack de Garry Tan el rigor de suite. Código en matheuscarddoso/skills.