Skip to main content
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.

O que são Skills?

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

Invocação via comando de barra

Os usuários podem invocar skills com /skill-name no chat.

Autonomia do agente

O agente pode invocar skills por conta própria quando relevante.

Permissões com escopo

As skills podem ter suas próprias permissões e restrições.

Ferramentas aprovadas automaticamente

Aprove previamente as ferramentas de que uma skill precisa para que ela execute sem prompts de permissão.

Execução como subagente

Execute skills como subagentes independentes, com sua própria janela de contexto.

Override de modelo

Use um modelo diferente para skills específicas.

Exemplo rápido

Crie uma skill de revisão de código em .devin/skills/review/SKILL.md (ou .windsurf/skills/review/SKILL.md):
Agora você pode usá-lo com /review em qualquer sessão.

Como as Skills funcionam

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)
allowed-tools e permissions se aplicam a skills executadas inline. Uma skill executada como subagente (subagent: true ou agent:) obtém seu acesso a ferramentas do perfil de subagente.

Gatilhos de skill

As skills podem ser invocadas de duas formas:
Defina triggers: [user] para impedir que o agente acione uma skill por conta própria.

Skills de terceiros

Oferecemos suporte aos padrões de skills .agents, então as ferramentas de instalação de skills de terceiros funcionam com o Devin CLI.
Skills de terceiros podem executar código arbitrário, então instale-as por sua conta e risco.

Onde os skills ficam

Os skills podem ter escopo de um único projeto ou ser compartilhados entre todos os projetos: 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) 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.
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/.

Próximas etapas

Criando Skills

Conheça o formato completo de uma skill, incluindo opções de frontmatter, conteúdo dinâmico e exemplos.

Plugins

Reúna skills em um plugin que você pode instalar e compartilhar entre projetos.