A suas SKILLS.md estão arruinando seu Code Agent (Claude, Codex, Cursor)

Combinar skills aos Code Agents se tornou uma febre. Há repositórios e mais repositórios, pouco se debate sobre a eficácia delas. Porque assumimos que elas são benéficas.

Não é apenas o tamanho do arquivo

Se você tem um pouco mais de experiência, pensou no tamanho do contexto, mais ou menos. Mas isso está correto, Code Agents degradam quando o contexto aumenta, chamamos de DUMBER ZONE. 

Como uma skill pode tornar seu agente pior em completas tasks

Se a justificativa não é o tamanho da skill, o que poderia ser, segundo o trabalho “Agent Skills Can Be Harmful: An Empirical Study of Skill-Induced Failures in LLM Agents”, a maior causa de degradação dos Agents é quando a skill induz a realizar mais etapas do que é preciso, muitas vezes testes, ou pular etapas críticas como validação.

Os autores mediram a completude das entregas dos Agents para várias tasks contra skills populares, em mais de 50% dos casos houveram degradação nas respostas.

O que você deveria fazer

Essa pesquisa demorou, aumentar o contexto do modelo é ruim, forçar certos paths pode fazer com que ele não complete etapas críticas, nesse caso, lembre-se que da próxima vez que for instalar uma skill nova, avalie quais etapas ela cumpre e se faz sentido usar tudo o que ela fornece.