Um prompt salvo é um risco. Ele vive na interface de um único fornecedor, ninguém mais consegue lê-lo e, se o produto for renomeado, pode simplesmente sumir. Uma skill é a mesma instrução com gatilho, exemplos e um responsável, guardada numa pasta sob o seu controle, e essa é a versão que sobrevive.
O momento não é por acaso. O Google está aposentando os Gems do Gemini em contas pessoais e convertendo-os em "skills", num cronograma definido para o fim de 2026, com os usuários invocando-as ao digitar "/" numa conversa de tarefa (TechCrunch). Um dia depois, a OpenAI ampliou os plugins do ChatGPT com áreas próprias na barra lateral, painéis interativos e um Plugin Creator (TechCrunch). GPTs personalizados, Gems, plugins, apps e skills são nomes diferentes para o mesmo instinto: parar de redigitar instruções.
Se você montou algumas dezenas desses assistentes, agora tem dois trabalhos: manter o que construiu e deixar tudo portátil o bastante para que a próxima mudança de nome custe uma tarde, e não um trimestre. Este guia mostra como fazer as duas coisas, com um template, uma rotina de testes, um checklist de migração e uma resposta direta sobre quando não vale a pena se dar a esse trabalho.
Por que seus assistentes salvos vivem mudando de nome
Os Gems foram lançados em 2024 como assistentes para tarefas específicas que você podia criar sem repetir instruções, e também podia compartilhar. A página de ajuda do próprio Google agora diz que os Gems deixarão de existir em contas pessoais e passarão automaticamente a skills (Google Gemini Help). O TechCrunch observa que a migração automática dispensa qualquer ação dos usuários e que as skills são chamadas por um comando com barra, uma interface que, segundo o site, os engenheiros costumam preferir.
Migração automática parece seguro, e para o texto das suas instruções quase sempre é. O Google diz que os arquivos de conhecimento compatíveis também vão junto, mas os uploads de skills aceitam arquivos de texto simples, PDFs e imagens, e não arquivos Word ou Excel, e a página de transição informa que o compartilhamento e os arquivos vinculados ao Drive chegam nas próximas semanas (Gemini Help, regras de upload). Uma migração move conteúdo. Ela não move os exemplos que você guardava de cabeça, nem a pessoa da sua equipe que sabia quando usar cada Gem.
O padrão se repete entre os fornecedores. O formato de compartilhamento anterior da OpenAI era o custom GPT, e a documentação atual para desenvolvedores descreve plugins que empacotam skills junto com um servidor MCP (OpenAI Developers). As skills da Anthropic nem sincronizam entre os próprios produtos da empresa. Segundo a documentação da Anthropic, uma skill enviada ao claude.ai não fica disponível na API, e as skills do Claude Code são baseadas no sistema de arquivos e separadas das duas (Claude docs). Parta do princípio de que toda plataforma vai renomear, juntar ou dividir o que você salvou nela.
O que é uma skill, sem o marketing
Uma skill é uma pasta. Na definição da Anthropic, ela contém instruções, scripts e recursos que um agente pode descobrir e carregar dinamicamente para uma tarefa específica (Anthropic Engineering). O único arquivo obrigatório é o SKILL.md, que começa com um nome e uma descrição e segue com as instruções.
A descrição é o que mais pesa. Na inicialização, o assistente carrega apenas o nome e a descrição de cada skill (cerca de 100 tokens cada, segundo a Anthropic) e compara o seu pedido com esse texto para decidir se abre o resto. Uma descrição vaga faz a skill nunca disparar. Uma descrição gananciosa faz ela disparar o tempo todo. A orientação da Anthropic é dizer o que a skill faz e quando usá-la, escrevendo em terceira pessoa.
Essa é a primeira coisa que falta a um prompt salvo. O prompt espera que você o cole. A skill tem um gatilho, então o assistente pode acioná-la sem ser chamado. Todo o resto de uma boa skill decorre de levar o gatilho a sério.
A anatomia tem seis partes. O gatilho diz quando disparar. As entradas dizem o que o usuário precisa fornecer e o que é opcional. Os passos são as instruções, em ordem. As ferramentas nomeiam tudo o que a skill precisa acessar fora do chat. Os exemplos mostram entradas reais ao lado das saídas aceitas. O formato de saída define a forma da resposta, o que torna os resultados comparáveis entre execuções.
Os exemplos merecem a maior atenção. Eles cumprem dupla função: os mesmos pares de entrada e saída que ensinam ao assistente o que você quer também viram os casos de teste que avisam quando uma edição quebrou algo. Sem eles, você só escreveu um prompt dentro de uma pasta.
As skills estão convergindo para um único formato de arquivo
Uma boa notícia para quem teme o lock-in: o formato está se consolidando. A Anthropic publicou o Agent Skills como um padrão aberto de portabilidade entre plataformas em 2025, e a especificação pública está em agentskills.io. Uma skill é um diretório com um SKILL.md obrigatório, pastas opcionais scripts/, references/ e assets/, um name de até 64 caracteres entre letras minúsculas, números e hifens, e uma description de até 1.024 caracteres (especificação do Agent Skills).
A documentação da OpenAI diz que as skills dela se baseiam nesse mesmo padrão aberto. Cada skill é um diretório com um SKILL.md obrigatório, com frontmatter de nome e descrição, e você a invoca explicitamente com @ no ChatGPT ou $ no Codex, ou deixa o modelo escolher pela descrição (OpenAI). A documentação do Gemini CLI do Google diz que as skills dele seguem o mesmo padrão (documentação do Gemini CLI), e as páginas de ajuda do app Gemini dizem que você pode importar skills criadas em outras plataformas enviando os arquivos SKILL.md (Gemini Help). Não encontramos nenhuma declaração do Google de que o app implemente a especificação aberta completa, então teste um upload antes de depender dele.
Ou seja, o núcleo portátil já conta com três fornecedores. O Claude e o Claude Code leem esse formato, o ChatGPT e o Codex também, segundo a OpenAI, e o Google Gemini aceita uploads dele. Mantenha a mesma pasta como fonte da verdade e rode seus exemplos de novo após cada upload. O upload do Gemini rejeita formatos binários como .docx e bloqueia scripts que chamam sites externos (Gemini Help).
Escreva a skill para sobreviver à mudança
Portabilidade é, em grande parte, disciplina. Quatro hábitos resolvem quase tudo.
- Mantenha a fonte da verdade numa pasta comum sob controle de versão, nunca só dentro do editor de um fornecedor. A cópia no fornecedor é um deploy.
- Escreva instruções que nomeiem resultados e formatos, não recursos de produto. "Devolva uma tabela com três colunas" funciona em qualquer lugar. "Use o painel canvas" não.
- Coloque tudo o que for longo (guia de estilo, schema, política) em um arquivo de referência próprio e linke a partir do
SKILL.mdcom apenas um nível de profundidade. A Anthropic alerta que cadeias mais fundas acabam sendo lidas só em parte. - Seja breve. A Anthropic recomenda um corpo com menos de 500 linhas, e a especificação aberta sugere ficar abaixo de cerca de 5.000 tokens de instruções.
Veja como isso fica numa tarefa que a maioria das equipes repete: o update semanal para o cliente.
---
name: drafting-client-updates
description: Drafts a weekly client status update from raw project notes. Use when the user pastes notes, a ticket export or a standup log and asks for a client-ready update.
metadata:
owner: ops-team
version: "1.2"
---
# Drafting client updates
## Inputs
- Required: raw notes for the week
- Optional: client name, tone (default: plain and direct)
## Steps
1. Group items into Done, In progress and Blocked.
2. Drop internal ticket IDs and jargon.
3. Lead with the one thing the client must decide, if any.
## Output
Use the template in references/update-template.md.
## Examples
See examples/ for three accepted drafts.Repare no que não está lá: nada de bajulação, nada de "você é um gerente de contas de classe mundial", nenhuma explicação do que é um update de status. O assistente já sabe. O conselho da própria Anthropic é questionar cada parágrafo perguntando se ele justifica o custo em tokens e acrescentar apenas o contexto que o modelo não tem.
Repare também no bloco metadata. A especificação aberta o define como um mapa livre de chave e valor, o que o torna um bom lugar para o responsável e o número da versão. Confira se a sua plataforma o mantém na importação.
Teste como software, porque é software
A linha mais útil do guia de criação da Anthropic é montar as avaliações antes de escrever uma documentação extensa. O ciclo é curto. Rode o assistente em tarefas representativas sem a skill e anote onde ele falha. Escreva três cenários que exponham essas lacunas. Acrescente só o suficiente de instruções para passar neles. Depois compare com a linha de base.
Três é o mínimo da Anthropic, listado no checklist de pré-compartilhamento, e é um piso. Separe de cinco a dez entradas reais do seu trabalho e guarde as saídas que você de fato aceitou. Essa pasta é a sua suíte de regressão. A cada edição e a cada mudança de plataforma, rode as entradas de novo e leia as diferenças. É barato e é a única coisa que pega a deriva silenciosa.
Teste em vários modelos também. O guia da Anthropic diz que uma skill que funciona perfeitamente no modelo mais potente pode precisar de mais detalhes no modelo pequeno, então rode em todos os modelos que pretende usar. O mesmo vale ao trocar de fornecedor. Uma skill ajustada num assistente não está testada em outro até você rodar os exemplos lá.
Se quiser ferramentas, o Promptfoo roda casos salvos contra prompts em CI, e o PromptLayer acompanha versões e execuções de prompts. Nosso ranking de ferramentas de prompt engineering traz mais opções. Nenhuma é obrigatória. Uma pasta de exemplos e um checklist levam você bem longe, e nosso playbook de prompts duráveis cobre os padrões que resistem quando o modelo por baixo muda.
Onde o MCP entra
Uma skill diz ao assistente como fazer um trabalho. Ela não dá acesso a nada. Para isso você precisa de ferramentas, e o jeito portátil de fornecê-las é o Model Context Protocol, um padrão aberto para conectar aplicações de IA a sistemas externos que a documentação compara a uma porta USB-C (documentação do MCP). Claude, ChatGPT, Cursor e VS Code estão entre os clientes listados. O repositório de servidores do Model Context Protocol é um bom lugar para ver exemplos funcionando.
A documentação de plugins da OpenAI traça a linha com clareza: use a skill para instruções de fluxo de trabalho e o servidor para dados ao vivo, autorização e ações controladas. Se uma skill exige um servidor MCP, ela declara a dependência em agents/openai.yaml. Skills importadas do servidor MCP de um plugin durante o envio viram um snapshot no rascunho, e o ChatGPT e o Codex não as buscam no seu servidor em tempo de execução (OpenAI Developers). Na prática, depois de alterar a skill você precisa refazer o deploy do servidor e escaneá-lo de novo antes de enviar uma nova versão do plugin.
A Anthropic traz uma pequena regra de autoria que poupa tempo real de depuração. Referencie ferramentas MCP por nomes totalmente qualificados, ServerName:tool_name, porque um nome solto pode falhar na resolução quando vários servidores estão conectados.
A Shopify mostra para onde isso caminha. Ela expõe um servidor MCP hospedado para agentes servidor a servidor e o padrão proposto WebMCP para agentes de navegador, e acaba de adicionar ferramentas de get, update e complete checkout para que um agente leia a tela de checkout e envie um pedido com a autorização do comprador, em vez de fazer scraping de páginas (TechCrunch). Se você tem uma loja na Shopify, a camada de ferramentas está virando algo que a plataforma entrega pronto. O papel da sua skill é o julgamento em torno dela.
Os anúncios da própria OpenAI apontam na mesma direção. O ChatGPT agora sugere apps no meio da conversa, e a empresa cita 1,2 bilhão de usuários semanais (TechCrunch), e a OpenAI disse que a atualização dos plugins passou a dar suporte à especificação proposta MCP Events, que permitiria que eventos de apps conectados iniciem automações (TechCrunch). Quanto mais as suas ferramentas ficam atrás do MCP, menos importa o formato de plugin de qualquer assistente.
Como compartilhar com a equipe sem criar uma segunda bagunça
Onde a skill mora define quem pode usá-la, e as regras variam por produto. Na documentação do Claude, as skills personalizadas no claude.ai pertencem ao usuário individual, então cada colega precisa fazer o upload separadamente e os administradores não conseguem distribuí-las de forma centralizada. Na API, elas valem para todo o workspace. No Claude Code, ficam numa pasta pessoal ou no diretório .claude/skills/ de um projeto, o que significa que viajam junto com o repositório.
A resposta do repositório é a melhor para a maioria das equipes. Coloque as skills no git, revise as mudanças como código, marque releases e deixe as pessoas puxarem. Copiar um zip entre notebooks é o caminho para acabar com sete versões da skill de update de cliente e nenhuma ideia de qual é a certa.
Toda skill compartilhada precisa de um responsável nomeado, uma versão e uma linha de changelog por edição. Também precisa de uma revisão de segurança. A documentação da Anthropic diz para tratar skills como software instalado, auditar scripts embutidos e desconfiar de qualquer skill que busque URLs externas, porque o conteúdo buscado pode carregar instruções maliciosas. Isso vale para skills escritas por colegas e para as de coleções públicas como o SkillsMP, que indexa skills de repositórios públicos do GitHub.
Use o avaliador abaixo em uma skill que você já tenha. É um checklist nosso, não um padrão, e é direto de propósito. Gatilho, exemplos, conjunto de testes e cópia fora da plataforma valem em dobro porque as seções acima argumentam que são eles que decidem se uma skill pode ser testada e movida.
Um checklist de migração para cada assistente salvo
Faça isso uma vez por assistente, antes que o fornecedor force a mão. A maior parte do tempo vai para encontrar os arquivos de conhecimento originais.
O passo de rodar de novo é o mais importante e o mais pulado. Um Gem convertido que parece bom mas mudou em silêncio o formato de saída é pior do que um que quebrou de forma visível, porque ninguém percebe por um mês. Se as saídas salvas não baterem, corrija a skill, não as suas expectativas.
Escreva a frase do gatilho mesmo para assistentes que você invoca manualmente. O exercício obriga você a decidir para que a coisa serve, e alguns assistentes salvos acabam sendo dois trabalhos com um só nome. Separe-os.
Quando não criar uma skill
A maioria dos prompts não deveria virar skill. Uma tarefa que você vai executar duas vezes é um prompt. Empacotá-la custa mais do que economiza, e uma skill sem manutenção que dispara na hora errada é pior do que nenhuma, porque polui o conjunto do qual o assistente escolhe.
Passos fixos, sem julgamento, muitas vezes ficam melhor como uma automação simples. Se toda execução tem o mesmo gatilho, as mesmas chamadas de API e a mesma saída, uma ferramenta de workflow como o n8n ou o Zapier é mais barata e previsível do que pedir a um modelo que siga uma receita (nosso guia de agentes versus ferramentas de automação trata dessa divisão). Recorra a uma skill quando o trabalho exigir linguagem, julgamento ou entradas bagunçadas.
E quando o próprio caminho muda a cada entrada, o que você quer é um agente, com skills e ferramentas como peças que ele pode pegar. Nosso ranking de agentes de IA classifica as opções. A comparação abaixo é um agrupamento editorial nosso, não uma especificação de fornecedor nem dados medidos. Um visto significa que as seções acima sustentam a afirmação, como skills carregando por correspondência de descrição ou plugins adicionando um servidor de ferramentas ao vivo. Um meio círculo significa que depende do fornecedor ou da configuração, como nos formatos de plugin que diferem por assistente.
Se ainda ficar na dúvida, a árvore abaixo resolve a maioria dos casos em três perguntas. Para um panorama maior sobre como escolher ferramentas e hábitos que duram, veja nosso guia prático de prompt engineering e nosso ranking das melhores ferramentas de IA para prompt engineers.
Um último dado sobre o momento. A OpenAI diz que melhorou a forma como o diretório de plugins ranqueia e recomenda plugins (TechCrunch), e o marketplace corporativo dela foi lançado com mais de 30 parceiros, incluindo Adobe, Figma e Salesforce (TechCrunch). Uma skill documentada e testada é algo que você pode enviar, compartilhar ou aposentar no seu próprio ritmo. Um prompt salvo é algo que você só pode torcer para o fornecedor manter.
Perguntas frequentes
Gems, GPTs personalizados e skills são a mesma coisa?
Eles se sobrepõem, mas não são idênticos. Os três salvam instruções para reutilização. As skills acrescentam um gatilho baseado em descrição e, no formato aberto, scripts e arquivos de referência carregados só quando necessário. Gems e GPTs personalizados eram, na maior parte, instruções mais conhecimento enviado, dentro do editor de um único fornecedor.
Meus Gems vão virar skills sem trabalho nenhum?
O Google diz que a migração é automática e não exige ação dos usuários, e que os arquivos compatíveis acompanham o Gem. O texto das suas instruções deve passar sem problemas. Confira, rodando seus exemplos salvos, se os arquivos anexados, o acesso compartilhado e qualquer formato de saída de que você dependia continuam se comportando do mesmo jeito.
Uma mesma skill pode rodar no Claude, no ChatGPT e no Gemini?
O formato SKILL.md é um padrão aberto, e as documentações da Anthropic e da OpenAI o descrevem. O app Gemini do Google também aceita uploads de SKILL.md, com limites para scripts e tipos de arquivo. Em qualquer um dos três, mantenha uma pasta como fonte e rode seus exemplos de novo após cada upload.
Qual deve ser o tamanho de uma skill?
Curto. A Anthropic recomenda um arquivo principal com menos de 500 linhas, e a especificação aberta sugere manter as instruções abaixo de cerca de 5.000 tokens. Mova referências longas para arquivos separados, que só são carregados quando necessário.
Preciso de MCP para criar uma skill?
Não. Uma skill com instruções, exemplos e um template não precisa de ferramenta nenhuma. Adicione o MCP quando a skill precisar ler dados ao vivo ou executar ações, e mantenha as permissões no servidor, não nas instruções.
Quem deve ser o responsável pelas skills de uma equipe?
Uma pessoa nomeada por skill, mais um repositório compartilhado. Ser responsável significa responder a dúvidas, revisar edições e rodar os exemplos de novo após mudanças de plataforma. Sem isso, as skills se deterioram no mesmo ritmo das wikis que deveriam substituir.