13 Claude Skills para Nuvemshop
Cada skill conecta diretamente na API da sua loja e entrega análises em 2 minutos — sem planilha, sem exportação manual.
Projeto pessoal, não oficial. Estas skills foram criadas por Thiago Rocha e não têm relação com a Nuvemshop — a empresa não oferece suporte a este projeto. Use por sua conta e risco e sempre revise os dados antes de aplicar qualquer alteração na sua loja.
Outputs reais. Todos os resultados abaixo foram gerados via API da Nuvemshop durante os testes de desenvolvimento, usando uma loja com volume reduzido. Em uma loja real com centenas de pedidos, as tabelas ficam mais ricas — mas o formato e os campos são exatamente estes.
Como começar — 5 minutos, uma vez só
Configure uma vez, funciona para sempre. Você vai precisar de um computador (Mac ou Windows) com acesso ao terminal.
✓ Mac ou Windows
✓ ~5 minutos
✓ Acesso ao admin da loja
1
Instale o Node.js e o Claude Code
O Claude Code precisa do Node.js para funcionar. Se você nunca instalou, baixe a versão LTS em nodejs.org — é um instalador comum, como qualquer programa. Depois, abra o terminal e rode:
npm install -g @anthropic-ai/claude-code
Como abrir o terminal: Mac → pressione Cmd+Espaço, digite 'Terminal' e Enter. Windows → pressione a tecla Windows, digite 'cmd' e Enter. Já tem Node.js? Pule direto para o comando acima.
2
Baixe as 13 skills
As skills ficam em uma pasta especial que o Claude lê automaticamente. Cole os dois comandos abaixo no terminal para baixar e instalar todas de uma vez:
# 1. Baixa as skills do GitHub
git clone https://github.com/thiagorocha-2/nuvemshop-claude-skills
# 2. Copia para a pasta do Claude
mkdir -p ~/.claude/skills && cp -r nuvemshop-claude-skills/*/ ~/.claude/skills/
Não sabe usar git? Acesse github.com/thiagorocha-2/nuvemshop-claude-skills, clique em 'Code → Download ZIP', descompacte e copie as pastas para ~/.claude/skills/
3
Gere o token da sua loja na Nuvemshop
O token dá permissão para as skills lerem os dados da sua loja. No painel admin: Potencializar → Aplicativos sob medida → Criar aplicativo. Anote o Store ID (número que aparece no URL da loja) e o Access Token gerado.
O token não expira — você gera uma vez e usa para sempre. Guarde em local seguro.
4
Salve as credenciais no terminal
Cole o bloco abaixo no terminal substituindo os valores em verde pelo seu Store ID e Token do passo anterior. Isso salva permanentemente — você não precisa repetir.
# Substitua pelos seus dados reais
echo 'export NUVEMSHOP_STORE_ID=SEU_ID_AQUI' >> ~/.zshrc
echo 'export NUVEMSHOP_TOKEN=SEU_TOKEN_AQUI' >> ~/.zshrc
source ~/.zshrc
Windows? Painel de Controle → Sistema → Configurações avançadas do sistema → Variáveis de Ambiente. Crie NUVEMSHOP_STORE_ID e NUVEMSHOP_TOKEN como variáveis de usuário.
5
Pronto — abra o Claude e use qualquer skill
Abra o terminal, rode claude e digite o nome de qualquer skill com /. O Claude vai pedir permissão para rodar os scripts — aprove. Em ~10 segundos você tem o resultado da sua loja na tela.
# Abre o Claude Code
claude
# Dentro do Claude, digite qualquer skill:
/daily-digest
/catalog-health
/rfm-segmentation
Cada skill guia você pelo fluxo — coleta dados, mostra um preview e pede confirmação antes de qualquer alteração na loja.
01
LATAM only
Prompt
/payment-mix-analyzer dias=90
===== ANÁLISE DE MIX DE PAGAMENTOS (histórico completo) =====
Total de pedidos pagos analisados: 43
Meio de Pagamento Pedidos % Pedidos GMV (R$) % GMV Ticket Médio
-------------------------------------------------------------------------------------
Cartão 1x (à vista) 41 95.3% 360.55 95.6% 8.79
Custom 1 2.3% 15.46 4.1% 15.46
PIX 1 2.3% 1.00 0.3% 1.00
-------------------------------------------------------------------------------------
TOTAL 43 100.0% 377.01 100.0% 8.77
--- Insights ---
Meio dominante: Cartão 1x (à vista) (95.3% dos pedidos)
⬡ Loja de teste — em lojas reais aparecerão PIX, boleto e múltiplas faixas de parcelamento com volumes significativos
02
LATAM only
Prompt
/rfm-segmentation
===== SEGMENTAÇÃO RFM =====
Pedidos analisados: 43 | Clientes únicos: 12
Segmento Clientes % Base
-----------------------------------------------
Em Risco 8 66.7%
Dormente 4 33.3%
-----------------------------------------------
TOTAL 12 100.0%
Clientes com telefone para WhatsApp: 11
Clientes que aceitam marketing: 6
→ CSV exportado: ~/Downloads/rfm_segmentation.csv
⬡ Loja de teste — em lojas com histórico maior surgem segmentos Campeão, Cliente Fiel e Novo Cliente
03
Prompt
/stockout-predictor dias_alerta=14
===== PREVISÃO DE RUPTURA DE ESTOQUE =====
Threshold: 14 dias | Velocity baseada em 365 dias de histórico
Produtos com histórico de vendas: 10 | Estoque coletado de 7 produtos...
✅ OK — mais de 28 dias (2 SKUs)
Nota: sem vendas nos últimos 30d — velocity calculada pelo histórico anual.
Todos os SKUs com stock_management=true têm estoque suficiente para o ritmo atual.
Resumo: 0 zerados | 0 críticos | 0 em atenção | 2 OK
⬡ Dados reais — 10 SKUs com histórico de vendas, 2 com stock_management ativo. Em lojas com vendas diárias a tabela exibe dias restantes por SKU com alertas críticos
04
LATAM only
Prompt
/shipping-optimizer dias=90
===== ANÁLISE DE FRETE GRÁTIS =====
Pedidos analisados: 43
Ticket médio (total): R$ 8.77
Subtotal médio (só produtos): R$ 7.24
Frete médio cobrado: R$ 2.27
Pedidos já com frete grátis: 14 (32.6%)
--- Simulação de Thresholds ---
Threshold Elegíveis % do Total Custo Est./mês
------------------------------------------------------------------
R$ 10.00 11 25.6% R$ 8.31/mês
--- Recomendação ---
Threshold recomendado: R$ 10
Elegíveis: 25.6% dos pedidos (11 de 43)
Ticket médio acima do threshold: R$ 22.03 (+R$ 13.26 vs média)
Custo estimado de frete absorvido: R$ 8.31/mês
Frete médio por pedido: R$ 2.27
⬡ Dados reais da loja — tickets pequenos porque é loja de teste. Em lojas reais os thresholds ficam na faixa R$100–R$300
05
Prompt
/cross-sell-recommender
===== CROSS-SELL POR CO-COMPRA =====
Pedidos analisados: 43 | Com 2+ produtos: 1
Pares de co-compra encontrados: 1
Produto Âncora Cross-sell Co-compra
------------------------------------------------------------------------------------------
Camiseta D2C (Branco, G) Remera Superman 12.5%
Remera Superman Camiseta D2C (Branco, G) 100.0%
Dados insuficientes para recomendações confiáveis.
Esta análise requer 50+ pedidos com 2+ itens para ser estatisticamente válida.
Continue usando a loja e rode novamente quando tiver mais pedidos.
⬡ Loja de teste com volume baixo — skill funciona, mas precisa de mais dados. Em lojas reais gera dezenas de pares com % confiáveis
06
Prompt
/abandonment-analysis dias=30
===== ANÁLISE DE ABANDONO E CANCELAMENTO =====
Abandonados: 0 | Cancelados: 33 | Pagos: 43 | Pendentes: 29
Status do Funil (histórico completo)
--------------------------------------------------
Pagos: 43 41.0%
Abandonados: 0 0.0%
Cancelados: 33 31.4%
Pendentes: 29 27.6%
TOTAL: 105
Motivos de Cancelamento
----------------------------------------
refund 23 69.7%
customer 9 27.3%
other 1 3.0%
Top Produtos em Pedidos Perdidos (cancelados)
------------------------------------------------------------
Camiseta Harlem (Branco, G) 15 pedidos perdidos
Camiseta essential cinza chumbo 13 pedidos perdidos
Camiseta D2C (Branco, G) 1 pedidos perdidos
Short sustentável em linho ECO Preto 1 pedidos perdidos
Camiseta essential marrom 1 pedidos perdidos
Top Faixa dupla face Mostarda 1 pedidos perdidos
⬡ Dados reais — 69.7% dos cancelamentos são por reembolso. Camiseta Harlem tem 15 pedidos cancelados — padrão real detectado pela skill
07
Prompt
/cohort-retention
===== COHORT DE RETENÇÃO =====
Pedidos analisados: 43 | Clientes únicos: 12
Clientes com 2+ compras: 8 (66.7%)
Cohort Clientes M+1 M+2 M+3 M+6
---------------------------------------------------------
2025-09 11 18.2% 0.0% 0.0% 0.0%
2025-10 1 0.0% — — —
Nota: % de clientes do cohort que voltaram a comprar em cada mês seguinte.
⬡ Loja de teste — apenas 2 meses de dados. Em lojas reais a tabela tem 6–12 meses e mostra tendências de retenção claras
08
Prompt
/price-margin-analysis desconto_min=20 margem_max=30
===== ANÁLISE DE PREÇO + MARGEM =====
Filtro: desconto ≥ 20% E margem ≤ 30%
Produtos encontrados: 209
Variants sem custo preenchido: 910
Nenhum produto encontrado com esse critério.
Motivo: 910 variants não têm o campo "custo" cadastrado na Nuvemshop.
A skill ignora variants sem custo para evitar análise imprecisa.
→ Para usar esta skill: cadastre o custo de cada produto em
Admin → Produtos → [produto] → Variantes → Custo
→ Com o custo preenchido, a skill detecta automaticamente os
produtos onde desconto + margem estão em zona de risco
⬡ Comportamento real — a skill detectou que 910 variants não têm custo cadastrado e avisou claramente, sem quebrar
09
Prompt
/seo-meta-generator quantidade=50 idioma=pt-BR
===== GERADOR DE SEO LOCAL (preview) =====
10 produtos mais vendidos encontrados
Produto seo_title atual seo_desc atual
----------------------------------------------------------------------------------------------------
Maiô Body Regata recorte tela Cinza Ch Maiô Body Regata com Recorte Maiô Body Regata cinza chumbo com r
Maiô Body Regata recorte tela Off Whit Maiô Body Regata Off White c Maiô regata off white com recorte e
Maiô Body Regata recorte tela Marrom (vazio) (vazio)
Maiô Body Regata recorte tela Preto "Maiô Regata Versátil com Re Descubra o Maiô Regata com Recorte
Conjunto: Top Meia Taça + Calcinha Asa (vazio) (vazio)
Conjunto: Top Meia Taça + Calcinha Asa (vazio) (vazio)
Conjunto: Top Meia Taça + Calcinha Asa (vazio) (vazio)
Conjunto: Top Meia Taça + Calcinha Asa (vazio) (vazio)
Com seo_title preenchido: 4/10
Sem seo_title (a gerar): 6/10
→ Claude gera seo_title (≤70 chars) e seo_description (≤320 chars) para cada um
→ Preview exibido antes de qualquer alteração na loja
→ Confirme "s" para aplicar via PUT /products/{id}
⬡ Dados reais — detectou 6 de 10 produtos top sem SEO preenchido. Produtos e categorias são da loja real (moda praia/fitness)
10
Prompt
/product-description-rewriter categoria="Maiôs / Bodies" palavras=100
===== REESCRITOR DE DESCRIÇÕES =====
Categorias disponíveis (44 encontradas):
ID Categoria
-------------------------------------------------------
31206946 Maiôs / Bodies
31206958 Regata com tela
31206971 Manga longa
31206960 Biquinis
31206961 Conjuntos
31206962 Meia taça + Asa delta
31206972 Surf reguladores + Surf tirinha
31206979 Cortininha + Lacinho
31207142 Camisetinha sport + Largo sport
31207148 Fixo confy + Basic duo
... +34 categorias
Produtos da categoria 'Maiôs / Bodies' (amostra):
• Maiô Body Regata recorte tela Cinza Chumbo
Desc atual: "Vocês já conhecem o nosso mais novo queridinho? Apresentamos o Maiô Regata com Re..."
• Maiô Body Regata recorte tela Off White
Desc atual: "Vocês já conhecem o nosso mais novo queridinho? Apresentamos o Maiô Regata com Re..."
• Maiô Body Regata recorte tela Marrom
Desc atual: "Vocês já conhecem o nosso mais novo queridinho? Apresentamos o Maiô Regata com Re..."
→ Escolha categoria + voz da marca → Claude reescreve + preview → confirme → PUT
⬡ Dados reais — 44 categorias reais da loja. Descrições atuais são idênticas entre produtos — exatamente o caso que a skill resolve
11
Prompt
/bulk-price-updater ajuste_pct=15 campo=ambos
===== PREVIEW DE AJUSTE — +15% em AMBOS =====
Produto Preço → Novo Custo → Novo Markup
------------------------------------------------------------------------------------------------------
Maiô Body Regata recorte tela Cinza Ch — cinza 293.00 → 336.95 0.00 → 0.00 —
Maiô Body Regata recorte tela Cinza Ch — cinza 289.00 → 332.35 0.00 → 0.00 —
Maiô Body Regata recorte tela Off Whit — Off Whi 293.00 → 336.95 0.00 → 0.00 —
Maiô Body Regata recorte tela Off Whit — Off Whi 289.00 → 332.35 0.00 → 0.00 —
Conjunto: Top Meia Taça + Calcinha — Cinza Chum 189.90 → 218.39 0.00 → 0.00 —
Conjunto: Top Meia Taça + Calcinha — Off White 189.90 → 218.39 0.00 → 0.00 —
... e mais 920 variantes
Total de variantes a atualizar: 926
Variantes sem custo cadastrado: 910
→ Preencha o campo custo para calcular markup e margem
→ Confirme para aplicar via PUT /products/{id} em batch
⬡ Dados reais — 926 variantes detectadas, 910 sem custo preenchido. Com custo preenchido, o ajuste proporcional aplica via PUT em batch com uma única confirmação
12
Prompt
/catalog-health
===== DIAGNÓSTICO DE SAÚDE DO CATÁLOGO =====
Produtos publicados analisados: 209
🔴 Variantes publicadas com estoque 0: 182
• Conjunto: Top Meia Taça + Calcinha — Com bojo
• Calcinha Asa Delta Marrom — Marrom
• Top Surf Reguladores Cinza chumbo — Com bojo
... e mais 179
🔴 Produtos sem nenhuma imagem: 205
• Maiô Body Regata recorte tela Cinza Chumbo
• Maiô Body Regata recorte tela Marrom
... e mais 203
🟡 Produtos sem descrição (< 30 chars): 36
🟡 Produtos sem seo_title: 164
🟡 Produtos sem seo_description: 164
⚪ Produtos com variante sem custo: 207
--- Ordem de Prioridade ---
1. ⚡ 205 produto(s) sem foto — não convertem
2. ⚡ 182 variante(s) com estoque 0 publicadas — esconder ou repor
3. 📈 164 produto(s) sem seo_title — rode /seo-meta-generator
4. ✍ 36 produto(s) sem descrição — rode /product-description-rewriter
5. 💰 207 produto(s) sem custo — preencha para usar /price-margin-analysis
⬡ Dados reais — 958 problemas detectados nesta loja de teste. Em produção roda semanalmente como checklist operacional antes de abrir o admin
13
Prompt
/daily-digest
=======================================================
DAILY DIGEST — 14/05/2026
=======================================================
📊 GMV (últimos 7 dias)
R$ 0.00 ▼ -100.0% vs 7 dias anteriores
(0 pedidos | período anterior: R$ 377.01, 43 pedidos)
🏆 TOP PRODUTOS
Camiseta Harlem (Branco, G) 21 un.
Camiseta D2C (Branco, G) 8 un.
Camiseta essential cinza chumbo (G, cinza) 8 un.
Kimono em linho ECO Azul Royal 6 un.
Remera Superman 1 un.
⏳ PAGAMENTOS PENDENTES
29 pedidos aguardando — R$ 1,834.78 em risco
❌ CANCELAMENTOS (histórico)
33 cancelamentos | Principal: reembolso (23x)
Receita perdida: R$ 2,221.10
⚠️ ESTOQUE CRÍTICO (≤ 5 unidades)
🔴 Conjunto: Top Meia Taça + Calcinha — Com bojo ZERADO
🔴 Calcinha Asa Delta Marrom ZERADO
🔴 Top Surf Reguladores Cinza chumbo — Com bojo ZERADO
... e mais 179 SKUs zerados
💡 AÇÕES RECOMENDADAS HOJE
1. 182 SKU(s) com estoque zerado — repor ou despublicar
2. 29 pedidos pendentes (R$ 1,834.78) — ative recuperação WhatsApp
3. Taxa de cancelamento alta (33/76) — rode /abandonment-analysis
=======================================================
⬡ Dados reais — briefing gerado via API em ~8 segundos. Loja de teste sem vendas recentes; em lojas ativas mostra delta de GMV semana a semana e top produtos do período