🧹 Consolidação de Skills

Sobreposições em bibliotecas de skills surgem naturalmente — você cria uma skill para um contexto, depois outra para um contexto similar, e com o tempo as duas evoluem de formas diferentes mas cada vez mais próximas. O problema não é a sobreposição em si, mas a confusão que ela gera: qual usar em cada situação? Se as duas coexistem, qual é mais atual? Qual foi mais testada? A identificação sistemática de sobreposições começa com o mapeamento completo da biblioteca — listar todas as skills com seus propósitos centrais e triggers — e evolui para uma comparação pairwise que revela os pares ou grupos com maior intersecção. Isso transforma uma suspeita difusa de redundância em uma lista concreta de candidatos à consolidação.

O Skill Creator 2.0 é o agente especializado em criar e consolidar skills dentro do ambiente Claude Code. Diferente de simplesmente pedir para o Claude "combinar essas duas skills", o Skill Creator 2.0 tem instruções específicas para analisar a arquitetura de múltiplas skills, identificar o que é essencial em cada uma, resolver conflitos de design e produzir uma versão consolidada que é tecnicamente superior às originais. Ele não apenas funde — ele melhora enquanto funde, porque o processo de consolidação força uma revisão crítica de cada decisão de design. O resultado típico é uma skill mais clara, mais completa e mais fácil de usar do que qualquer uma das originais separadamente.

A fusão de skills não é um único passo — é um processo com fases distintas que, se seguidas corretamente, garantem que o resultado final é sempre melhor do que as partes. A fase de análise constrói o entendimento profundo de cada skill. A fase de mapeamento torna explícito o que se sobrepõe e o que é único. A fase de fusão cria a nova skill incorporando o melhor de cada uma. E a fase de validação confirma que nenhum caso de uso se perdeu. Pular qualquer uma dessas fases — especialmente a validação — é a causa número 1 de consolidações que parecem boas no papel mas falham em produção de formas sutis e difíceis de rastrear.

Testes de validação pós-consolidação têm um objetivo específico: verificar que a skill consolidada cobre exatamente os mesmos casos de uso das skills originais, sem exceção. Não é um teste de qualidade geral — é um teste de cobertura de regressão. A forma mais eficiente de fazer isso é criar uma matriz de casos de teste a partir das skills originais: para cada caso de uso que cada skill cobria, o teste verifica que a consolidada também cobre. Um falso positivo aqui é perigoso — você publica a consolidada, arquiva as originais, e só depois descobre que um caso importante ficou descoberto. O teste sistemático é a única proteção contra esse risco invisível.

Consolidação excessiva é tão problemática quanto redundância excessiva. Uma skill que tenta cobrir tudo se torna uma skill que não é boa em nada — trigger ambíguo, instruções longas demais, output genérico. O princípio de responsabilidade única diz que cada skill deve ter um propósito claro e limitado. Quando duas skills "sobrepostas" na verdade têm contextos de uso significativamente diferentes, personas diferentes ou outputs com formatos distintos, mantê-las separadas é a decisão certa. A sobreposição aparente é na verdade uma especialização legítima que seria perdida na consolidação. Saber reconhecer esse padrão é o que evita destruir ferramentas eficazes em nome de uma falsa simplicidade.

O versionamento de skills não é burocracia — é seguro contra decisões que pareciam boas e se provaram problemáticas. Meses depois de uma consolidação, é quase impossível reconstruir o racional das decisões tomadas sem documentação. Por que a skill A foi mantida no lugar da skill B nesse comportamento específico? Por que certos casos de uso foram classificados como "cobertos" se agora parecem não estar? Um CHANGELOG bem mantido responde essas perguntas em segundos, e a pasta de arquivo com as skills originais garante que um rollback é sempre possível. O custo de manutenção desse sistema é mínimo; o custo de não tê-lo pode ser alto.