Mudou do Codex para o Grok Bot? Não importe, recrie

No dia 10 de novembro de 2026, eu abri o catálogo de skills do assistente editorial que uso no Grok Bot. Skills são pacotes de instrução que ensinam o assistente a repetir um fluxo de trabalho. Contei 86 itens trazidos de uma biblioteca do Codex. Só cerca de dois faziam sentido para o trabalho dele. O restante vinha de outros projetos, apontava para caminhos de outro computador e, em alguns casos, puxava o assistente para um modo que não era o dele.

A tentação, quando se muda de ferramenta, é copiar tudo o que já existia para não perder tempo. O que eu vi foi o contrário: instrução importada vira conflito, regra errada e perda de clareza no agente. A minha conclusão foi não importar.

Por que o volume vira um problema de governança

Um assistente de IA não guarda uma biblioteca só para consultar depois, como um arquivo morto. No Grok Bot, a lista de skills entra no contexto do assistente, e a descrição de cada uma ocupa espaço nessa janela. Quando há dezenas de skills de outros projetos, o agente precisa lidar com um catálogo que não foi feito para ele.

A documentação da OpenAI sobre o Codex descreve um mecanismo semelhante: o sistema começa pelo nome e pela descrição de cada skill e só carrega o texto completo quando decide usar aquela skill [1][2]. Mesmo a lista inicial tem um limite. No Codex, esse teto é de 2% da janela de contexto, ou 8.000 caracteres quando o tamanho da janela não é conhecido. Se há skills demais, as descrições são encurtadas. Em conjuntos grandes, algumas skills podem ficar de fora da lista, com um aviso [2].

O problema, porém, não é só o espaço. Skills também podem ser acionadas sozinhas, quando a tarefa parece combinar com a descrição [2]. Se duas skills têm o mesmo nome, o Codex não as mescla: as duas aparecem [2]. Uma instrução antiga, escrita para outro sistema operacional, outro time ou outra pessoa, pode ser escolhida na hora errada.

Em plataformas em que a biblioteca de skills é compartilhada entre assistentes, o cuidado precisa ser ainda maior: o que entra ou sai pode valer para mais de um agente.

O que eu encontrei na auditoria

No meu caso, o catálogo estava cheio de skills de mídia paga, outros clientes e fluxos sem relação com a rotina editorial. Algumas puxavam o assistente para outro modo. Uma instruía o assistente a ser preguiçoso em toda resposta. Outra ligava um roteador de engenharia de software no início da sessão. Outra assumia o computador Windows de outra pessoa.

A própria skill editorial, que deveria ser a referência do trabalho, ainda trazia uma linha antiga e ambígua sobre autoria. Essa ambiguidade ajudou a explicar uma assinatura errada, “Pati”, em um artigo publicado. A descrição do assistente repetia quase toda a skill. As referências visuais estavam duplicadas e apontavam para um arquivo de CSS que não existia.

Não era sabotagem. Era legado: o que restou de uma importação feita para não perder o que já estava pronto.

Por que não importar

Depois da auditoria, a pergunta deixou de ser o que importar e passou a ser por que importar. Uma skill escrita para outro ambiente carrega as suposições desse ambiente: caminhos, pessoas, sistema operacional, ferramentas e regras que podem não existir mais. Revisar item por item dá quase o mesmo trabalho que escrever de novo e ainda deixa mais chance de sobrar ruído.

Por isso, apaguei as skills importadas, com backup antes. Mantive só duas: a skill editorial, reescrita do zero no Grok Bot, e uma skill de apresentações em HTML que ainda uso. As referências visuais herdadas também saíram. A regra agora é simples: não importar. Quando um fluxo se repetir, ele vira uma skill nova, criada no próprio Grok Bot, sob medida para o trabalho de hoje.

O que vale levar da ferramenta antiga é o aprendizado, não o arquivo: quais fluxos funcionavam, quais regras eram importantes e quais erros não repetir. Isso cabe em poucas linhas escritas de novo.

A documentação do Codex recomenda um princípio parecido para o arquivo AGENTS.md, que reúne as instruções permanentes de um projeto: começar só com o que importa e manter o texto pequeno [1][3].

Como fazer a limpeza sem quebrar o que funciona

A ordem que eu usei foi esta: primeiro, uma leitura só para listar o que existia, sem apagar nada. Depois, um backup. Só então a exclusão, item a item, e a criação do zero do que ainda era necessário.

Ainda não medi o efeito em números. O que posso afirmar é o que foi removido, o que foi recriado e a regra nova: não importar. O resultado vai ser observado no uso diário.

Para empresas, o ponto é de governança, não de preferência por uma ferramenta. Quem autoriza o que entra no contexto de um agente, quem revisa, com qual frequência, e o que acontece quando alguém muda de plataforma. Sem esse critério, a empresa não transfere conhecimento. Ela transfere também o ruído.