> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral das skills

> Crie prompts e workflows reutilizáveis que ampliam os recursos do agente

Skills são unidades autônomas de funcionalidade que você pode ensinar ao Devin CLI. Elas reúnem prompts, acesso a ferramentas, permissões e workflows em um pacote reutilizável que pode ser acionado tanto pelo agente quanto pelo operador humano.

***

<div id="what-are-skills">
  ## O que são Skills?
</div>

Pense nas skills como conhecimento especializado que você fornece ao agente. Uma skill pode ensiná-lo a:

* Fazer revisão de código de acordo com os padrões da sua equipe
* Gerar um tipo específico de componente
* Executar um workflow de deployment
* Realizar uma auditoria de segurança
* Configurar um novo serviço a partir de um template

<CardGroup cols={2}>
  <Card title="Invocação via slash command" icon="code">
    Os usuários podem invocar skills com `/skill-name` no chat.
  </Card>

  <Card title="Autonomia do agente" icon="robot">
    O agente pode invocar skills por conta própria quando relevante.
  </Card>

  <Card title="Permissões com escopo" icon="shield">
    As skills podem ter suas próprias permissões e restrições.
  </Card>

  <Card title="Acesso personalizado a ferramentas" icon="wrench">
    Restrinja quais ferramentas uma skill pode usar por segurança.
  </Card>

  <Card title="Execução como subagente" icon="users">
    Execute skills como [subagentes](/pt-BR/cli/subagents) independentes, com sua própria janela de contexto.
  </Card>

  <Card title="Override de modelo" icon="brain">
    Use um [modelo](/pt-BR/cli/models) diferente para skills específicas.
  </Card>
</CardGroup>

***

<div id="quick-example">
  ## Exemplo rápido
</div>

Crie uma skill de revisão de código em `.devin/skills/review/SKILL.md` (ou `.windsurf/skills/review/SKILL.md`):

```markdown theme={null}
---
name: review
description: Review code changes before committing
allowed-tools:
  - read
  - grep
  - glob
  - exec
---

Review the current git diff and provide feedback:

1. Run `git diff --staged` (or `git diff` if nothing is staged)
2. Check for:
   - Logic errors or bugs
   - Missing error handling
   - Security issues
   - Style inconsistencies
3. Summarize findings and suggest improvements
```

Agora você pode usá-lo com `/review` em qualquer sessão.

***

<div id="how-skills-work">
  ## Como as skills funcionam
</div>

Quando uma skill é invocada:

1. O prompt da skill é inserido na conversa
2. O acesso às ferramentas fica restrito às `allowed-tools` da skill (se especificado)
3. Permissões adicionais da configuração da skill são aplicadas
4. O modelo especificado é usado (se for diferente do atual)

Depois que a skill é concluída, a sessão volta à configuração normal.

***

<div id="skill-triggers">
  ## Gatilhos de skill
</div>

As skills podem ser invocadas de duas formas:

| Gatilho | Descrição                                                | Padrão  |
| ------- | -------------------------------------------------------- | ------- |
| `user`  | O usuário pode invocar usando `/skill-name`              | Ativado |
| `model` | O agente pode invocar de forma autônoma quando relevante | Ativado |

```yaml theme={null}
---
name: security-check
triggers:
  - user
  - model
---
```

Defina `triggers: [user]` para impedir que o agente acione uma skill por conta própria.

***

<div id="third-party-skills">
  ## Skills de terceiros
</div>

Oferecemos suporte aos padrões de skills `.agents`, então as ferramentas de instalação de skills de terceiros funcionam com o Devin CLI.

<Warning>
  Skills de terceiros podem executar código arbitrário, então instale-as por sua conta e risco.
</Warning>

***

<div id="where-skills-live">
  ## Onde os skills ficam
</div>

Os skills podem ter escopo de um único projeto ou ser compartilhados entre todos os projetos:

| Local                                         | Escopo                                            | Commitado no Git? |
| --------------------------------------------- | ------------------------------------------------- | ----------------- |
| `.agents/skills/<name>/SKILL.md`              | Específico do projeto                             | Sim               |
| `.devin/skills/<name>/SKILL.md`               | Específico do projeto                             | Sim               |
| `.windsurf/skills/<name>/SKILL.md`            | Específico do projeto                             | Sim               |
| `~/.agents/skills/<name>/SKILL.md`            | Global (todos os projetos)                        | Não               |
| `~/.config/devin/skills/<name>/SKILL.md`      | Global (todos os projetos)                        | Não               |
| `~/.codeium/<channel>/skills/<name>/SKILL.md` | Global (todos os projetos, dependente do channel) | Não               |

**Skills de projeto** ficam no diretório `.devin/skills/` ou `.windsurf/skills/`, na raiz do projeto, e entram no controle de versão, o que permite compartilhá-los com sua equipe. Ambos os caminhos usam o mesmo formato `SKILL.md`.

**Skills globais** ficam em `~/.config/devin/skills/` (seguindo as [convenções XDG](https://specifications.freedesktop.org/basedir-spec/latest/)) ou `~/.codeium/<channel>/skills/` (em que `<channel>` é `windsurf`, `windsurf-next` ou `windsurf-insiders`, dependendo do channel da sua CLI) e ficam disponíveis em todos os projetos na sua máquina.

<Note>
  **Windows:** O caminho global dos skills segue o diretório de dados de aplicativos do sistema. No Windows, use `%APPDATA%\devin\skills\<name>\SKILL.md` (normalmente `C:\Users\<YourUser>\AppData\Roaming\devin\skills\<name>\SKILL.md`) em vez de `~/.config/devin/skills/`.
</Note>

***

<div id="next-steps">
  ## Próximas etapas
</div>

<CardGroup cols={2}>
  <Card title="Criando Skills" icon="plus" href="/pt-BR/cli/extensibility/skills/creating-skills">
    Conheça o formato completo de uma skill, incluindo opções de frontmatter, conteúdo dinâmico e exemplos.
  </Card>

  <Card title="Plugins" icon="box" href="/pt-BR/cli/extensibility/plugins/overview">
    Reúna skills em um plugin que você pode instalar e compartilhar entre projetos.
  </Card>
</CardGroup>