Skills e agentes personalizados no Copilot CLI
VPS Agêntica
30% off na sua VPS Agêntica nos 2 primeiros meses
A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.
Link de parceiro da Promovaweb.
Black Friday até 30/11
30%off
nos 2 primeiros meses do plano mensal da VPS
- Backup diário grátis para sempre
- Servidores em São Paulo no datacenter da Ascenty
- Datacenter Tier III manutenção sem parada
- Acesso root com disco SSD NVMe
- Réplica do backup em Ashburn, nos EUA
As skills do GitHub Copilot CLI são pastas com instruções, scripts e recursos que o agente carrega quando a tarefa exige um procedimento específico. Os agentes personalizados definem papéis reutilizáveis, com instruções e ferramentas próprias, que rodam como subagentes numa janela de contexto separada da conversa principal.
Sumário da página
Uma skill que só entra quando faz falta
Você mantém um procedimento para gerar as notas de release do projeto, com o formato das notas, o script que coleta os commits e o modelo do texto. Escrever tudo isso no arquivo de instruções faria o texto entrar em toda mensagem, até quando você só quer corrigir um teste. Uma skill guarda esse procedimento numa pasta própria. O Copilot carrega o conteúdo quando a tarefa exige.
Para o GitHub, as skills são pastas de instruções, scripts e recursos que aumentam o acerto do Copilot em tarefas especializadas. O arquivo SKILL.md descreve a skill e define o nome dela, que costuma ser o mesmo nome da pasta. Ao adicionar skills a um projeto, você entrega ao agente conhecimento ou ferramentas para um fluxo, uma tecnologia ou um domínio específico.
As pastas ficam em .github/skills/, .claude/skills/ ou .agents/skills/ no repositório, e em ~/.copilot/skills/ ou ~/.agents/skills/ na sua pasta pessoal. Cada skill ocupa uma subpasta com o próprio nome.
Como você conversa com as skills
O Copilot escolhe sozinho quando uma skill é relevante, mas você também pode chamar uma pelo nome, precedido de barra. Um prompt como “Use a skill /frontend-design para criar uma barra de navegação responsiva em React” aciona a skill indicada. O comando /skills list mostra as skills disponíveis. A pergunta “Quais skills você tem?” dá o mesmo resultado em linguagem natural.
O comando /skills abre a lista para ligar ou desligar cada skill. O /skills info mostra os detalhes de uma skill, inclusive onde ela está e de qual plugin veio. O /skills add acrescenta outra pasta de skills, o /skills reload carrega uma skill criada durante a sessão sem reiniciar o CLI e o /skills remove apaga uma skill adicionada diretamente. Skills que chegaram por plugin saem pela gestão do próprio plugin.
As mesmas operações existem fora da conversa, pelo subcomando copilot skill. O copilot skill list lista as skills e o copilot skill add aceita um arquivo, uma URL ou uma pasta. Os subcomandos disable e enable desligam e religam uma skill. Esse caminho serve para scripts que preparam o ambiente antes da sessão começar.
Agentes personalizados definem um papel
Um agente personalizado é uma versão especializada do agente do Copilot, ajustada para um tipo de tarefa. O perfil do agente é um arquivo Markdown com frontmatter YAML. Nele ficam o propósito, as instruções e, quando você quiser, a lista restrita de ferramentas. Em ambientes compatíveis, o perfil também configura servidores MCP só para aquele agente.
O exemplo da documentação mostra o valor da restrição: um revisor que lê e busca arquivos, mas não recebe ferramentas de edição. Um especialista em documentação que segue o seu padrão de escrita é outro caso citado. Os perfis podem ser compartilhados no repositório, na organização e na empresa. O Copilot CLI aceita também perfis pessoais. O mesmo perfil funciona no app do GitHub Copilot, no agente de nuvem do Copilot e em IDEs como o VS Code, embora uma propriedade possa se comportar de outro jeito em cada ambiente.
Agente principal
Recebe a sua instrução e identifica uma parte que pode ser delegada.
Delegação
Escolhe um agente embutido ou um perfil personalizado para a tarefa.
Subagente
Trabalha com as próprias ferramentas e a própria janela de contexto.
Resultado
Volta à conversa principal sem os passos intermediários.
Os agentes embutidos já cobrem o trabalho comum
Você não precisa criar um perfil para cada especialidade. O Copilot CLI traz agentes embutidos que o agente principal usa no trabalho do dia a dia: explore para explorar o código, task para executar comandos, general-purpose para trabalho que exige uma janela de contexto separada, code-review para revisar mudanças, research para pesquisa, rubber-duck para uma segunda opinião e security-review para uma revisão focada em segurança. Cada um tem ferramentas e comportamento próprios.
O subagente executa, o perfil define
A documentação separa os dois conceitos. Um agente personalizado é a definição de um especialista. Um subagente é um agente fazendo um trabalho delegado numa janela de contexto separada. O agente principal pode delegar a um agente embutido ou rodar um especialista com um perfil personalizado. A janela de contexto separada deixa o subagente focado na tarefa, sem encher a conversa principal com cada passo intermediário. Tarefas independentes também podem rodar em paralelo.
Escolher um agente personalizado para a sessão inteira é diferente de delegar uma subtarefa a ele. No Copilot CLI, as instruções do repositório entram para o agente da sessão, mas não entram para um subagente personalizado, a menos que você ative essa opção. Vale conferir esse ponto quando um subagente ignora uma convenção que o agente principal segue sem problema.
Um agente personalizado também pode usar um modelo próprio. O GitHub descreve o uso de um modelo hospedado na sua máquina para uma parte focada da tarefa: você configura o agente com esse modelo e orienta o agente principal a delegar a ele. A escolha não muda o modelo da sessão principal.
Skill, agente ou instrução
A documentação resume a escolha em duas situações. Para instruções e recursos de um tipo de tarefa, a skill costuma ser o caminho mais simples. Para um papel reutilizável, com uma abordagem e um conjunto de ferramentas próprios, o agente personalizado atende melhor. O que vale para toda tarefa do projeto continua no arquivo de instruções, explicado no hub de instruções e memória.