O que são plugins do Claude Cowork?
Um plugin do Claude Cowork é um pacote instalável que reúne tudo o que o Claude precisa para atuar como um especialista. Ele inclui, por exemplo, habilidades de fluxo de trabalho, os slash commands, conectores adequados e os subagentes e hooks necessários. O anúncio da Anthropic resume em uma frase:
"Plugins permitem agrupar quaisquer habilidades, conectores, slash commands e subagentes para transformar o Claude em um especialista para a sua função, seu time e sua empresa."
Os plugins chegaram ao Cowork em 30 de janeiro de 2026, como um research preview para usuários pagos, junto com 11 plugins open-source criados pelas equipes da Anthropic. Uma segunda leva em 24 de fevereiro de 2026 adicionou plugins de RH, design, engenharia, operações e análise financeira, 4 plugins para serviços financeiros, plugins de parceiros como Slack, S&P Global e LSEG, e formulários estruturados para slash commands. O próprio Cowork saiu do preview e passou a disponibilidade geral em 9 de abril de 2026.
Onde os plugins rodam costuma confundir, então aqui vai a resposta atual do artigo da Central de Ajuda da Anthropic. Um plugin que você adiciona é salvo na sua conta Claude, não no seu computador, então te acompanha no chat na web, no app desktop, no Cowork e no Claude Code (a versão 2.1.273 ou superior sincroniza automaticamente). Skills e commands funcionam em todos esses lugares, enquanto hooks e subagentes rodam apenas no Cowork e no Claude Code, e aparecem esmaecidos no chat.
Se você ainda não usou o Cowork, nosso tutorial do Claude Cowork apresenta o app, e a comparação entre Claude Cowork e Claude Code explica por que o mesmo plugin consegue fazer mais em um do que no outro. Não vou reexplicar o Cowork aqui.
O que um plugin reúne
A tabela abaixo lista os 5 componentes que um plugin pode conter, o que cada um faz e quando é acionado.
|
Componente |
O que faz |
Quando dispara |
|
Skill |
Um arquivo |
Automaticamente, quando o Claude julga que a tarefa combina com a descrição da skill. Você também pode executá-la pelo nome após |
|
Slash command |
Uma ação nomeada com instruções próprias, como |
Manual, quando você digita. No Cowork, o Claude pode fazer uma pergunta estruturada antes de começar. |
|
Connector (MCP) |
Um link para um serviço externo via Model Context Protocol (MCP): Snowflake, BigQuery, Slack e centenas de outros |
Quando o Claude chama uma ferramenta do serviço, após você ter conectado o serviço uma vez. |
|
Sub-agent |
Um especialista para o qual o Claude pode delegar parte da tarefa, com seu próprio prompt e lista de ferramentas |
Quando o Claude decide delegar. Somente no Cowork e no Claude Code. |
|
Hook |
Um script ou prompt que roda em um evento da sessão, como logo antes de uma chamada de ferramenta |
Nesse evento, sempre. Somente no Cowork e no Claude Code. |
Skills disparam quando o Claude as julga relevantes, e commands disparam quando você digita /. Essa distinção define o que verificar quando um plugin parece não fazer nada, ponto ao qual volto na seção de verificação. Se subagentes são novidade para você, nosso curso Introduction to AI Agents explica o padrão de delegação sem código.
Plugin vs. skill
Uma skill ensina ao Claude uma tarefa em um único arquivo SKILL.md. Um plugin é o conjunto empacotado de skills, commands e conectores para uma função inteira, então o Data plugin tem 10 skills. O plugin é a unidade que você instala, enquanto a skill é a unidade que você edita. Nosso guia sobre Claude Skills aprofunda no formato de skill se você quiser.
Onde encontrar plugins do Cowork
Os plugins do Cowork vêm de 3 lugares, e você vai usar o primeiro na maior parte deste artigo:
- Os marketplaces embutidos no Cowork. O Knowledge Work marketplace é adicionado por padrão a toda conta. Os marketplaces de Life Sciences, Financial Services e Legal da Anthropic ficam em Add, Add marketplace e depois Browse Anthropic sources.
- O diretório em claude.com/plugins. Ele lista mais de 300 plugins, com filtro para indicar se cada um funciona com o Claude, com o Claude Code ou com ambos.
- O repositório anthropics/knowledge-work-plugins no GitHub. É o código sob licença Apache-2.0 de todos os plugins de função criados pela Anthropic e foi onde li os arquivos citados abaixo.
Existem outras duas formas de instalar: adicionar qualquer repositório Git como marketplace pela URL ou pela abreviação owner/repo (funciona com GitHub, GitHub Enterprise e repositórios públicos do GitLab e Bitbucket), ou enviar um plugin diretamente como um arquivo .zip ou .plugin de até 200 MB.
A linha de funções cobre muitas áreas: produtividade, vendas, suporte ao cliente, gerenciamento de produto, marketing, jurídico, finanças, dados, busca corporativa, RH, design, engenharia, operações, pesquisa em biologia e pequenas empresas, além de plugins de parceiros. Este artigo não é um apanhado geral; escolha o que combina com seu trabalho e siga em frente.
O que há dentro de um plugin do Cowork?
Um plugin do Cowork é uma pasta com um manifest em uma subpasta oculta e o restante no nível raiz. Aqui está a estrutura completa, com os componentes, e apenas algumas superfícies marcadas como tal:
my-plugin/
├── .claude-plugin/
│ └── plugin.json # manifest (required)
├── skills/
│ └── <name>/SKILL.md # skills: auto-triggered knowledge & named actions
├── commands/
│ └── <name>.md # legacy single-file slash commands (still work)
├── agents/
│ └── <name>.md # sub-agents (Cowork and Claude Code only)
├── hooks/
│ └── hooks.json # hooks (Cowork and Claude Code only)
├── .mcp.json # connectors
└── README.md
Guarde essa árvore em mente, porque o Passo 4 constrói a metade de cima arquivo por arquivo. A figura abaixo relaciona a árvore com onde cada componente roda, a partir da tabela de suporte por plataforma da Anthropic.

Figura 1. A pasta de um plugin à esquerda e, para cada componente, quando dispara e se chat, Cowork ou Claude Code o carrega. Imagem do autor.
O manifest
O manifest é .claude-plugin/plugin.json, e name é o único campo obrigatório. Este é o manifest real do Data plugin da Anthropic, copiado do repositório:
{
"name": "data",
"version": "1.1.0",
"description": "Write SQL, explore datasets, and generate insights faster. Build visualizations and dashboards, and turn raw data into clear stories for stakeholders.",
"author": {
"name": "Anthropic"
}
}
Três coisas para saber:
-
O
nameé a identidade permanente do plugin e prefixa todo componente, então a skillwrite-queryvira/data:write-query. -
A string
versioné o número de versão que as pessoas veem para o plugin, e o guia de build da Anthropic diz para incrementá-la a cada release. -
Campos opcionais incluem
displayName,license,homepageekeywords.
Skills e commands
Uma skill fica em skills/<name>/SKILL.md: um bloco curto de configurações entre linhas --- no topo (o frontmatter YAML) e instruções para o Claude abaixo. Aqui está o início da skill write-query do Data plugin, a que rodo no Passo 2:
---
name: write-query
description: Write optimized SQL for your dialect with best practices. Use when translating a natural-language data need into SQL, building a multi-CTE query with joins and aggregations, optimizing a query against a large partitioned table, or getting dialect-specific syntax for Snowflake, BigQuery, Postgres, etc.
argument-hint: "<description of what data you need>"
---
# /write-query - Write Optimized SQL
A description é o que o Claude lê para decidir se carrega a skill, e o argument-hint indica o que a skill espera que você digite. Duas flags no frontmatter mudam como a skill dispara:
-
user-invocable: falseoculta a skill do menu/, para que apenas o Claude a carregue (a skillsql-queriesdo plugin está assim) -
disable-model-invocation: truefaz o oposto, permitindo que a skill rode só quando você digita o nome dela.
Commands são o formato mais antigo: um arquivo Markdown em commands/<name>.md com um description no frontmatter. A skill de autoria da própria Anthropic hoje instrui o Claude a "scaffold new plugins with skills/*/SKILL.md" e chama a pasta commands/ de legada, porque a interface do Cowork mostra tudo junto como uma lista de Skills. Commands continuam funcionando em todos os lugares, então você vai encontrá-los em plugins mais antigos, mas o Passo 4 usa skills.
Connectors
O arquivo .mcp.json no raiz do plugin lista os serviços externos que o plugin pode acessar, cada um como uma URL de servidor MCP. Aqui estão as 3 primeiras entradas do arquivo do Data plugin:
{
"mcpServers": {
"snowflake": {
"type": "http",
"url": ""
},
"databricks": {
"type": "http",
"url": ""
},
"bigquery": {
"type": "http",
"url": "https://bigquery.googleapis.com/mcp"
},
As URLs vazias são placeholders: a Anthropic fornece o endpoint do BigQuery, mas deixa Snowflake e Databricks para você preencher com o endereço do seu servidor. Se MCP for novidade, nosso guia do Model Context Protocol monta um servidor do zero.
Há uma restrição pouco óbvia: a central de ajuda da Anthropic afirma que "no Cowork, conectores acessam serviços externos pela nuvem da Anthropic, não pela sua rede local". Um conector customizado precisa apontar para um servidor "acessível publicamente pela internet a partir dos IPs da Anthropic". Um warehouse atrás de firewall ou VPN não vai conectar até sua equipe de rede liberar os endereços da Anthropic.
Servidores MCP locais, do tipo que iniciam um programa na sua máquina, são a exceção: eles rodam no Claude Code e em sessões do Cowork que rodam no seu computador; o chat ignora.
Desde 6 de outubro de 2026, novas tarefas Pro e Max rodam apenas na nuvem da Anthropic, então sessões locais ficam mais para planos Team e Enterprise.
Passo 1: instalando seu primeiro plugin
Instalar um plugin do Cowork leva 6 passos curtos na página Customize, idênticos para qualquer plugin do catálogo, então leitores de vendas ou jurídico podem escolher o seu. Uso o Data plugin porque ele prepara o exemplo de SQL no Passo 2.
1. Abra Customize na barra lateral esquerda do app desktop do Claude. Se o seu app ainda mostrar a aba Cowork, abra-a antes.

2. Abra a aba Plugins.

3. Vamos confirmar se você tem o Knowledge Work marketplace. Clique em + Add, depois Add marketplace e então Browse Anthropic sources.

4. Selecione e adicione os plugins do Knowledge Work.

5. Abra a aba Discover. O Knowledge Work marketplace já deve estar lá. Clique no filtro Code.

6. Selecione Data e clique em Add. Em alguns builds, o botão aparece como Install.
A página do plugin então lista o que veio: na aba Skills há 10 skills, 7 que você pode rodar pelo nome (analyze, explore-data, write-query, create-viz, build-dashboard, validate-data e data-context-extractor) e 3 que carregam em segundo plano (sql-queries, data-visualization e statistical-analysis). O arquivo de conector no repositório lista Snowflake, Databricks, BigQuery, Definite, Hex, Amplitude (com uma entrada separada para UE) e Atlassian, e nenhum está conectado até você fazer login. A página do diretório do Data plugin mostrava 7.655 instalações em 28 de setembro de 2026.
Se você curte terminal, o mesmo plugin instala no Claude Code com 2 comandos do README do repositório:
claude plugin marketplace add anthropics/knowledge-work-plugins
claude plugin install data@knowledge-work-plugins
Uma diferença importa: um plugin adicionado pelo Customize sincroniza com o Claude Code, mas um plugin instalado pela linha de comando fica naquela máquina e não chega à sua conta. Nosso guia de criação de plugins do Claude Code cobre o workflow no terminal em detalhes; aqui sigo pelo desktop.
Nos planos Team e Enterprise, um owner define cada plugin em um de 4 estados: indisponível, disponível para instalar, instalado por padrão ou obrigatório. Admins Enterprise podem sobrescrever por grupo, então a central de ajuda alerta que "os plugins que você vê no catálogo podem ser diferentes dos que colegas em outros grupos veem". Se o Data não aparecer na sua aba Discover, fale com um owner antes de presumir que o marketplace está com problema.
Passo 2: conectando uma fonte de dados e rodando um slash command
Um plugin sem warehouse conectado só consegue escrever SQL para você colar em outro lugar, então o primeiro passo real é conectar uma fonte de dados. Depois o slash command faz o resto.
Autorizando um conector
Adicionar um plugin não te autentica em nada. Abra a aba Connectors do plugin, onde cada entrada mostra um de 3 estados: Connected, Not connected (o conector está na sua conta, mas você não fez login) ou Not added. Clique em Add onde precisar, depois Connect e finalize o login no serviço no seu navegador.

Nos planos Team e Enterprise, um owner adiciona primeiro o conector para a organização e você conecta com a sua conta.
Use credenciais de leitura no warehouse, porque um conector com escrita permite ao Claude executar qualquer instrução exposta pelas ferramentas, e no modo automático do Cowork, o próprio Claude decide se vai chamá-las. Isso significa:
-
Para Snowflake, uma role com
SELECTapenas -
Para BigQuery, uma service account com a role Data Viewer
-
Para Databricks, um token com escopo a um SQL warehouse somente leitura
Se você é novo em alguma das plataformas, nosso guia para iniciantes em Snowflake e o tutorial de BigQuery te levam à primeira query em uma tarde.
A conexão fica na sua conta em Customize e depois Connectors, então você autoriza cada serviço uma vez, e qualquer outro plugin que liste a mesma URL de servidor, como a entrada do BigQuery no plugin de Finance, reutiliza.
Rodando seu primeiro command
O command write-query transforma uma pergunta em linguagem natural em SQL no seu dialeto, e é o artefato ao qual mais quero que você preste atenção, porque a seção de verificação volta nele.
Eu montei um pequeno banco SQLite, shop.db, com 4 tabelas que um warehouse de e-commerce teria e 1.600 pedidos de 5 de janeiro a 27 de setembro de 2026. A tabela abaixo define o esquema; toda query deste artigo roda nele.
|
Tabela |
Colunas |
Uma linha é |
|
|
|
Um cliente (240 linhas) |
|
|
|
Um produto do catálogo em 1 de 5 categorias (40 linhas) |
|
|
|
Um pedido com status completed, refunded ou canceled (1.600 linhas) |
|
|
|
Um item de produto em um pedido, precificado antes de um desconto de 0 a 25% (2.647 linhas) |
Para executar o command, digite / na caixa de mensagem e escolha write-query do Data plugin, ou digite /data:write-query.
Desde a atualização de 24 de fevereiro de 2026, digitar um command coloca o texto de dica na caixa de mensagem, e o Claude pode fazer uma pergunta estruturada com opções numeradas antes de começar, como mostra a captura da Anthropic abaixo com o command /dashboard.

O formulário estruturado que dispara um slash command no Cowork, mostrado pela Anthropic com o comando /dashboard: a dica do comando aparece na caixa de mensagem e o Claude faz uma pergunta com opções numeradas antes de começar. Fonte: Anthropic, 24 de fevereiro de 2026.
Meu pedido foi: receita líquida por categoria de produto para cada uma das últimas 8 semanas, contando apenas pedidos concluídos e descontando os itens, em SQLite, com o schema colado abaixo.
Aqui está o SQL que voltou, sem edição:
-- Net revenue by product category, last 8 complete weeks (Mon–Sun), completed orders only
-- Dialect: SQLite
WITH RECURSIVE
params AS (
SELECT
-- Monday of the current week; 'weekday 0' jumps forward to Sunday, -6 days lands on Monday
date('2026-09-28', 'weekday 0', '-6 days') AS current_week_start, -- 2026-09-28
date('2026-09-28', 'weekday 0', '-6 days', '-56 days') AS range_start -- 2026-08-03
),
-- One row per week, so weeks with no sales still show up
weeks AS (
SELECT range_start AS week_start
FROM params
UNION ALL
SELECT date(w.week_start, '+7 days')
FROM weeks AS w
CROSS JOIN params AS pr
WHERE date(w.week_start, '+7 days') < pr.current_week_start
),
categories AS (
SELECT DISTINCT category
FROM products
),
-- Filter and aggregate at the line-item level before building the grid
weekly_category_revenue AS (
SELECT
date(o.order_date, 'weekday 0', '-6 days') AS week_start,
p.category,
-- discount_pct is stored as 0–25 (a percent), not as a 0–0.25 fraction
SUM(oi.quantity * oi.unit_price * (1 - oi.discount_pct / 100.0)) AS net_revenue
FROM orders AS o
CROSS JOIN params AS pr
INNER JOIN order_items AS oi ON oi.order_id = o.order_id
INNER JOIN products AS p ON p.product_id = oi.product_id
WHERE o.status = 'completed'
-- Plain string comparison, so an index on order_date can be used; works for ISO-8601 dates
AND o.order_date >= pr.range_start
AND o.order_date < pr.current_week_start
GROUP BY 1, 2
)
SELECT
w.week_start,
date(w.week_start, '+6 days') AS week_end,
c.category,
ROUND(COALESCE(r.net_revenue, 0), 2) AS net_revenue
FROM weeks AS w
CROSS JOIN categories AS c
LEFT JOIN weekly_category_revenue AS r
ON r.week_start = w.week_start
AND r.category = c.category
ORDER BY w.week_start, net_revenue DESC, c.category;
Isso é mais longo do que eu teria digitado à mão, e o valor está justamente no extra. Cada bloco da query, chamado CTE (common table expression), faz um trabalho:
-
paramsancora tudo a uma data, facilitando repontar a query. -
weeksé recursivo e garante linha para semana sem vendas. -
weekly_category_revenuemantém apenasstatus = 'completed'e aplica o desconto como1 - discount_pct / 100.0, porque o schema diz que a coluna guarda percentuais inteiros de 0 a 25. -
O
SELECTfinal preenche lacunas com 0, deixando o output pronto para o gráfico.
A skill também lista as suposições abaixo da query, incluindo que order_date deve ser texto ISO 8601 (YYYY-MM-DD) para o filtro de faixa funcionar, e que pedidos reembolsados são totalmente descartados.
Rodei a query em shop.db e vieram 40 linhas, uma por semana e categoria. Aqui está pivotado para cada categoria ser uma coluna:
|
Semana iniciando |
Audio |
Fitness |
Home Office |
Kitchen |
Outdoor |
|
2026-08-03 |
12.714,80 |
9.187,23 |
13.542,08 |
7.925,04 |
7.621,21 |
|
2026-08-10 |
12.017,26 |
6.467,39 |
5.380,54 |
12.444,47 |
6.386,67 |
|
2026-08-17 |
8.808,47 |
4.669,72 |
6.675,32 |
7.513,97 |
4.485,65 |
|
2026-08-24 |
15.634,67 |
8.055,81 |
8.716,85 |
7.730,55 |
7.047,96 |
|
2026-08-31 |
11.402,99 |
11.517,37 |
14.252,59 |
9.954,80 |
7.226,14 |
|
2026-09-07 |
14.853,85 |
5.509,74 |
5.639,71 |
4.926,32 |
4.162,98 |
|
2026-09-14 |
8.780,41 |
4.893,28 |
7.864,22 |
7.344,70 |
6.204,45 |
|
2026-09-21 |
12.937,24 |
4.149,27 |
12.715,72 |
9.618,61 |
7.353,57 |
Audio é a maior categoria em 5 das 8 semanas e nunca cai abaixo de 8.780. Home Office foi a que mais variou, de 5.380 na semana de 10 de agosto para 14.252 na de 31 de agosto. Fitness termina o período no seu mínimo de 4.149 — o tipo de movimento que um relatório semanal deve destacar, e que o plugin que construí no Passo 4 de fato destaca.
O gráfico abaixo mostra os mesmos 40 números, um painel por categoria.

Figura 2. Receita líquida semanal de pedidos concluídos por categoria de produto nas 8 semanas completas até 27 de setembro de 2026, a partir do resultado do write-query. Imagem do autor.
Passo 3: personalizando um plugin instalado
Instalar leva 2 minutos. Personalizar é quando o plugin começa a valer a pena, porque os plugins da Anthropic são escritos para uma empresa genérica — e a sua não é. Há duas formas de fazer isso.
Usando Edit with Claude
Clicar em Edit with Claude abre uma tarefa no Cowork em que o Claude edita o plugin junto com você.

A central de ajuda ainda chama o botão de Customize. No app atual, abra o menu do plugin no canto superior direito e escolha Edit with Claude, que "abre uma tarefa nova no Cowork com um prompt pedindo ao Claude para personalizar o plugin escolhido", e então clique em Let's go. Por baixo dos panos, isso roda a skill cowork-plugin-customizer do Plugin Management plugin da Anthropic.
A skill primeiro busca nos arquivos do plugin por placeholders ~~, como ~~data warehouse, depois procura em qualquer Slack ou ferramenta de documentos conectada pelos nomes reais e, por fim, te pergunta o que não encontrou.
Uma edição concreta aqui é sua convenção de tabelas: diga que as tabelas canônicas vivem no schema analytics, que fct_orders é a única tabela de pedidos a consultar e que qualquer coisa com prefixo stg_ é proibida. O Claude escreve essas regras na skill de SQL e mostra o plugin personalizado na conversa; você aceita com o botão naquele resultado.
Editando os arquivos diretamente
A segunda forma é abrir os arquivos do plugin e editá-los você mesmo, ideal para mudanças que você já sabe como escrever. Três edições trazem mais retorno:
-
Adicionar contexto da empresa a uma skill. Anexe suas definições de métricas, as tabelas canônicas e as tabelas que nunca devem ser consultadas ao final de
skills/sql-queries/SKILL.md. O bloco que uso é o que vira sua própria skill no Passo 4, e 4 linhas dele são assim:
- orders: one row per order. status is completed, refunded, or canceled. order_date is ISO 8601 (YYYY-MM-DD).
- order_items: one row per product line. unit_price is the price charged before discount. discount_pct is a whole-number percentage from 0 to 25.
- products: one row per product, with its category.
- Never compute revenue from products.list_price. It is the catalog price, not what the customer paid.
-
Trocar conectores no
.mcp.json. Apague as entradas de serviços que você não usa e preencha a URL vazia de Snowflake ou Databricks com o endereço do seu servidor, ou adicione seu warehouse como conector customizado em Customize > Connectors. -
Incrementar a versão. Altere a versão no plugin.json sempre que editar, para diferenciar sua cópia do original.
Um ponto de atenção: o guia de plugins do Cowork diz que o Cowork verifica atualizações no marketplace e "se você editou arquivos de um plugin localmente, o Cowork detecta a mudança e avisa antes que uma atualização sobrescreva". Plugins gerenciados pela organização e plugins que um colega compartilhou com você não podem ser editados; copie primeiro para um plugin seu.
Outro alerta para usuários de Windows: um bug report aberto em 11 de setembro de 2026 descreve um plugin enviado por upload que fica congelado na primeira versão instalada, com novos uploads, desinstalações e reinstalações voltando ao estado anterior após reiniciar. Ainda estava aberto sem workaround em 6 de outubro de 2026; se suas edições pararem de persistir no Windows, confira esse tópico em vez de ficar reupando em loop.
Passo 4: criando um plugin personalizado do zero
Um plugin customizado é a resposta quando nenhum plugin do marketplace conhece seu fluxo de trabalho. Vamos montar um exemplo: um relatório semanal de métricas com 1 skill de conhecimento, 1 command e 1 conector.
Todos os arquivos aparecem completos, porque a pasta é o produto. A figura mostra o ciclo que você vai seguir.

Figura 3. Construindo um plugin customizado: escreva e valide os arquivos no seu computador, compacte e faça upload; depois rode o comando em uma nova tarefa e volte aos arquivos para ajustes. Imagem do autor.
Criando o esqueleto com Plugin Create
Plugin Create é o nome da Anthropic para a rota guiada e, em setembro de 2026, fica no menu Add. Vá em Customize, Plugins, Add e então Create with Claude, que abre uma tarefa no Cowork com o pedido já preenchido.

Descreva o trabalho nas palavras que você usaria com um colega, responda às perguntas do Claude sobre quais conectores incluir e clique em Save plugin no card de arquivo que ele gerar. No mesmo menu também há Create a plugin, um formulário e um editor para quem já sabe o que cada arquivo deve conter.
Para o plugin deste artigo, o briefing que eu digitaria está abaixo. Ele nomeia o único command, a única skill em segundo plano, o único conector e as regras — a mesma informação que as perguntas de descoberta da skill extrairiam de você, só que de uma vez.
Build me a plugin called Weekly Metrics Report for our online store's data team.
What it does: every Monday, compare the most recent complete week (Monday to Sunday) with the week before it and write a short Markdown report. Keep it to one command, /weekly-report, that runs the whole thing, and one background skill that holds our metric definitions so Claude never guesses them.
The definitions: net revenue is quantity times unit price after the line discount, for completed orders only. Completed orders are counted by distinct order ID. Average order value is net revenue divided by completed orders. Refund rate is refunded orders divided by completed plus refunded orders, as a percentage with one decimal. Cancelled orders never count toward anything.
The data: the canonical tables are orders, order_items, and products in our BigQuery warehouse. Never use products.list_price for revenue; it is the catalog price, not what the customer paid. Bundle the BigQuery connector and nothing else.
The report: a three-sentence summary that names the biggest mover and says whether it went up or down, a table of net revenue by product category (this week, last week, percentage change with one decimal and a sign), a second table with the overall metrics for both weeks, and the SQL at the end so a reader can check it. If either week has fewer than 20 completed orders, say the comparison is noisy.
Do not add agents, hooks, or any other skills.
A rota guiada roda a skill create-cowork-plugin do Plugin Management plugin no Knowledge Work marketplace. Você pode instalar esse plugin e rodar a skill pelo nome. Ele pergunta sobre o trabalho, componentes e conectores, e empacota o resultado em um arquivo .plugin.
Aqui está a pasta final:
weekly-metrics-report/
├── .claude-plugin/
│ └── plugin.json
├── .mcp.json
├── README.md
└── skills/
├── metric-definitions/
│ └── SKILL.md
└── weekly-report/
└── SKILL.md
O manifest nomeia o plugin e fixa a versão:
{
"name": "weekly-metrics-report",
"displayName": "Weekly Metrics Report",
"version": "0.1.0",
"description": "Builds the store's weekly metrics report from the warehouse, using the team's own metric definitions.",
"author": { "name": "Tim Lu" },
"license": "MIT"
}
O arquivo de conector lista um servidor, o mesmo endpoint do BigQuery usado pelo Data plugin, então quem conectou o BigQuery no Passo 2 não precisa autorizar nada novo:
{
"mcpServers": {
"bigquery": {
"type": "http",
"url": "https://bigquery.googleapis.com/mcp"
}
}
}
O README é opcional para um plugin privado e obrigatório se você for submetê-lo ao diretório, então já escrevi agora:
# Weekly Metrics Report
A small Cowork plugin that turns "how did last week go?" into a consistent report. It holds the store's metric definitions in one skill and the report workflow in another, and it bundles the BigQuery connector so Claude can query the warehouse directly.
## Use it
Run /weekly-metrics-report:weekly-report, or ask for the weekly numbers in plain words. Claude compares the most recent complete week with the week before, writes a Markdown report with per-category and overall tables, and includes the SQL it ran.
## Data
The plugin reads the orders, order_items, and products tables through the connector you sign in to. It stores nothing itself.
Escrevendo a skill
A skill de conhecimento guarda o contexto que era colado toda segunda. Aqui está o skills/metric-definitions/SKILL.md completo:
---
name: metric-definitions
description: The store's definitions of net revenue, completed orders, average order value, and refund rate, plus which warehouse tables are canonical. Use whenever a request involves revenue, sales, orders, refunds, discounts, or which table to query, even if it does not name a metric.
user-invocable: false
---
# Metric definitions for the store warehouse
Follow these definitions whenever you compute or report a store metric. If a request conflicts with them, follow the definitions and say so.
## Canonical tables
- orders: one row per order. status is completed, refunded, or cancelled. order_date is ISO 8601 (YYYY-MM-DD).
- order_items: one row per product line. unit_price is the price charged before discount. discount_pct is a whole-number percentage from 0 to 25.
- products: one row per product, with its category.
- Never compute revenue from products.list_price. It is the catalog price, not what the customer paid.
## Metrics
- Net revenue: SUM(quantity * unit_price * (1 - discount_pct / 100.0)) over order_items, for orders with status = 'completed'.
- Completed orders: COUNT(DISTINCT order_id) where status = 'completed'.
- Average order value: net revenue divided by completed orders.
- Refund rate: refunded orders divided by completed plus refunded orders, as a percentage with one decimal.
- Cancelled orders never count toward revenue, order counts, or the refund rate.
## Weeks
- A week runs Monday to Sunday. Label a week by its Monday.
- "Last week" means the most recent complete week, not the last 7 days.
A descrição é o que faz essa skill disparar com confiabilidade, e uma descrição vaga é a razão mais comum para uma skill nunca disparar. O Claude lê só o frontmatter até decidir carregar a skill, e a referência de skills do Claude Code diz para colocar o caso de uso principal primeiro.
Escreva a descrição como situações em que o leitor vai estar ("um pedido envolve receita, vendas, pedidos, reembolsos, descontos") em vez de um resumo do arquivo, e inclua as palavras que as pessoas usam, porque o Claude está comparando sua descrição com a mensagem delas.
Mais duas escolhas são deliberadas: user-invocable: false mantém esta skill fora do menu /, já que ninguém deve "rodar" um conjunto de definições. O corpo é escrito como instruções no imperativo para o Claude ("Nunca compute receita a partir de products.list_price"), que é o estilo pedido pela própria skill de autoria da Anthropic. A seção de tabelas é a parte que você trocaria pelos nomes do seu warehouse.
Escrevendo o command
O command também é um arquivo de skill, porque é assim que plugins novos definem ações nomeadas. Aqui está o skills/weekly-report/SKILL.md completo:
---
name: weekly-report
description: Build the store's weekly metrics report. Use when the user asks for the weekly report, the weekly numbers, week-over-week metrics, or how last week went.
argument-hint: "[a date inside the week to report on]"
---
# Weekly metrics report
Produce a short report comparing the most recent complete week with the week before it, using the definitions in the metric-definitions skill.
## Steps
1. Work out the reporting week. If the user gave a date, use the Monday-to-Sunday week that contains it. Otherwise use the most recent complete week before today.
2. Get the data. If a warehouse connector is connected, query it directly. If not, ask the user for a database file or an export and query that instead. Never estimate a number.
3. For the reporting week and the week before it, compute net revenue, completed orders, average order value, and refund rate, overall and per product category.
4. Write the report to a Markdown file named weekly_report_<week start>.md containing:
- A three-sentence summary that names the biggest mover and says whether it went up or down.
- A table with one row per category: net revenue this week, last week, and the percentage change.
- A second table with the overall metrics for both weeks.
- The SQL you ran, in a code block at the end, so the reader can check it.
5. Show the summary in the conversation and say where the file is.
## Rules
- Follow the metric-definitions skill for every metric. Do not invent new ones.
- Report percentage changes with one decimal place and a sign.
- If either week has fewer than 20 completed orders, say the comparison is noisy.
Esta skill é invocável pelo usuário por padrão, então aparece no menu / como /weekly-metrics-report:weekly-report, e o argument-hint documenta o único argumento que ela recebe.
O corpo cita a skill metric-definitions duas vezes, uma na abertura e outra nas regras, que é como o command chama a skill: o Claude carrega as definições porque elas são nomeadas e porque sua descrição combina com um pedido sobre receita.
Se você preferir o formato legado, o mesmo corpo funciona como commands/weekly-report.md com apenas a linha description no frontmatter.
Instalando e testando
Antes do upload, valide a pasta em relação ao diretório pai com claude plugin validate ./weekly-metrics-report, que exige o Claude Code instalado. Na minha máquina, apareceu ✔ Validation passed, e quando falha ele nomeia o campo a corrigir.
Depois compacte a pasta do plugin. Ambos os layouts funcionam: a pasta como entrada única de topo ou o conteúdo direto, desde que o arquivo contenha um .claude-plugin/plugin.json (o meu ficou com 3.067 bytes). Em seguida, vá em Customize, Plugins, Add, Upload plugin e selecione o zip.
Um plugin recém-adicionado carrega na próxima tarefa do Cowork, não na que está aberta, então inicie uma nova tarefa antes de procurá-lo. Se ainda assim não aparecer na nova tarefa, feche e reabra o app desktop antes de começar a depurar os arquivos.
Testei o plugin pelo Claude Code com claude --plugin-dir ./weekly-metrics-report, apontei para shop.db e digitei /weekly-metrics-report:weekly-report. O Claude percebeu que 28 de setembro de 2026 é uma segunda, reportou a semana de 21 de setembro e escreveu weekly_report_2026-09-21.md. Este é o resumo, na íntegra:
Net revenue rose to $46,774.42, up +33.3% from $35,087.07 the week before. Completed orders went from 61 to 78, and average order value rose slightly to $599.67 (+4.3%).
The biggest mover was Home Office: its net revenue went up +61.7% ($7,864.22 → $12,715.72), the largest gain in both dollars and percent.
Fitness was the only category that fell (-15.2%).
The refund rate rose from 10.3% to 12.4%, and Home Office's refund rate reached 27.6% (8 refunded orders), which is worth a closer look.
E esta é a tabela por categoria do mesmo arquivo:
|
Categoria |
Esta semana (2026-09-21) |
Semana passada (2026-09-14) |
Variação |
|
Audio |
$12,937.24 |
$8,780.41 |
+47.3% |
|
Fitness |
$4,149.27 |
$4,893.28 |
-15.2% |
|
Home Office |
$12,715.72 |
$7,864.22 |
+61.7% |
|
Kitchen |
$9,618.61 |
$7,344.70 |
+31.0% |
|
Outdoor |
$7,353.57 |
$6,204.45 |
+18.5% |
|
Total |
$46,774.42 |
$35,087.07 |
+33.3% |
Compare a última linha da tabela pivoteada no Passo 2 com a coluna "Esta semana" aqui: são os mesmos 5 números, de 2 plugins diferentes, porque ambos seguiram a mesma definição de receita líquida.
O Claude também fez 2 coisas que eu não pedi. Ele sinalizou que 4 das 5 categorias tiveram menos de 20 pedidos concluídos em pelo menos 1 semana, aplicando minha regra de comparação ruidosa por categoria. E apontou que minha regra de "reportar variações como porcentagens" é ambígua para a taxa de reembolso, que já é uma porcentagem, então reportou a variação em pontos percentuais.
Ambas eu faria como ajustes na skill a seguir, que é o ciclo da Figura 3: mudar uma linha, subir a versão, enviar de novo.
Quando o relatório estiver pronto, digite /schedule em qualquer tarefa do Cowork para rodar toda segunda de manhã sem você, já que tarefas agendadas rodam na nuvem da Anthropic. Desde 1º de outubro de 2026, tarefas agendadas criadas pelo Claude vêm por padrão como "Automatically approve" quando sua organização permite — mais um motivo para manter o conector como leitura. Nosso tutorial do Cowork Dispatch mostra a outra opção: disparar uma tarefa pelo celular.
Compartilhando um plugin do Cowork com seu time
A pasta do plugin é a unidade de distribuição, então compartilhar é decidir onde colocá-la. Envie para um repositório no GitHub com um marketplace.json listando-o e qualquer pessoa com a URL pode adicionar o repositório em Add e depois Add marketplace.
Nos planos Team e Enterprise, um owner pode sincronizar um repositório privado ou enviar zips em um marketplace da organização e definir cada plugin como disponível, instalado por padrão ou obrigatório, para todos ou grupos específicos. Membros podem compartilhar um plugin que criaram pelo menu de três pontos ou enviá-lo com Publish to org, e o guia de plugins para organização na central de ajuda cobre o restante.
Como verificar a saída de um plugin?
Você verifica a saída de um plugin lendo a query antes de confiar no gráfico, limitando o que o plugin pode acessar e sabendo onde olhar quando uma skill não dispara. Nada disso precisa de um time de segurança. Precisa de 5 minutos de hábito.
Leia o código antes do gráfico
Uma query com cara de boa pode responder a uma pergunta ligeiramente diferente da que você fez. Aqui vai uma que escrevi à mão para a mesma pergunta do Passo 2, e ela roda sem erro:
SELECT p.category,
ROUND(SUM(oi.quantity * p.list_price), 2) AS revenue
FROM orders AS o
JOIN order_items AS oi ON oi.order_id = o.order_id
JOIN products AS p ON p.product_id = oi.product_id
WHERE o.order_date >= '2026-08-03' AND o.order_date < '2026-09-28'
GROUP BY p.category
ORDER BY p.category;
Ela precifica cada linha pelo list_price do catálogo em vez do preço cobrado, ignora descontos e conta pedidos reembolsados e cancelados porque nunca filtra status. Rodar as duas queries em shop.db gera os totais abaixo, com a última coluna mostrando o quanto o atalho superestima a receita líquida.
|
Categoria |
Query do plugin (líquida, concluídos) |
Query atalho (list price, todos os pedidos) |
Superestimação |
|
Audio |
97.149,69 |
128.770,97 |
+32,5% |
|
Fitness |
54.449,81 |
71.237,81 |
+30,8% |
|
Home Office |
74.787,03 |
99.157,55 |
+32,6% |
|
Kitchen |
67.458,46 |
83.908,32 |
+24,4% |
|
Outdoor |
50.488,63 |
64.366,84 |
+27,5% |
|
Total |
344.333,62 |
447.441,49 |
+29,9% |
Toda categoria fica superestimada entre 24% e 33%, e um gráfico de barras de qualquer um parece igualmente razoável. A query do plugin acertou porque a skill mandou filtrar cedo e ler o schema.
Se ler uma query de 50 linhas ainda for lento para você, nossa trilha Associate Data Analyst in SQL é o caminho mais rápido para fluência. O guia de otimização de queries SQL explica práticas que a skill write-query segue, como filtrar antes de joinar e evitar SELECT *.
Mantenha conexões somente leitura
Um conector de warehouse com escrita coloca suas tabelas em risco por 2 lados: o Claude interpretar mal um pedido ("limpar pedidos de teste") como instrução para deletar, e prompt injection, quando um texto dentro de um documento ou página lida pelo Claude carrega instruções próprias. Em planos Team e Enterprise, a configuração que permite pular a aprovação por tarefa para ferramentas de escrita do conector vem desativada por padrão.
Para um guard-rail rígido, hooks rodam antes de toda chamada de ferramenta no Cowork e no Claude Code, então um hook que lê o SQL do conector e rejeita qualquer coisa diferente de SELECT é o padrão ideal. Nosso guia de hooks do Claude Code mostra como escrever um. Eu não construí esse hook para este artigo, então teste com seu conector antes de depender dele.
Quando uma skill falha ou não dispara, confira a descrição primeiro
O Claude decide a partir do frontmatter, então abra a skill e veja se a descrição cita a situação em que você estava e as palavras que você usou. Se não, adicione.
Depois acione a skill manualmente com / para confirmar que o corpo funciona, verifique se o toggle do plugin está ligado e se o conector mostra “Connected”, e lembre que um plugin carrega na próxima tarefa, não na atual. O culpado mais comum é uma descrição que resume o arquivo em vez de descrever o pedido.
Conheça o status do produto
O Cowork está em disponibilidade geral desde 9 de abril de 2026. Os plugins foram lançados como research preview em 30 de janeiro de 2026, e agora estão listados como disponíveis em todos os planos pagos. Em 11 de agosto de 2026, a Anthropic expandiu a cobertura da Compliance API para sessões do Cowork no desktop, web e mobile.
Duas lacunas permanecem na central de ajuda atual: transcrições de sessões locais no desktop ainda não têm endpoint de exclusão, e o monitoramento via OpenTelemetry "não substitui logs de auditoria para fins de compliance".
Se sua organização lida com dados de saúde dos EUA em um plano Enterprise com HIPAA, o Cowork só fica coberto pelo seu Business Associate Agreement depois que um admin aplica a configuração de HIPAA e, com isso ativo, o Cowork não pode rodar na nuvem. Se seus dados são regulados, obtenha o aval do time de compliance antes de um plugin tocar tabelas de produção.
Considerações finais
Agora você tem 3 plugins: o Data plugin que instalou, a cópia que personalizou com os nomes das suas tabelas e o relatório semanal que você criou a partir de 5 arquivos. O terceiro é o que eu manteria, porque guarda as 40 linhas de contexto que eram coladas toda segunda — e guarda uma vez só.
A regra para decidir o que merece um plugin é simples: vale construir um plugin quando o fluxo se repete e o contexto se mantém estável — como um relatório semanal, um checklist de revisão de contrato ou a preparação para uma call de vendas. Uma análise pontual não precisa: cole o contexto e siga em frente.
E se você está decidindo quais fluxos repetitivos na sua empresa devem receber esse tratamento primeiro, nosso curso Generative AI for Business é construído exatamente em torno dessa pergunta. Para ir mais a fundo no modelo por trás de tudo isso, o curso Introduction to Claude Models cobre prompts e trabalho multi-turn com a API do Claude.
FAQs sobre plugins do Claude Cowork
O que são plugins do Claude Cowork?
Plugins do Claude Cowork são pacotes instaláveis que reúnem skills, slash commands, conectores e, no Cowork e no Claude Code, subagentes e hooks, para o Claude atuar como um especialista em uma função. A Anthropic os adicionou ao Cowork em 30 de janeiro de 2026, com 11 plugins open-source, e eles estão disponíveis em todos os planos pagos do Claude.
Qual é a diferença entre um plugin do Claude Cowork e uma skill?
Uma skill é um arquivo SKILL.md que ensina ao Claude uma única tarefa e dispara quando o Claude a julga relevante. Um plugin é o conjunto empacotado de skills, commands e conectores para uma função inteira e é a unidade que você instala, compartilha e versiona.
Como instalo um plugin do Claude Cowork?
Abra Customize na barra lateral esquerda do app desktop do Claude, vá à aba Plugins, abra Discover, selecione o plugin e clique em Add. O plugin é salvo na sua conta, então também aparece no chat e sincroniza com o Claude Code quando você entra com a mesma conta.
Plugins do Cowork funcionam no Claude Code e no chat?
Sim para skills, commands e conectores, que carregam no chat, no Cowork e no Claude Code. Subagentes e hooks rodam apenas no Cowork e no Claude Code, e servidores MCP locais rodam apenas no Claude Code e em sessões do Cowork que rodam no seu computador.
Consigo criar um plugin do Claude Cowork sem programar?
Sim. Um plugin é uma pasta com Markdown e JSON, e a opção Create with Claude em Customize > Plugins > Add guia você em uma conversa e salva o resultado na sua conta. Escrever os arquivos à mão exige um editor de texto e uma ferramenta de zip; o plugin weekly-report deste artigo tem só 5 arquivos curtos.

Sou um cientista de dados com experiência em análise espacial, machine learning e pipelines de dados. Trabalhei com GCP, Hadoop, Hive, Snowflake, Airflow e outros processos de engenharia/ciência de dados.


Toda segunda-feira, alguém abre o Claude, cola as mesmas 40 linhas de contexto sobre o warehouse e pede os mesmos números semanais. Na terça, esse contexto já sumiu e o próximo analista cola uma versão um pouco diferente. Um plugin ajuda a manter esse tipo de tarefa consistente e verificável.
Ao final deste tutorial, você terá instalado um plugin no Claude Cowork, personalizado para as suas tabelas e criado um plugin funcional do zero.
Você precisa de 2 coisas: um plano pago do Claude (Pro, Max, Team ou Enterprise) e o app do Claude para desktop no macOS ou Windows, que é o que aparece nas capturas de tela. Não precisa de terminal nem de Python. Vou mencionar o caminho pela linha de comando para quem preferir, mas é opcional.
Antes de começar, um aviso. Em 16 de setembro de 2026, a Anthropic começou a unificar o Chat e o Cowork em um único Claude para contas Pro e Max, então sua caixa de mensagem pode não mostrar mais a opção separada do Cowork. A página Customize, onde vivem os plugins, é a mesma de qualquer forma, e eu cito exatamente os rótulos do menu ao longo do texto.
Se preferir praticar com exercícios guiados, o curso Building Claude Cowork Plugins da DataCamp mostra como instalar, adaptar e criar seu próprio plugin, sem escrever código.
Em poucas palavras