Cómo sacar partido a las Agent Skills en Claude Code

Fuentes: You're probably using Agent Skills wrong

Las Agent Skills de Claude Code son archivos de Markdown que aportan contexto y herramientas a un agente para tareas concretas, y se infrautilizan porque se confunden con simples instrucciones autogeneradas por el propio modelo. El autor critica un reciente estudio de Hacker News titulado “Self-generated Agent Skills are useless”: la prueba simplemente pide al agente escribir conocimiento procedimental sobre un problema que no sabe resolver, lo que equivale a reinventar, peor, los bloques de razonamiento. Para que una Skill aporte valor, el agente debe haber identificado una laguna real. El autor plantea tres usos legítimos. Primero, Skills de contexto: los agentes carecen de estado entre conversaciones y, en monorepos grandes, perderían tiempo averiguando el lenguaje, el patrón de pruebas o la arquitectura de contenedores; una Skill bien escrita cubre esos huecos. Segundo, Skills de repetición: tareas frecuentes (por ejemplo, alinear documentación, descripciones de merge requests y código) se documentan una vez y se reutilizan. Tercero, Skills para problemas difíciles: tras intervenir manualmente para desatascar al agente, se le pregunta qué le faltaba y, si aporta una idea genuina, se convierte en una Skill. El autor afirma haber reejecutado la batería de pruebas con su método y obtuvo resultados muy superiores, aunque reconoce no tener recursos para validarlo a gran escala. Concluye que solo merece la pena crear Skills cuando aportan conocimiento que un modelo recién iniciado no posee, ya sea por un proceso recurrente, por aprendizaje tras un problema complejo o por investigación deliberada.