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

> Skills do Claude Code, e skills de agentes em geral, são pastas com um arquivo `SKILL.md` de instruções que o agente carrega quando a tarefa combina com a descrição da skill. O Tallos traz sete skills que ensinam os agentes a pilotar o Tallos e as instala sozinho, offline, nos agentes de código que encontra na primeira abertura, reparando nas aberturas seguintes. As skills que você já usa continuam funcionando.

- Canonical: https://runtallos.com/pt/recursos/skills-de-agentes
- English: https://runtallos.com/features/agent-skills.md
- Autor: [Roberto Rocha](https://www.instagram.com/robertorochamkt/)
- Atualizado em: 2026-09-30
- Section: Recursos

## Em resumo

- Uma skill é uma pasta com `SKILL.md`: nome, descrição e instruções
- 7 skills do Tallos, instaladas offline na primeira abertura
- Cópias ausentes ou desatualizadas reparadas nas aberturas seguintes
- **Instalar agora** / **Reinstalar** em Configurações → Geral → Skills do agente
- Skills de outras fontes nunca são tocadas

## 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](https://runtallos.com/pt/integracoes/claude-code), [Codex](https://runtallos.com/pt/integracoes/codex), [Gemini CLI](https://runtallos.com/pt/integracoes/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.

**Instruções num prompt**
- Você cola tudo de novo a cada sessão
- O texto inteiro ocupa o contexto desde o início
- Difícil de compartilhar e manter igual no time

**Instruções numa skill**
- Carregada quando a tarefa combina com a descrição
- Só nome e descrição são lidos de início
- Uma pasta que você commita, copia e revisa como código

## 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.

| Skill | O que faz | Quando o agente recorre a ela |
| --- | --- | --- |
| `tallos-cli` | Opera worktrees, terminais, repositórios, automações e o navegador integrado do Tallos pelo comando `tallos` | "Passe isso para outro agente", "abra o Codex numa worktree", "leia aquele terminal" |
| `orchestration` | Coordena workers supervisionados: despacho de tarefas, mensagens, perguntas bloqueantes, pontos de decisão | Dividir o trabalho entre vários agentes e supervisioná-los |
| `tallos-linear` | Trabalha a partir de um ticket do Linear pela CLI do Tallos: ler, mudar status, comentar, anexar o PR, criar tickets de continuação | Começar ou terminar o trabalho de uma issue do Linear vinculada |
| `tallos-emulator` | Controla um iOS Simulator no macOS pelo painel de emulador do Tallos | Uma mudança no iOS precisa de evidência no simulador |
| `tallos-emulator-android` | Controla um emulador ou aparelho Android via adb | Testar um build Android no macOS ou no Windows |
| `tallos-per-workspace-env` | Monta e depura a receita de ambiente por workspace: sandbox na nuvem, VM, host SSH ou container local | Cada workspace precisa do próprio ambiente descartável |
| `computer-use` | Opera janelas de apps nativos visíveis pela árvore de acessibilidade | Uma tarefa de interface que nenhuma CLI, API ou edição de arquivo resolve |

_Skills incluídas no Tallos_

É a skill `orchestration` que permite a um agente coordenar outros, a mesma base que o líder usa nas [squads](https://runtallos.com/pt/recursos/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](https://runtallos.com/pt/recursos/cli-e-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.

| Agente | Pasta global de skills |
| --- | --- |
| Codex e agentes que leem a pasta compartilhada | `~/.agents/skills` |
| Claude Code | `~/.claude/skills` |
| Gemini CLI | `~/.gemini/skills` |
| Grok | `~/.grok/skills` |

_Onde o Tallos coloca as skills (`~` é a sua pasta pessoal, `%USERPROFILE%` no Windows)_

## 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](https://runtallos.com/pt/aprenda/conectar-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. → https://runtallos.com/signup

## 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. **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. **Crie a pasta** — Use letras minúsculas e hífens, por exemplo `release-notes`, e repita o mesmo valor em `name` no frontmatter.
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. **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. **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.

```markdown
---
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](https://runtallos.com/pt/recursos/workspaces-paralelos) que o Tallos cria a partir desse repo.

> **Skills podem rodar código** — Uma skill pode mandar o agente executar scripts. Leia uma skill de terceiros antes de instalar, do mesmo jeito que você leria um script de shell.

## 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](https://runtallos.com/pt/recursos/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.

## Perguntas frequentes

### O que são skills do Claude Code?

Skills do Claude Code são pastas com um arquivo `SKILL.md`: nome, descrição e instruções que o Claude Code carrega quando a tarefa combina com a descrição. A skill também pode trazer scripts e arquivos de referência.

### Onde coloco uma skill personalizada no Claude Code?

Use `~/.claude/skills/<nome>/SKILL.md` para uma skill pessoal, ou `.claude/skills/<nome>/SKILL.md` dentro do repositório para compartilhar com todo mundo que trabalha nele.

### Quais skills o Tallos instala?

`tallos-cli`, `orchestration`, `tallos-linear`, `tallos-emulator`, `tallos-emulator-android`, `tallos-per-workspace-env` e `computer-use`, além de `linear-tickets`, o nome antigo da `tallos-linear`.

### O Tallos precisa de internet para instalar as skills?

Não. As skills vêm dentro do app e são copiadas offline para as pastas de skills dos seus agentes, sem `npx` e sem baixar repositório.

### O Tallos vai sobrescrever ou apagar minhas skills?

Não. O Tallos só gerencia as próprias skills. A passada automática na abertura nunca descarta edições locais; só o **Reinstalar** substitui cópias modificadas das skills do Tallos.

### E se eu instalar um agente novo depois do Tallos?

Na próxima abertura, o Tallos detecta o agente novo e instala as skills nele também. Você também pode clicar em **Instalar agora** ou **Reinstalar** em Configurações → Geral → Skills do agente.

### Qual a diferença entre uma skill e um servidor MCP?

A skill é um conjunto de instruções que o agente lê; o servidor MCP é um programa ou endpoint que dá novas ferramentas ao agente. Muitos setups usam os dois.

## Fontes

1. [Agent Skills overview](https://agentskills.io/home) — Agent Skills (open standard)
2. [Extend Claude with skills](https://code.claude.com/docs/en/skills) — Anthropic
3. [Skills & plugins](https://learn.chatgpt.com/docs/skills-and-plugins) — OpenAI
4. [Agent Skills in Gemini CLI](https://geminicli.com/docs/cli/skills/) — Google

---

**Rode seus agentes em paralelo com o Tallos** — Claude Code, Codex, Gemini e mais de 30 agentes — cada um no seu workspace, com squads, chat, terminais e revisão num só app. Usa as assinaturas que você já tem.

https://runtallos.com/signup (macOS 13+ · Windows 10+)