Usar Habilidades de Agente com o GitHub Copilot

As habilidades do agente são conjuntos reutilizáveis de instruções que ensinam os agentes Copilot a executar tarefas específicas, como executar um pipeline de build, gerar códigos padrão ou seguir os padrões de codificação da sua equipe. Ao definir habilidades uma vez, você economiza tempo e garante um comportamento consistente em seu fluxo de trabalho.

As habilidades complementam agentes personalizados e instruções personalizadas. Embora os agentes personalizados definam uma persona e um conjunto de ferramentas e as instruções personalizadas definam preferências gerais de codificação, as habilidades fornecem diretrizes focadas e específicas à tarefa que qualquer agente pode descobrir e usar automaticamente.

Prerequisites

• Visual Studio 2026 versão 18.5 ou posterior
• Uma assinatura GitHub Copilot

Como funcionam as habilidades do agente

Quando você usa o modo agent, Copilot descobre automaticamente as habilidades de seu repositório e perfil de usuário. O agente decide quando uma habilidade é relevante para sua solicitação e a ativa. Quando uma habilidade é ativada, ela aparece no chat para informar que ela está sendo aplicada.

Localizações de habilidades

As habilidades são coletadas nos seguintes locais:

As habilidades do Workspace são compartilhadas com sua equipe por meio do controle do código-fonte. As habilidades pessoais se aplicam a todos os seus projetos e não são comprometidas com nenhum repositório.

Criar uma habilidade

Você pode criar uma habilidade no painel de habilidades em Visual Studio ou manualmente em seu sistema de arquivos. Para criar uma habilidade no painel de habilidades, você deve ter Visual Studio 2026 Insiders versão 18.6 ou posterior.

Criar uma habilidade no painel de habilidades

1. Selecione o ícone Tools no canto inferior direito do Copilot Chat para abrir o painel de habilidades.

2. Selecione o + botão no canto superior direito do painel.

   

3. Escolha um destino (habilidade global ou de nível de solução) e escolha um nome.

   

4. Visual Studio gera um modelo de habilidade para você preencher. Você pode usar o modo agente do Copilot para ajudar você a preencher o modelo.

Criar uma habilidade manualmente

Cada habilidade é um diretório que contém um SKILL.md arquivo que segue a especificação de agentskills.io.

1. Crie um diretório de habilidades. Para uma habilidade de espaço de trabalho, use .github/skills/ na raiz do seu repositório. Para uma habilidade pessoal, use ~/.copilot/skills/.

2. Crie um subdiretório para sua habilidade. Cada habilidade deve ter seu próprio diretório (por exemplo, .github/skills/github-issues/).

3. Crie um arquivo SKILL.md no diretório de habilidades. O arquivo contém o frontmatter YAML com metadados seguidos das instruções de Markdown.

4. Opcionalmente, adicione scripts, exemplos ou outros recursos ao diretório da sua habilidade.

Estrutura do diretório de habilidades

your-repo/
└── .github/
    └── skills/
        └── github-issues/
            ├── SKILL.md          # Required: metadata + instructions
            ├── scripts/          # Optional: executable code
            ├── references/       # Optional: documentation
            └── assets/           # Optional: templates, resources

formato SKILL.md

O SKILL.md arquivo deve conter o frontmatter YAML seguido pelo conteúdo de Markdown:

---
name: github-issues
description: Creates and manages GitHub issues following team conventions. Use when working with issue tracking, bug reports, or feature requests.
---

When creating GitHub issues:

- Use the standard title format: [Component] Brief description
- Add appropriate labels based on issue type
- Include reproduction steps for bug reports
- Link related issues and PRs

Propriedades do Frontmatter

Dicas para escrever competências eficazes

• Mantenha a SKILL.md principal abaixo de 500 linhas. Mova o material de referência detalhado para arquivos separados no references/ diretório.
• Escreva um texto claro description que inclua palavras-chave específicas para ajudar os agentes a identificar quando a habilidade é relevante.
• Inclua instruções passo a passo, exemplos e casos especiais comuns.

Gerenciar habilidades no painel de competências

Selecione o ícone Tools no canto inferior direito do Copilot Chat para abrir o painel de habilidades, uma exibição dedicada de cada habilidade descoberta. O painel Habilidades só está disponível no Visual Studio Insider 2026.

No painel, você pode:

• Editar: Abra qualquer habilidade SKILL.md diretamente no editor no menu ...
• Abrir o local do arquivo: ir para o diretório da habilidade no disco.
• Pesquisa: filtrar habilidades por nome ou palavra-chave.

O painel também apresenta o diagnóstico para quaisquer erros de configuração de habilidade, para que você possa detectar e corrigir problemas rapidamente.

Habilidades da comunidade

Consulte o repositório awesome-copilot para obter exemplos de habilidades compartilhadas pela comunidade.

Conteúdo relacionado

• Comece com o modo agente do GitHub Copilot
• Use agentes personalizados no GitHub Copilot
• Personalizar respostas de chat e definir o contexto
• Usar servidores MCP