root@construct:~/rants/skill-envelhece-api$
<-- voltar para /rants
2026-05-17//OPINIÃO

Skill que chama API morta é documentação quebrada

Uma skill que aponta pra uma API morta precisa de manutenção, por mais bonita que esteja a descrição. Em 12 de maio de 2026, a OpenAI retirou o DALL·E 2 e o DALL·E 3 da API. O endpoint sai do catálogo. O arquivo de instruções continua tranquilamente no disco, pronto pra mandar outro agente bater na mesma porta fechada.

Pensa numa skill de geração de imagem cujo script ainda chama `dall-e-3`. A descrição promete uma imagem num certo formato, e a execução bate num modelo que não existe mais. O agente pode até explicar o erro com muita educação, e eu continuo sem imagem.

Quero a dependência visível perto da instrução: qual ferramenta executa aquilo e como conferir se ela continua disponível. Na prática, é um campo `requires:` no topo da skill com o modelo ou o endpoint, mais um smoke test que manda a menor requisição possível e falha quando o modelo some. Isso também ajuda quando o serviço existe, mas a sessão atual não tem acesso. São problemas diferentes. Sair trocando a implementação por causa de uma ferramenta ausente naquela sessão é começar uma reforma antes de conferir a chave.

Atualizar uma skill exige decidir se a entrega continua igual. Se muda apenas o meio de produzir o mesmo resultado, faz sentido preservar a entrada conhecida. Se o novo serviço muda o comportamento, essa diferença precisa aparecer pra quem pede o trabalho.

Também não quero uma coleção de arquivos mantida por esporte. Uma skill existe justamente pra evitar repetir pesquisa e preparação. Se cada uso exige investigar tudo do zero, a capacidade de reaproveitar ficou no título. Preciso encontrar as condições de execução e um caminho de atualização na própria skill.

Dependência faz parte da manutenção da skill. Ao trocar uma API, vou revisar a instrução que escolhe a ferramenta, atualizar a linha `requires:`, conferir a entrega esperada e tirar de circulação o caminho que deixou de funcionar.

Skill que chama API morta é documentação quebrada | The Broad Way