As 226 skills da PostHog pedem manutenção

A PostHog diz que seus times publicaram 226 skills em uma loja interna, com 187 arquivos SKILL.md em 28 produtos. A lição não é despejar todo o contexto no prompt: a descrição deve encaminhar o agente ao contexto certo, e o detalhe entra quando for necessário. Por que importa: Uma skill que congela caminhos e passos envelhece junto com o produto. Uma skill vaga só deixa o agente adivinhar durante a execução. O meio-termo útil é intenção e guarda-corpos duráveis, com os detalhes voláteis apontando para a fonte certa.

Para testar: Pegue uma skill que seu time usa sempre. Tire uma instrução frágil ligada a caminho de arquivo, acrescente um critério concreto de conclusão e aponte o detalhe que muda para sua fonte de verdade. Depois rode a mesma tarefa e compare onde o agente hesita ou tenta de novo.