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

> Skills são prompts e workflows reutilizáveis em SKILL.md para o Devin CLI, invocados por um comando de barra ou pelo agente, com permissões próprias.

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 invocado 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 comando de barra" 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="Ferramentas aprovadas automaticamente" icon="wrench">
    Aprove previamente as ferramentas de que uma skill precisa para que ela execute sem prompts de permissão.
  </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 é injetado na conversa
2. As ferramentas listadas em `allowed-tools` da skill (se especificadas) são aprovadas automaticamente, ou seja, executam sem prompt de permissão. As ferramentas não listadas continuam disponíveis e passam pelas verificações normais de permissão
3. As `permissions` da skill (`allow`, `deny`, `ask`) são aplicadas. Use `permissions.deny` para bloquear uma ferramenta enquanto a skill está em execução
4. O modelo especificado é utilizado (se for diferente do atual)

<Note>
  `allowed-tools` e `permissions` se aplicam a skills executadas inline. Uma skill executada como [subagente](/pt-BR/cli/extensibility/skills/creating-skills#running-skills-as-subagents) (`subagent: true` ou `agent:`) obtém seu acesso a ferramentas do perfil de subagente.
</Note>

***

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.