Skills de IA

Atualizado em 07/10/2026. Recursos de IA mudam rápido: plano, menu e status de preview citados aqui valem para essa data. Na dúvida, confira o link oficial no fim de cada seção. Os nomes de menu podem aparecer em inglês, conforme o idioma da sua conta.

As skills do Data Analyst Advisor ensinam a IA a trabalhar do jeito OfficeTuning: nomenclatura TabDim/TabFat, comparativo AV/AA/Δ, Query Folding, as 90 regras de boas práticas, grid de 8 px e QA de PBIP. Elas ficam no repositório público officetuning/skill-library.

O que é uma skill

Uma skill é uma pasta com um arquivo SKILL.md e, opcionalmente, referências e scripts:

power-query-m/
├── SKILL.md              ← nome, descrição e instruções
└── references/
    ├── funcoes-m.md
    └── padroes-m.md

O SKILL.md começa com um cabeçalho:

---
name: power-query-m
description: Boas práticas de Power Query M no Power BI — Query Folding, ...
  Use quando o usuário citar refresh lento, "query folding", função M ...
---

A IA lê só o name e a description de todas as skills instaladas. Quando sua pergunta combina com uma descrição, ela abre aquela skill e segue as instruções. Por isso você não precisa dizer "use a skill X": basta perguntar.

O formato é um padrão aberto (Agent Skills). A mesma pasta funciona no Claude, no ChatGPT, no Gemini e no GitHub Copilot, sem conversão.

As 11 skills

Skill ou plugin?

Regra: use plugin onde ele existe, que hoje é só no Claude (app nos planos pagos e Claude Code). Em todas as outras IAs, instale como skill.

• Plugin: um pacote com as 11 skills, instaladas juntas e completas, e atualizadas junto com o repositório.
• Skill: cada pasta avulsa. Você escolhe quais instalar.

O comando npx skills add

O CLI skills copia as pastas para o lugar certo de cada agente de terminal. Precisa do Node.js instalado.

💡 Num projeto Power BI versionado no Git, rode sem -g, dentro da pasta do projeto: as skills entram no repositório e a equipe recebe tudo no próximo git pull.

⚠️ Não use npx skills add para o app do Claude. Ele instala cópias avulsas só com o SKILL.md, sem references/ e scripts/, e elas aparecem duplicadas ao lado do plugin. Se isso já aconteceu, apague as avulsas em Personalizar → Skills e mantenha as do plugin.

Upload manual: preparar os .zip

Baixe o repositório: em github.com/officetuning/skill-library clique em Code → Download ZIP e descompacte. As skills estão em skills/.

Claude e Gemini pedem um .zip por skill, mas cada um espera o .zip montado de um jeito:

No Windows, este PowerShell gera os dois conjuntos de uma vez:

# Rode dentro da pasta skill-library descompactada
New-Item -ItemType Directory -Force zips\claude, zips\gemini | Out-Null
Get-ChildItem skills -Directory | ForEach-Object {
    # Claude: o .zip contém a pasta da skill
    Compress-Archive -Path $_.FullName -DestinationPath "zips\claude\$($_.Name).zip" -Force
    # Gemini: o .zip contém o conteúdo da pasta, com SKILL.md na raiz
    Compress-Archive -Path "$($_.FullName)\*" -DestinationPath "zips\gemini\$($_.Name).zip" -Force
}

⚠️ Não renomeie a pasta: o nome dela tem que ser igual ao name do SKILL.md.

Claude

No Claude há três caminhos. Escolha um:

💡 Tem plano pago? Use o caminho A. É o único que instala tudo de uma vez e acompanha você em qualquer dispositivo.

A. Plugin pelo app (recomendado)

Plano: Pro, Max, Team ou Enterprise. Faça no navegador (claude.ai).

1. Na barra lateral, abra Personalizar → Plugins.
2. Em Plugins pessoais, clique em + → Adicionar marketplace.
3. Escolha Adicionar de um repositório e informe https://github.com/officetuning/skill-library.
4. Na lista de plugins, clique em Instalar no data-analyst-advisor.

Pronto: as 11 skills entram juntas. Para conferir, digite / na conversa. Elas aparecem como data-analyst-advisor:power-query-m, data-analyst-advisor:bi-nomenclatura etc.

⚠️ No Claude Desktop e no Cowork, plugin que você envia como arquivo fica salvo só naquele computador. Por isso a recomendação é instalar pelo navegador, a partir do marketplace.

💡 Team e Enterprise: plugin instalado de marketplace não pode ser compartilhado com colegas. Para distribuir para a equipe, o admin adiciona o marketplace em Configurações da organização → Plugins e skills.

B. Upload de .zip (inclui o plano Free)

Plano: Free, Pro, Max, Team e Enterprise. Exige Execução de código e criação de arquivos ligada.

1. Ligue a execução de código:
   • Free, Pro e Max: Configurações → Capacidades.
   • Team e Enterprise: o admin libera em Configurações da organização → Plugins e skills.
2. Vá em Personalizar → Skills.
3. Clique em + → Criar skill → Enviar uma skill e escolha o .zip de zips\claude (ex.: power-query-m.zip). Repita para cada skill.
4. Confira se a chave da skill está ligada.

No Team e no Enterprise, a skill enviada fica visível só para você até ser compartilhada.

💡 Skills ligadas aqui também funcionam nos complementos do Claude para Excel, PowerPoint, Word e Outlook.

Teste (vale para A e B): "Meu refresh ficou lento depois que adicionei uma coluna personalizada. Como descubro o passo que quebrou o Query Folding?"

C. Claude Code (terminal)

⚠️ Os comandos abaixo são do terminal (Claude Code). Se você colar no chat do app, eles não instalam nada. No app, use o caminho A.

/plugin marketplace add officetuning/skill-library
/plugin install data-analyst-advisor@officetuning

A instalação vale só para aquele computador. Em outra máquina, repita os comandos.

Para usar só algumas skills, copie as pastas para ~/.claude/skills/ (todas as conversas) ou .claude/skills/ dentro do projeto.

💡 Já instalou pelo app (caminho A)? Então não precisa fazer nada no terminal. Entrando no Claude Code com a mesma conta (versão 2.1.273 ou superior), o plugin chega sozinho. A sincronização:

• acontece toda vez que o Claude Code abre;
• é de mão única: o que você instala no terminal não vai para o app;
• não funciona se o Claude Code estiver logado com chave de API ou rodando no Amazon Bedrock;
• pode ser desligada com "syncClaudeAiPlugins": false nas configurações do Claude Code.

Onde a instalação vale

As skills do Data Analyst Advisor são só texto, por isso funcionam também no celular. O que não vai para o celular é o que roda na sua máquina: o Power BI via MCP conversa com o Power BI Desktop aberto e só funciona pelo app desktop. Nos planos Pro e Max, o Dispatch permite mandar a tarefa do celular para ser executada no seu computador.

📎 Usar plugins no Claude · Usar skills no Claude

ChatGPT

⚠️ GPTs personalizados estão sendo aposentados. A OpenAI está trocando os GPTs por plugins, em todos os planos do ChatGPT:

Na migração para plugin, as instruções viram uma skill e os arquivos de conhecimento viram referências. Não migram: ações personalizadas, modelo escolhido, conversas e o compartilhamento. O plugin migrado nasce privado, e quem usava o GPT não ganha acesso automático a ele.

Com skills (Business, Enterprise, Edu e Healthcare)

Skills estão em beta e desligadas por padrão. O dono do workspace precisa ativá-las nas configurações do workspace.

1. Na barra lateral, abra Plugins → Skills.
2. Clique em Criar → Enviar do computador e escolha a skill.
3. Instale. O ChatGPT passa a usar a skill sozinho quando ela ajuda.
4. Para forçar, mencione a skill com @ na conversa.

Skill compartilhada por um colega: Skills → Compartilhadas comigo → ••• → Instalar.

📎 Skills no ChatGPT

Como plugin, para a equipe (Business e Enterprise)

Para entregar as 11 skills num pacote só, crie um plugin:

1. Em Plugins, clique em +. Abre uma conversa com o Plugin Creator.
2. Descreva o assistente e envie os SKILL.md e os arquivos de references/.
3. Teste e compartilhe: com pessoas, grupos, qualquer um com o link ou no diretório do workspace.

⚠️ O compartilhamento vale só dentro do workspace. Publicar no diretório do workspace não torna o plugin público.

📎 Plugins no ChatGPT e no Codex

Free, Go, Plus e Pro

Nesses planos não há skills nem criação de GPT, e a OpenAI só documenta a criação de plugins em workspaces Business e Enterprise. O que resta é instalar plugins publicados no Plugins Directory, o diretório público do ChatGPT e do Codex. Só entra lá plugin enviado por desenvolvedor com identidade verificada e aprovado na revisão da OpenAI.

💡 Quer as skills sem plano de empresa? Use o Claude (caminho B funciona no Free) ou o app Gemini (AI Pro ou Ultra).

📎 Aposentadoria dos GPTs: perguntas frequentes

Codex

O agente de código da OpenAI também lê skills no mesmo formato:

npx skills add officetuning/skill-library -a codex -g -s '*' --copy -y

Catálogo oficial de skills da OpenAI: openai/skills.

Gemini

App Gemini (gemini.google.com)

Plano: Google AI Pro ou Ultra, com conta pessoal Google (não funciona com conta de trabalho ou escola), maior de 18 anos e Atividade ligada. Disponível no Brasil; indisponível no Espaço Econômico Europeu, Reino Unido, Suíça e Nigéria.

1. Abra gemini.google.com → barra lateral → Switch to Spark → Skills.
2. Escolha Enviar arquivo e selecione o .zip de zips\gemini (até 100 MB). Esse .zip tem o SKILL.md na raiz, como o Gemini exige. Enviar só o SKILL.md também funciona, mas as referências ficam de fora.
3. Ligue a skill.
4. O Gemini usa a skill sozinho pelo contexto. Para escolher manualmente, digite / na conversa.

⚠️ O app Gemini não aceita PDF, DOCX, XLSX nem imagens dentro da skill. As skills do Data Analyst Advisor são só texto (.md, .py, .js) e funcionam.

📎 Criar e gerenciar skills no Gemini

Sem skills (conta de trabalho ou plano sem skills): Gem

1. Gems → Novo Gem.
2. Em Instruções, cole o corpo do SKILL.md principal.
3. Em Conhecimento, envie os demais SKILL.md e references/.

Gemini CLI (terminal)

# As 11 skills, direto do GitHub, para todos os projetos
npx skills add officetuning/skill-library -a gemini-cli -g -s '*' --copy -y

# Alternativa nativa do Gemini CLI, uma skill por vez, a partir do clone local
gemini skills install ./skill-library/skills/power-query-m --consent

# Dentro do Gemini CLI, para conferir
/skills list

Ou copie as pastas para ~/.gemini/skills/ (usuário) ou .gemini/skills/ (projeto). O Gemini pede sua confirmação antes de ativar cada skill.

📎 Agent Skills no Gemini CLI

Copilot

"Copilot" é o nome de vários produtos. Skills funcionam no GitHub Copilot e no Copilot Studio.

GitHub Copilot (VS Code, Visual Studio, CLI e cloud agent)

As 11 de uma vez, direto do GitHub:

npx skills add officetuning/skill-library -a github-copilot -g -s '*' --copy -y

Ou copie as pastas das skills para uma destas pastas:

No chat do VS Code, no modo agente, digite / para ver as skills e chamar uma pelo nome:

/power-query-m revise esta consulta e diga onde o folding quebra

Pelo GitHub CLI (versão 2.90.0 ou superior, recurso em preview):

gh skill install officetuning/skill-library power-query-m

💡 Quem usa Power BI Projects (.pbip) versionado no Git ganha mais: com tmdl-pbir e bi-qa-documentacao em .github/skills/, o Copilot lê o TMDL do próprio repositório.

📎 Agent Skills no VS Code · Skills no GitHub Copilot

Copilot Studio

Agentes do Copilot Studio movidos pelo harness do GitHub Copilot aceitam upload de SKILL.md ou .zip na configuração do agente. O uso consome Copilot Credits.

📎 Skills para agentes no Copilot Studio

Microsoft 365 Copilot (chat do Office)

Na data deste guia, a Microsoft não documenta upload de skills no chat do Microsoft 365 Copilot. A alternativa é criar um agente e anexar os SKILL.md como conhecimento, como no Gem.

Uma pasta para várias IAs

Várias ferramentas leem a pasta .agents/skills/. Instalando nela, a mesma cópia serve a mais de uma:

O Copilot também lê .claude/skills/ no projeto.

Resumo

Problemas comuns

Usar junto com as skills oficiais da Microsoft

O repositório microsoft/skills-for-fabric (licença MIT) traz skills oficiais de Power BI: planejamento e design de relatório, criação de relatório, criação de modelo semântico, fluxos PBIP, DAX e TMDL. O plugin de Power BI se chama powerbi-authoring e registra o Power BI Authoring MCP local. No Claude Code:

/plugin marketplace add microsoft/skills-for-fabric
/plugin install powerbi-authoring@fabric-collection

O repositório é otimizado para o GitHub Copilot CLI e traz compatibilidade com Claude Code, VS Code, Cursor e outros. Não registre o MCP local e o hospedado ao mesmo tempo.

Regra de convivência: quando as duas falarem do mesmo assunto, padrão de nome, formatação e regras de modelagem seguem as skills OfficeTuning; sintaxe e comportamento da ferramenta seguem a documentação Microsoft.

Fontes: microsoft/skills-for-fabric (GitHub) · Visão geral agêntica do Power BI (Microsoft Learn)

Manter atualizado

As skills evoluem junto com o Function Library. Para atualizar:

• Plugin pelo app (Claude): o plugin vem do repositório do marketplace. Confira a versão em Personalizar → Plugins. O Claude Code logado na mesma conta recebe a atualização quando abre.
• Upload manual (Claude, ChatGPT, Gemini): baixe o repositório de novo e reenvie o .zip da skill que mudou.
• Claude Code instalado pelo terminal: /plugin marketplace update officetuning.
• npx skills add (Codex, Gemini CLI, Copilot): rode o mesmo comando de novo; as pastas são sobrescritas.
• Pastas copiadas à mão (Copilot, Gemini CLI): git pull no clone.

⚠️ Skill executa instruções e, às vezes, scripts. Instale só skills de fontes que você confia e leia o SKILL.md antes. Vale para estas também.