Fala dataholics, voltando pra série do GitHub Copilot a fundo. No post anterior a gente viu AGENTS.md e as custom instructions, e no fim eu falei pra manter aquele arquivo curto. Aí aparece a pergunta óbvia: e o conhecimento que é longo de verdade, o runbook de 3 páginas, o padrão de notebook do time, aquele passo a passo chato de migração, onde é que isso vai? Vai em Agent Skills.

A diferença em relação às instructions

Custom instruction é regra que está sempre lá, ou o tempo todo no caso do arquivo raiz, ou sempre que o agente toca naquela pasta no caso do applyTo. Skill é diferente porque ela é uma pasta com instrução, script e arquivo de apoio, e o agente só carrega ela quando entende que aquilo tem a ver com o que você pediu. É conhecimento procedural sob demanda, então você pode ter dez skills no repo sem pagar contexto de nenhuma delas até uma ser realmente útil.

O formato é simples, uma subpasta dentro de .github/skills com um SKILL.md dentro:

.github/skills/
  criar-notebook-databricks/
    SKILL.md
    template.py
  migrar-tabela-para-uc/
    SKILL.md
    checklist.md

E o SKILL.md em si:

---
name: criar-notebook-databricks
description: Cria notebook novo no padrao do time (naming, widgets de
  ambiente, logging e celula de teste). Use quando pedirem notebook,
  job novo ou pipeline no Azure Databricks.
---

# Padrao de notebook

1. Nome do arquivo: nn_dominio_acao.py (ex: 03_vendas_carga_incremental.py)
2. Primeira celula sempre com os widgets: env, data_ref, catalog
3. Nunca hardcode de catalogo, sempre f"{catalog}.silver.tabela"
4. Logging com o helper de utils/log.py, nao print
5. Ultima celula roda a validacao de contagem antes de finalizar

Use utils/template.py como ponto de partida.

Repare no description, porque ele é a parte que mais gente escreve mal e é justamente quem decide se a skill vai ser carregada. O agente lê essa linha pra saber se aquilo serve pro pedido do momento, então descrição vaga do tipo "padrões do time" nunca engata em nada. Escreva quando usar, com as palavras que as pessoas realmente digitam no prompt.

gh skill: instalar e publicar skill como se fosse pacote

Em abril de 2026 o GitHub CLI ganhou o gh skill, na versão 2.90.0, e isso muda a forma de trabalhar com skill em time grande. Ele descobre, instala, gerencia e publica skills a partir de repositórios do GitHub, ou seja, virou distribuição de verdade e não mais copiar e colar pasta entre projetos. E ele não é exclusivo do Copilot, o mesmo comando serve pra Codex, Claude Code, Cursor e Gemini CLI, então a skill que o seu time escreve funciona independente de quem usa qual ferramenta.

Na prática eu gosto disso porque resolve o pior sintoma de padronização que existe: a regra que mora na cabeça de uma pessoa. Se o padrão de notebook está numa skill publicada num repo interno, quem entra no time roda um comando e já tem o padrão. Se o padrão muda, muda em um lugar.

Skills no code review

Em julho de 2026 o suporte a agent skills e a servidores MCP no Copilot code review ficou GA pra Pro, Pro+, Business e Enterprise. E aí muda de patamar, porque o review deixou de olhar só pro diff com padrão genérico e passou a poder aplicar o padrão da sua casa, e ainda invocar ferramenta interna durante a revisão. Nada de "considere extrair essa função", que é o comentário que todo mundo já aprendeu a ignorar.

Tem um detalhe bem pensado nisso: o Copilot marca o comentário quando ele foi gerado usando skill ou contexto de MCP. Então você consegue olhar o PR e saber se aquele comentário veio da regra que o time escreveu ou se foi palpite geral do modelo. Isso ajuda demais a calibrar as skills, porque você vê na prática quais engancham e quais nunca aparecem.

E ele já aproveita o que você configurou antes: qualquer MCP que você tenha montado pro cloud agent vale automaticamente pro code review, sem configurar de novo. Só lembre que a chamada de MCP no review é limitada a read-only, mas isso a gente vê no próximo post.

Minha leitura de quem está usando

Skill é o lugar certo pro conhecimento que é longo, procedural e usado de vez em quando. Se é regra curta que vale sempre, deixe na instruction, porque skill que existe pra tudo volta a ser o arquivo gigante de sempre, só espalhado em pastas. O erro que eu vi acontecer mais foi criar oito skills no primeiro dia, com descrição parecida entre elas, e aí o agente carrega a errada ou não carrega nenhuma.

Eu começaria com duas, as duas coisas que o seu time mais explica pra pessoa nova, e cresceria dali só quando doer. Ah, e revise a description depois de umas semanas de uso, é o ajuste que dá mais resultado e leva dois minutos.

RESUMO

• Agent Skills vivem em .github/skills/nome/SKILL.md e podem levar script e arquivo de apoio junto.

• Carregamento é sob demanda, quem decide é a description, então escreva "use quando..." com as palavras reais do prompt.

• gh skill (GitHub CLI 2.90.0, abril de 2026) descobre, instala e publica skill, e serve pra outros agentes também.

• Skills e MCP no Copilot code review estão GA desde julho de 2026, com atribuição no comentário.

• Regra curta e sempre válida fica na instruction. Skill é pro conhecimento longo e ocasional.

No próximo post eu entro no MCP dentro do Copilot, que é quando o agente para de só ler o seu repo e começa a chamar ferramenta de verdade, com o detalhe importante de como não perder a governança nesse caminho.

Referências:

https://github.blog/changelog/2026-07-29-copilot-code-review-agent-skills-and-mcp-now-generally-available/

https://github.com/github/awesome-copilot

Espero que ajude. Fique bem e até a próxima.

#githubcopilot #agentskills #copilot #ia #agentes #datainaction

Hey dataholics, back to the GitHub Copilot in depth series. In the previous post we looked at AGENTS.md and custom instructions, and at the end I told you to keep that file short. So the obvious question shows up: what about the knowledge that really is long, the 3 page runbook, the team notebook standard, that tedious migration walkthrough, where does that go? It goes into Agent Skills.

How it differs from instructions

A custom instruction is a rule that is always there, either all the time in the case of the root file, or whenever the agent touches that folder in the case of applyTo. A skill works differently because it is a folder with instructions, scripts and supporting files, and the agent only loads it when it figures out that it relates to what you asked. It is procedural knowledge on demand, so you can have ten skills in the repo without paying context for any of them until one is actually useful.

The format is simple, a subfolder inside .github/skills with a SKILL.md in it:

.github/skills/
  create-databricks-notebook/
    SKILL.md
    template.py
  migrate-table-to-uc/
    SKILL.md
    checklist.md

And the SKILL.md itself:

---
name: create-databricks-notebook
description: Creates a new notebook in the team standard (naming, env
  widgets, logging and a test cell). Use when someone asks for a
  notebook, a new job or a pipeline on Azure Databricks.
---

# Notebook standard

1. File name: nn_domain_action.py (ex: 03_sales_incremental_load.py)
2. First cell always with the widgets: env, data_ref, catalog
3. Never hardcode the catalog, always f"{catalog}.silver.table"
4. Logging through the helper in utils/log.py, not print
5. Last cell runs the count validation before finishing

Use utils/template.py as the starting point.

Pay attention to the description, because it is the part most people write badly and it is exactly what decides whether the skill gets loaded. The agent reads that line to know if it fits the current request, so a vague description like "team standards" never hooks into anything. Write when to use it, with the words people actually type into the prompt.

gh skill: installing and publishing a skill like a package

In April 2026 the GitHub CLI got gh skill, in version 2.90.0, and that changes how you work with skills in a large team. It discovers, installs, manages and publishes skills from GitHub repositories, so this became real distribution instead of copying and pasting folders between projects. And it is not Copilot only, the same command works for Codex, Claude Code, Cursor and Gemini CLI, so the skill your team writes works no matter who uses which tool.

In practice I like this because it fixes the worst standardization symptom out there: the rule that lives inside one person's head. If the notebook standard sits in a skill published in an internal repo, whoever joins the team runs one command and already has the standard. If the standard changes, it changes in one place.

Skills in code review

In July 2026 support for agent skills and MCP servers in Copilot code review went GA for Pro, Pro+, Business and Enterprise. And that raises the bar, because the review stopped looking at the diff with generic standards only and can now apply your own house standard, and even call internal tooling during the review. No more "consider extracting this function", the comment everybody already learned to ignore.

There is a well thought out detail in there: Copilot flags the comment when it was generated using a skill or MCP context. So you can look at the PR and know whether that comment came from the rule your team wrote or whether it was a general guess from the model. That helps a lot to calibrate the skills, because you get to see which ones hook in and which ones never show up.

And it reuses what you already set up: any MCP you configured for the cloud agent automatically applies to code review, no need to configure it again. Just remember that MCP calls in the review are limited to read-only, but we will get to that in the next post.

My read from using it

A skill is the right place for knowledge that is long, procedural and used once in a while. If it is a short rule that always applies, leave it in the instruction, because a skill for everything turns back into the same giant file, just spread across folders. The mistake I saw happen the most was creating eight skills on day one, with similar descriptions between them, and then the agent loads the wrong one or loads none.

I would start with two, the two things your team explains the most to a new person, and grow from there only when it hurts. Oh, and revisit the description after a few weeks of use, it is the tweak with the best payoff and it takes two minutes.

RECAP

• Agent Skills live in .github/skills/name/SKILL.md and can carry scripts and supporting files along.

• Loading is on demand and the description decides it, so write "use when..." with the real words from the prompt.

• gh skill (GitHub CLI 2.90.0, April 2026) discovers, installs and publishes skills, and works for other agents too.

• Skills and MCP in Copilot code review have been GA since July 2026, with attribution on the comment.

• Short, always valid rules stay in the instruction. Skills are for long and occasional knowledge.

In the next post I get into MCP inside Copilot, which is when the agent stops just reading your repo and starts calling real tools, plus the important bit of how not to lose governance along the way.

References:

https://github.blog/changelog/2026-07-29-copilot-code-review-agent-skills-and-mcp-now-generally-available/

https://github.com/github/awesome-copilot

Hope it helps. Stay well and see you next time.

#githubcopilot #agentskills #copilot #ai #agents #datainaction