🤖 GitHub Copilot e Skills - Visao Geral
O GitHub Copilot evoluiu de um simples autocomplete para um agente completo capaz de executar tarefas complexas. Com a introducao do Copilot Chat e do modo Agent, o Copilot agora le instrucoes customizadas de repositorios para adaptar seu comportamento ao contexto do projeto.
Skills no Copilot permitem que equipes definam padroes de codigo, convencoes de nomenclatura, arquitetura preferida e fluxos de trabalho especificos. O agente automaticamente descobre e aplica essas instrucoes quando trabalha no repositorio.
🔑 Capacidades do Copilot com Skills
- •Custom Instructions: Instrucoes por repositorio que guiam o comportamento do agente
- •Context Awareness: Copilot entende a estrutura e padroes do projeto
- •Multi-file Editing: Agente pode editar multiplos arquivos seguindo skills
- •Terminal Access: Pode executar comandos seguindo instrucoes da skill
📁 Repo-level Skills com .github/copilot/
O diretorio .github/copilot/ e o local padrao para armazenar skills especificas de um repositorio no GitHub Copilot. Qualquer arquivo de instrucao colocado neste diretorio sera automaticamente descoberto pelo Copilot quando alguem trabalhar no repositorio.
Esta abordagem e poderosa para equipes, pois as skills ficam versionadas junto com o codigo. Qualquer membro da equipe que clonar o repositorio tera as mesmas instrucoes aplicadas automaticamente, garantindo consistencia.
Estrutura de Diretorios
meu-projeto/
├── .github/
│ └── copilot/
│ ├── SKILL.md # Skill principal do repo
│ ├── testing.md # Instrucoes de teste
│ └── code-review.md # Padrao de code review
├── AGENTS.md # Instrucoes globais (raiz)
├── src/
│ └── AGENTS.md # Instrucoes para /src
└── package.json💡 Dica
Voce pode combinar SKILL.md em .github/copilot/ com AGENTS.md na raiz e subdiretorios. O Copilot mescla todas as instrucoes encontradas, dando prioridade ao mais especifico (diretorio atual).
🏢 Organization-wide Skills
Alem de skills por repositorio, o GitHub Copilot suporta skills em nivel de organizacao. Isso permite que empresas definam padroes que se aplicam a todos os repositorios da org, garantindo consistencia em toda a base de codigo.
Organization skills sao configuradas via GitHub Settings e podem incluir padronizacoes de seguranca, convencoes de nomenclatura, frameworks aprovados e qualquer outra diretriz que deva ser uniforme em toda a organizacao.
Vantagens
- • Padronizacao em escala
- • Governanca centralizada
- • Onboarding automatico
- • Compliance facilitado
Hierarquia de Prioridade
- 1. Skills do diretorio atual (mais especifico)
- 2. Skills do repositorio (.github/copilot/)
- 3. Skills da organizacao
- 4. Comportamento padrao do Copilot
📋 AGENTS.md - Formato Nativo do Copilot
O AGENTS.md e o formato nativo que o GitHub criou para o Copilot e que tambem e usado pelo OpenAI Codex. Trata-se de um arquivo Markdown simples (sem frontmatter obrigatorio) que contem instrucoes free-form para o agente. O Copilot le automaticamente qualquer AGENTS.md encontrado no diretorio de trabalho ou pais.
Exemplo: AGENTS.md
# Instrucoes do Agente
## Estilo de Codigo
- Use TypeScript strict mode
- Prefira const sobre let
- Nao use any - sempre tipar explicitamente
## Testes
- Escreva testes para toda funcao publica
- Use Jest com Testing Library
- Minimo 80% de cobertura
## Git
- Commits em ingles, formato conventional commits
- Branches: feature/, fix/, chore/A principal diferenca do AGENTS.md para o SKILL.md e a ausencia de YAML frontmatter estruturado. AGENTS.md e puro Markdown, o que o torna mais simples mas menos rico em metadata para descoberta automatica.
⚖️ SKILL.md vs AGENTS.md no Copilot
No contexto do GitHub Copilot, voce pode usar ambos os formatos. Eles coexistem e se complementam. Entender quando usar cada um permite maximizar a eficacia das suas instrucoes.
| Criterio | SKILL.md | AGENTS.md |
|---|---|---|
| Metadata | YAML frontmatter rico | Sem frontmatter |
| Descoberta | Por globs e tags | Por diretorio |
| Portabilidade | Multi-plataforma | Copilot + Codex |
| Local | .github/copilot/ ou qualquer dir | Qualquer diretorio |
| Ideal para | Skills portaveis, compartilhaveis | Instrucoes rapidas, locais |
🎯 Boas Praticas para Copilot Skills
Para maximizar a eficacia de skills no GitHub Copilot, siga estas boas praticas testadas em producao por equipes de desenvolvimento de diferentes portes.
1. Seja Especifico nas Instrucoes
Em vez de "escreva bom codigo", diga "use TypeScript strict, prefira composicao sobre heranca, funcoes puras quando possivel".
2. Inclua Exemplos
Code blocks com exemplos do que voce quer sao mais eficazes que descricoes abstratas. Mostre o padrao desejado.
3. Use Scoping Adequado
Coloque AGENTS.md em subdiretorios para instrucoes contextuais. Frontend/ tem regras diferentes de backend/.
4. Itere e Teste
Skills nao sao "escreva e esqueca". Teste, ajuste e refine baseado nos resultados que o Copilot produz.
🎯 Proximo Passo
No proximo modulo, exploramos o Cursor - de .cursorrules ao SKILL.md moderno, incluindo o Cursor Directory e estrategias de migracao.
📚 Resumo do Modulo
Proximo Modulo:
5.3 - Skills no Cursor