O GitHub publicou em 12 de outubro de 2026 um novo capítulo da série GitHub Copilot app for Beginners, dedicado a um desafio recorrente para equipes que usam assistentes de código: fazer o Copilot entender as particularidades de um repositório. O texto é assinado por Christopher Harrison, identificado no blog como @geektrainer, e organiza o tema em quatro mecanismos de personalização — instruções personalizadas, skills de agente, agentes customizados e servidores MCP (Model Context Protocol).
Segundo o autor, a premissa é que todo código tem regras próprias de casa: como os componentes são estruturados, quais scripts devem ser executados e quais convenções valem para diferentes frameworks e tipos de arquivo. O Copilot consegue fazer alterações em um projeto, mas rende mais quando conhece essas regras.
Boa parte desse conhecimento pode ficar dentro do próprio repositório, para que o assistente o absorva automaticamente, em vez de obrigar a pessoa a repetir os mesmos padrões, scripts e fluxos a cada nova tarefa, como explica a matéria original.
Instruções personalizadas definem o padrão
O primeiro passo são as instruções personalizadas de repositório. Basta adicionar um arquivo .GitHub/copilot-instructions.md para registrar orientações que valem para todo o projeto, como arquitetura preferida, convenções de nomenclatura e expectativas de teste e validação.
O exemplo dado na matéria é um pedido para adicionar um tamanho de página personalizado a uma aplicação: fazer a mudança é só parte do trabalho, porque o código novo também precisa seguir os padrões que o time já usa. Também é possível criar arquivos de instrução específicos por caminho dentro de .GitHub/instructions.
Esses arquivos usam um campo applyTo para indicar quando a orientação é relevante, e o Copilot pode combinar as regras gerais do repositório com as mais específicas quando trabalha em um arquivo correspondente.
Skills empacotam procedimentos repetíveis
Algumas orientações só importam durante um procedimento determinado, como rodar verificações de qualidade, preparar um lançamento ou depurar um fluxo de trabalho que falhou. Para isso existem as skills de agente: uma pasta com instruções e, opcionalmente, scripts e outros recursos que o Copilot carrega quando são relevantes.
Skills de projeto podem ficar em .GitHub/skills, cada uma em sua própria subpasta. A matéria cita o exemplo de .GitHub/skills/quality-checks, com um arquivo SKILL.md que explica quando o Copilot deve usar a skill, quais scripts rodam testes e linting e como solucionar falhas comuns.
A descrição no SKILL.md ajuda o Copilot a decidir quando a skill se aplica, depois de atualizar a interface, ele pode carregar a skill de verificações de qualidade e seguir o processo já estabelecido, em vez de adivinhar quais comandos executar.
Agentes customizados e servidores mcp
Tarefas maiores que um único procedimento pedem outro recurso. Uma revisão de acessibilidade, por exemplo, pode exigir inspeção de componentes, templates, estilos e interações em vários arquivos.
Os agentes customizados permitem criar versões especializadas do Copilot para esse tipo de trabalho: um perfil de agente no nível do repositório fica em .GitHub/agents e define propósito, instruções, ferramentas e contexto relevante do projeto. Já os servidores MCP ampliam o que o Copilot acessa além do repositório, conectando-o a ferramentas, fontes de dados e serviços externos.
Um servidor de documentação pode dar acesso a guias de framework, enquanto o Playwright permite abrir e interagir com a aplicação no navegador. Depois de configurá-lo, é possível pedir algo como usar o servidor MCP do Playwright para testar a funcionalidade manualmente, e o Copilot interage com a aplicação como uma pessoa faria, verificando não só se o código passa nas checagens automáticas, mas se a interface atualizada se comporta como esperado.
O que muda para as equipes
Os quatro recursos resolvem problemas diferentes e ficam mais úteis quando combinados: instruções definem convenções, skills empacotam procedimentos repetíveis, agentes oferecem especialização para tarefas amplas e servidores MCP trazem ferramentas e dados externos. O texto encerra propondo duas perguntas para identificar por onde começar: qual convenção de projeto você vive explicando de novo e qual procedimento de várias etapas você repete.
Na prática, isso desloca parte do contexto do assistente para dentro do repositório, onde pode ser versionado, revisado e compartilhado. Em vez de cada pessoa calibrar o Copilot do zero, o time passa a manter um conjunto de instruções e skills que qualquer integrante, inclusive quem chegou agora, aproveita desde a primeira tarefa.
Fontes e links
- GitHub
- Instruções personalizadas de repositório (documentação)
- Sobre skills de agente (documentação)
- Sobre servidores MCP (documentação)
