Una skill es una instrucción experta que el agente carga automáticamente cuando detecta la tarea. Viven en skills/ como archivos SKILL.md y también puedes crear las tuyas en .noirarc/skills/.
Antes de tocar código: descompone la tarea, lista riesgos y pide confirmación. Se activa con "planifica", "diseña" o tareas de 3+ pasos.
Revisa diffs antes de aplicar: efectos laterales, casos borde, tests que deberían existir. Se activa en cada cambio no trivial.
Obligatoria en zonas sensibles (secretos, pagos, infra, borrados). Busca fuga de credenciales y efectos irreversibles. Puede bloquear la acción.
Reproduce el error con evidencia real (logs, stack), aísla la causa mínima y corrige. Prohíbe "probar a ciegas".
Escribe el test que falla sin el fix y pasa con él. Sin teatro verde: si no puede fallar, no es un test.
Limpieza preservando comportamiento: extrae funciones, elimina duplicación, siempre con tests verdes antes y después.
Mide antes y después con números (ms, MB, req/s). Sin benchmark no hay afirmación de mejora.
Documenta lo que cambió: README, comentarios de por qué (no de qué), ejemplos que compilan.
Ramas, commits atómicos con mensajes útiles, PRs con contexto. Nunca pushea sin confirmación.
Idioms del lenguaje del proyecto (TS estricto, ESM, errores tipados). Corrige patrones, no solo sintaxis.
.noirarc/skills/mi-skill/SKILL.md en tu proyecto--- name: mi-skill description: Cuándo debe usarme el agente --- # Instrucciones expertas...