Skills de agentes no Claude Code, Codex e Gemini CLI: exemplos, skills incluídas e as suas

O que é uma skill de agente?

Uma skill de agente é uma pasta com um arquivo SKILL.md: um frontmatter YAML com name e description, seguido de instruções em Markdown. A pasta também pode ter scripts, templates ou arquivos de referência que as instruções citam. Claude Code, Codex, Gemini CLI e outros agentes leem skills de pastas conhecidas no seu computador ou no seu repositório.

Skills são carregadas sob demanda. O agente vê o nome e a descrição de cada skill logo de início e só lê as instruções completas quando a tarefa combina, então uma lista longa de skills custa pouco até uma delas ser necessária. Por isso a descrição é a linha mais importante do arquivo.

Como é uma skill na prática? Exemplos do Tallos

O Tallos traz sete skills dentro do app. Cada uma faz uma coisa só e tem uma descrição que diz exatamente quando usá-la, o que faz delas bons exemplos de como delimitar uma skill.

É a skill orchestration que permite a um agente coordenar outros, a mesma base que o líder usa nas squads. O Tallos também traz linear-tickets, o nome antigo da tallos-linear, para que instalações feitas com esse nome continuem funcionando.

Os arquivos instalados são curtos de propósito: dizem ao agente quando usar o Tallos e depois carregam o guia completo, da mesma versão do app, pelo comando tallos. Como isso funciona, e todos os grupos de comandos, está na página da CLI tallos e das skills.

Como o Tallos instala skills no Claude Code, Codex e Gemini CLI?

Sozinho e offline. Logo depois que o app abre, o Tallos detecta os agentes de código instalados no seu computador e copia as skills incluídas para a pasta global de skills de cada um. Nada é baixado: sem npx, sem clonar repositório.

• Primeira abertura: instala todas as skills incluídas em cada agente detectado.
• Aberturas seguintes: repara skills que sumiram e reinstala quando uma atualização do Tallos muda as skills incluídas ou quando um agente recém-instalado é detectado.
• Nenhum agente ainda: nada é gravado. Instale um agente e clique em Instalar agora, ou deixe a próxima abertura resolver.
• Falhas são repetidas: uma skill que falhou é tentada de novo na abertura seguinte.
• Edições locais sobrevivem à passada automática: ela nunca descarta mudanças feitas numa cópia instalada. Reinstalar substitui cópias modificadas das skills do próprio Tallos pela versão original.

Como reinstalar ou conferir as skills do Tallos?

Abra Configurações → Geral e procure Skills do agente na seção da CLI do Tallos. Instalar agora aparece quando as skills não foram detectadas e Reinstalar quando já foram; os dois rodam a mesma instalação offline. Verificar novamente atualiza o status.

Se nenhum agente de código for detectado, o Tallos pede para você instalar um, como o Claude Code ou o Codex, e tentar de novo. O guia conecte seus agentes mostra o passo a passo. A instalação com um clique grava neste computador; num runtime remoto, o Tallos mantém a instalação pelo terminal.

Entregue as skills do Tallos aos seus agentes

Instale o Tallos e seus agentes recebem as skills na primeira abertura. Sem configuração, sem download.

Baixar o Tallos →

Como criar minha própria skill no Claude Code?

Crie uma pasta, adicione um SKILL.md com nome e descrição claros e coloque a pasta onde o seu agente lê skills. No Claude Code, é ~/.claude/skills/<nome>/ para uma skill pessoal ou .claude/skills/<nome>/ dentro do repositório para compartilhar com o time.

1. 1

   Escolha uma tarefa só

   Uma skill deve fazer uma coisa bem feita: escrever notas de release, seguir o padrão de migrations do time, investigar um teste instável. Divida assuntos amplos em várias skills.

2. 2

   Crie a pasta

   Use letras minúsculas e hífens, por exemplo release-notes, e repita o mesmo valor em name no frontmatter.

3. 3

   Escreva a descrição primeiro

   O agente decide quando carregar a skill pela descrição. Diga o que ela faz e quando usar, com as palavras que as pessoas realmente digitam: "notas de release", "changelog", "o que entrou na versão".

4. 4

   Mantenha as instruções curtas

   Passos numerados, comandos exatos e o que evitar. Material de referência longo vai para arquivos separados na pasta, citados no SKILL.md.

5. 5

   Teste numa sessão nova

   Abra uma nova sessão do agente e peça a tarefa em linguagem natural. Se a skill não carregar, deixe a descrição mais precisa.

---
name: release-notes
description: >-
  Escreve notas de release a partir dos commits desde a última tag do git.
  Use quando pedirem notas de release, uma entrada de changelog ou o que
  entrou numa versão.
---

# Notas de release

1. Encontre a última tag: `git describe --tags --abbrev=0`.
2. Liste os commits desde essa tag: `git log <tag>..HEAD --oneline`.
3. Agrupe as mudanças em Novidades, Correções e Interno.
4. Escreva uma linha simples por mudança. Ignore bumps de versão.
5. Salve o resultado em `RELEASE_NOTES.md` e mostre um resumo curto.

Deixe a skill no repositório quando ela codifica padrões do time, e na sua pasta pessoal quando é só sua. Uma skill em .claude/skills é commitada como qualquer arquivo, então existe em todo workspace paralelo que o Tallos cria a partir desse repo.

Minhas skills continuam funcionando no Tallos?

Continuam. O Tallos só instala e repara as próprias skills; skills de outras fontes nunca são tocadas. Os agentes iniciados no Tallos rodam como em qualquer terminal, então seguem carregando todas as skills pessoais e de projeto que já conheciam.

Skills e MCP se complementam. A skill é instrução; o servidor MCP é uma conexão com ferramentas de um sistema externo. Uma boa skill muitas vezes diz ao agente quando chamar uma ferramenta MCP específica.