Skip to main content
As tarefas de engenharia mais difíceis geralmente exigem mais do que apenas bons prompts. Elas podem precisar de scripts de referência, modelos, checklists e outros arquivos auxiliares. As skills permitem que você reúna tudo isso em pastas que o Cascade pode invocar (ler e usar). As skills são uma ótima maneira de ensinar o Cascade a executar workflows com várias etapas de forma consistente. O Cascade usa exposição progressiva: apenas o name e a description da skill são mostrados ao modelo por padrão. O conteúdo completo de SKILL.md e os arquivos auxiliares são carregados somente quando o Cascade decide invocar a skill (ou quando você faz @mention dela). Isso mantém sua janela de contexto enxuta, mesmo com muitas skills definidas. Para mais detalhes sobre a especificação de Skills, visite agentskills.io.

​
Como criar uma skill

​
Usando a interface (método mais fácil)

  1. Abra o painel do Cascade
  2. Clique nos três pontos no canto superior direito do painel para abrir o menu Customizations
  3. Clique na seção Skills
  4. Clique em + Workspace para criar uma skill de workspace (específica do projeto) ou em + Global para criar uma skill global
  5. Dê um nome para a skill (apenas letras minúsculas, números e hífens)

​
Criação manual

Skill de workspace (específica do projeto):
  1. Crie um diretório: .windsurf/skills/<skill-name>/
  2. Adicione um arquivo SKILL.md com front matter em YAML
Skill global (disponível em todos os workspaces):
  1. Crie um diretório: ~/.codeium/windsurf/skills/<skill-name>/
  2. Adicione um arquivo SKILL.md com front matter em YAML

​
Formato do arquivo SKILL.md

Cada skill precisa de um arquivo SKILL.md com frontmatter YAML contendo os metadados dessa skill:

​
Exemplo de skill

​
Campos obrigatórios de frontmatter

  • name: Identificador exclusivo da skill (exibido na UI e usado para menções com @)
  • description: Breve explicação mostrada ao modelo de IA para ajudá-lo a decidir quando invocar a skill
Exemplos de nomes válidos: deploy-to-staging, code-review, setup-dev-environment

​
Adicionando recursos auxiliares

Coloque quaisquer arquivos auxiliares na pasta da skill, junto com SKILL.md. Esses arquivos ficam disponíveis para o Cascade quando a skill é invocada:

​
Invocando habilidades

​
Invocação automática

Quando sua solicitação corresponde à descrição de uma skill, Cascade invoca essa skill automaticamente e usa suas instruções e recursos para concluir a tarefa. Este é o modo mais comum de usar skills — você simplesmente descreve o que quer fazer, e Cascade determina quais skills são relevantes. O campo description no frontmatter da sua skill é fundamental: ele ajuda Cascade a entender quando invocar a skill. Escreva descrições que expliquem claramente o que a skill faz e quando ela deve ser usada.

​
Invocação manual

Você sempre pode ativar explicitamente uma skill digitando @skill-name no campo de entrada do Cascade. Isso é útil quando você quer garantir que uma skill específica seja usada ou quando deseja invocar uma skill que talvez não seja acionada automaticamente pela sua solicitação.

​
Escopos de Skills

Para compatibilidade entre agentes, Windsurf também descobre skills em .agents/skills/ e ~/.agents/skills/. Se você tiver habilitado a leitura da configuração do Claude Code, .claude/skills/ e ~/.claude/skills/ também serão analisados.

​
Skills em nível de sistema (Enterprise)

As organizações Enterprise podem implantar skills que ficam disponíveis em todos os workspaces e não podem ser modificadas pelos usuários finais: Cada skill é um subdiretório que contém um arquivo SKILL.md, assim como as skills de workspace.

​
Exemplos de casos de uso

​
Fluxo de Implantação

Crie uma skill com scripts de implantação, configurações de ambiente e procedimentos de rollback:

​
Diretrizes de revisão de código

Inclua guias de estilo, listas de verificação de segurança e modelos de revisão:

​
Procedimentos de Teste

Modelos de testes de pacote, requisitos de cobertura e configurações de CI/CD:

​
Boas práticas

  1. Escreva descrições claras: A descrição ajuda o Cascade a decidir quando deve invocar a skill. Seja específico sobre o que a skill faz e em quais situações ela deve ser usada.
  2. Inclua recursos relevantes: Modelos, checklists e exemplos tornam as skills mais úteis. Pense em quais arquivos seriam úteis para alguém concluir a tarefa.
  3. Use nomes descritivos: deploy-to-staging é melhor do que deploy1. Os nomes devem indicar claramente o que a skill faz.

​
Skills vs Rules vs Workflows

Os três personalizam o Cascade, mas diferem em estrutura, invocação e custo de contexto: Regra prática: se o Cascade deve selecioná-lo automaticamente e ele precisa de arquivos auxiliares, use um Skill. Se for uma restrição comportamental curta, use uma Rule. Se você sempre quiser acioná-lo manualmente, use um Workflow. Se Skills não é o que você procura, confira estes outros recursos do Cascade:
  • Workflows - Automatize tarefas repetitivas com workflows em Markdown reutilizáveis, acionados por comandos com barra (/)
  • AGENTS.md - Forneça instruções com escopo de diretório que são aplicadas automaticamente com base na localização do arquivo
  • Memories & Rules - Preserve o contexto ao longo das conversas com memórias geradas automaticamente e regras definidas pelo usuário