convez.ai
SkillProdutividadeIntermediário
TonelliMG

Tonelli Claude Skills

TonelliMG/tonelli-claude-skills

Skills curadas do Claude Code organizadas por stack — instale globalmente ou por projeto

Ver no GitHub
InicialPluginScore · de 0 a 100

Coletânea curada de skills para Claude Code organizadas por stack (AdvPL, React/Next, Flutter, Node.js, n8n) e prontas para instalação global ou local. Cada skill encapsula instruções, contexto e convenções de desenvolvimento para acelerar workflows específicos sem repetir contexto manualmente.

Instalação

$npx convez-ai TonelliMG/tonelli-claude-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Acelerar desenvolvimento em múltiplas stacks (AdvPL, React, Flutter, Node.js)
  • Padronizar fluxo de trabalho (planejamento, debug, revisão, finalização)
  • Automatizar workflows com n8n carregando contexto do Claude
  • Reutilizar convenções e manuais entre projetos sem repetição

Veredito

Repositório bem-estruturado que traz valor real ao reduzir repetição de contexto em workflows multi-stack. A curadoria é honesta (skills que o autor realmente usa) e a documentação é clara, embora tenha público-alvo mais restrito (devs em stacks TOTVS, React, Flutter e n8n).

README

A tradução para o português deste README ainda está na fila.

tonelli-claude-skills

Uma coletânea curada de Skills do Claude Code que fazem sentido no meu dia a dia de desenvolvimento — organizadas por stack e prontas para instalar globalmente (valem para qualquer projeto) ou localmente (dentro de um projeto específico).

Skills são pacotes de instruções, contexto e conhecimento especializado que o Claude Code carrega automaticamente quando a tarefa combina com a descrição da skill. Na prática, é como dar ao Claude um "manual" do seu jeito de trabalhar, da sua stack e das suas convenções — sem precisar repetir o mesmo contexto toda vez.

Este repositório reúne as skills que uso de verdade, agrupadas em sete frentes:

  • 🌍 Global — fluxo de trabalho (planejar, depurar, revisar, finalizar)
  • 🟦 Advpl — desenvolvimento TOTVS Protheus (AdvPL / TLPP)
  • ⚛️ React / Next — frontend moderno com React e Next.js
  • 🐦 Flutter — aplicações cross-platform com Flutter e Dart
  • 🟩 Node.js — APIs, especificações OpenAPI e otimização SQL
  • 🔁 n8n — automação de workflows e integrações low-code
  • 🧑‍💻 Pessoais — minhas skills autorais

📑 Sumário


🧠 Como as Skills funcionam

Cada skill é uma pasta contendo um arquivo SKILL.md com um frontmatter (name + description) e o corpo com as instruções. O Claude Code lê a description de todas as skills instaladas e decide sozinho quando ativar uma delas, com base no que você está pedindo. Você também pode invocá-las manualmente com /nome-da-skill.

minha-skill/
├── SKILL.md          # frontmatter (name, description) + instruções
├── reference.md      # (opcional) material de apoio carregado sob demanda
└── ...

Quanto mais específica a description, melhor o Claude acerta o momento de usar a skill.


🚀 Instalação

Pré-requisito: ter o Claude Code instalado.

Há dois lugares onde as skills podem viver:

Instalação Global

Skills globais ficam disponíveis em todos os projetos da sua máquina. São ideais para fluxos de trabalho que independem da stack (planejar, depurar, revisar etc.).

Local de instalação (Windows):

C:\Users\<seu-usuario>\.claude\skills

No meu caso:

C:\Users\raphael.tonelli\.claude\skills

Basta copiar a pasta da skill para dentro desse diretório:

# Exemplo: instalar todas as skills globais
Copy-Item -Recurse .\Global\skills\* "$env:USERPROFILE\.claude\skills\"

💡 Em macOS/Linux o caminho equivalente é ~/.claude/skills.

Instalação Local (por projeto)

Skills locais ficam dentro do projeto e são versionadas junto com ele — perfeito para compartilhar com o time e amarrar a skill à stack daquele repositório. Use estas para as skills de Advpl, React/Next etc., conforme a stack do projeto.

Local de instalação:

<raiz-do-projeto>\.claude\skills
# Exemplo: instalar as skills de React no projeto atual
New-Item -ItemType Directory -Force ".\.claude\skills" | Out-Null
Copy-Item -Recurse "C:\caminho\para\tonelli-claude-skills\React\skills\*" ".\.claude\skills\"

💡 Como ficam dentro de .claude/skills no projeto, podem ser commitadas no Git e o time inteiro passa a ter o mesmo contexto.


📜 CLAUDE.md global

Além das skills, este repositório traz um CLAUDE.md — um arquivo de diretrizes de comportamento que o Claude Code carrega automaticamente como contexto. Enquanto as skills entregam conhecimento sob demanda, o CLAUDE.md define como o Claude deve trabalhar em todos os meus projetos: pensar antes de codar, manter simplicidade, fazer mudanças cirúrgicas, verificar antes de afirmar e — importante — usar as skills só quando a tarefa realmente exigir.

Ele também ensina ao Claude o catálogo das minhas skills (globais e por stack), deixando claro que elas são opcionais: se uma skill não estiver instalada no projeto, o desenvolvimento segue normalmente sem ela.

Principais diretrizes:

  • 🧠 Pensar antes de codar — explicitar suposições, apontar interpretações ambíguas e sugerir abordagens mais simples.
  • ✂️ Mudanças cirúrgicas — editar só o que o pedido exige; não mexer em código não relacionado nem ao fluxo.
  • 🪶 Simplicidade primeiro — o mínimo de código que resolve; nada especulativo. A maioria das tarefas é simples.
  • ✅ Evidência antes de afirmar — não dizer "pronto/corrigido" sem verificar a saída.
  • 🎨 Respeitar o padrão do projeto — em React/Next, seguir o que o projeto já usa (Tailwind, shadcn/ui ou CSS manual).
  • 🔤 Encoding Protheus — fontes AdvPL/TLPP sempre em Windows-1252 (CP1252).
  • 🧩 Skills sob demanda — plan/debug só quando solicitados; /commit e /merge quando chamados; code review para conferir mudanças.

Instalação (global, vale para todos os projetos):

É possível usá-lo por projeto: basta colocar uma cópia (ajustada às necessidades do repositório) na raiz do projeto. Quando há um CLAUDE.md no projeto, as instruções dele têm prioridade sobre as globais.


📦 Skills disponíveis

🌍 Global — Fluxo de trabalho

Skills de processo de desenvolvimento, agnósticas de stack. Recomendadas para instalação global. Vêm do excelente projeto obra/superpowers.

SkillO que faz
writing-plansTransforma uma spec ou conjunto de requisitos em um plano de implementação detalhado antes de tocar no código.
executing-plansExecuta um plano de implementação já escrito, em sessão separada e com checkpoints de revisão.
systematic-debuggingAplica um método sistemático de depuração diante de qualquer bug, teste falhando ou comportamento inesperado — antes de propor correções.
verification-before-completionExige rodar comandos de verificação e confirmar a saída antes de afirmar que algo está pronto/corrigido/passando. Evidência antes de afirmações.
requesting-code-reviewConduz uma revisão de código ao concluir tarefas ou antes de fazer merge, garantindo que o trabalho atende aos requisitos.
receiving-code-reviewOrienta a recepção de feedback de code review: verificar antes de implementar, perguntar antes de assumir, fazer pushback técnico quando necessário — sem concordância performática.
finishing-a-development-branchAjuda a finalizar uma branch de desenvolvimento apresentando opções estruturadas de merge, PR ou limpeza.
carefulAtiva guardrails de segurança para comandos destrutivos (rm -rf, DROP TABLE, git push --force, kubectl delete etc.): emite aviso antes de cada operação de risco. Use com "be careful", "safety mode" ou "prod mode".

Fonte original: github.com/obra/superpowers · gstack (careful)


🟦 Advpl — TOTVS Protheus (AdvPL / TLPP)

Skills focadas no desenvolvimento de customizações no ERP TOTVS Protheus. Recomendadas para instalação local, nos projetos AdvPL/TLPP.

SkillO que faz
advpl-to-tlpp-migrationGuia a migração de código legado AdvPL → TLPP: comparação de recursos, transformação de sintaxe, includes/namespaces, tipagem, Try-Catch, REST, identificadores longos, JSON inline, parâmetros nomeados, modificadores de acesso e remoção de StaticCall.
mvc-generatorGera estruturas de tela MVC do Protheus (ModelDef, ViewDef, MenuDef, BrowseDef) com FWFormModel/View/Browse, validações, gatilhos e hooks — Modelo 1 (entidade única) e Modelo 3 (master-detail).
tlpp-rest-endpoint-generatorGera endpoints REST em TLPP com roteamento por anotações (@Get, @Post, @Put, @Patch, @Delete) e o objeto oRest, seguindo o padrão TOTVS (TTALK): paginação, modelo de erro, headers padrão e Swagger.
fwrest-client-generatorGera código AdvPL/TLPP que consome APIs REST externas via classe FWRest: verbos HTTP, headers, parâmetros, JSON, autenticação (Basic, Bearer/JWT, OAuth 2.0), timeout, SSL e tratamento de erros.
entry-point-designerProjeta e documenta Pontos de Entrada do Protheus (assinatura de User Function, layout de PARAMIXB, retornos e ProtheusDOC). Gera TLPP por padrão; AdvPL apenas quando solicitado.
query-builderMonta queries SQL seguras e otimizadas para tabelas Protheus: filtros obrigatórios (D_E_L_E_T_, filial), índices sugeridos via SIX, versões Embedded SQL (FWExecStatement) e Workarea (DBSelectArea/DBSeek), com alertas de armadilhas comuns.
data-dictionary-lookupConsulta o dicionário de dados do Protheus (SX2, SX3, SIX, SX6, SX5, SX7, SX1, SX9, SXB, SXG/SXA): campos, índices, parâmetros, gatilhos, relacionamentos e validação de impacto em refatorações/migrações.
sql-optimizationOtimização universal de performance SQL (PostgreSQL, SQL Server, Oracle): análise de plano de execução, estratégias de indexação, paginação, operações em lote e monitoramento.
code-reviewRevisão de código AdvPL/TLPP cobrindo regras SonarQube, documentação Protheus.doc, segurança, performance, clean code e boas práticas do framework Protheus.
refactorRefatoração cirúrgica para melhorar manutenibilidade sem mudar comportamento: extração de funções, renomeações, quebra de "god functions", tipagem e eliminação de code smells.
context-mapGera um mapa de contexto dos arquivos relevantes a uma mudança antes de implementar: arquivos a alterar, dependências, testes e padrões de referência.
utf8-to-cp1252-conversionConverte arquivos-fonte AdvPL/TLPP de UTF-8 para Windows-1252 (CP1252) — encoding exigido pelo compilador Protheus. Essencial após qualquer geração de código por IA.

Fonte original: skills.engpro.totvs.io


⚛️ React / Next — Frontend

Skills de boas práticas de frontend moderno. Recomendadas para instalação local, em projetos React/Next.js. A pasta Next/ é um superconjunto da React/ (inclui as mesmas skills + next-best-practices).

SkillO que fazReactNext
building-componentsGuia para construir componentes de UI modernos, acessíveis e componíveis: acessibilidade (ARIA, teclado, foco), APIs componíveis (slots, render props, estado controlado/não-controlado), design tokens, publicação em npm/registry e documentação.✅✅
composition-patterns (vercel-composition-patterns)Padrões de composição em React que escalam: compound components, render props, context providers — incluindo mudanças de API do React 19. Ideal para acabar com a proliferação de props booleanas.✅✅
react-best-practices (vercel-react-best-practices)Guidelines de performance de React/Next.js da engenharia da Vercel: padrões para componentes, data fetching e otimização de bundle.✅✅
web-design-guidelinesRevisa código de UI quanto às Web Interface Guidelines: acessibilidade, UX e boas práticas de design ("review my UI", "check accessibility").✅✅
next-best-practicesBoas práticas específicas de Next.js: file conventions, fronteiras RSC, padrões de dados, async APIs, metadata, error handling, route handlers, otimização de imagem/fonte e bundling.—✅
next-cache-componentsNext.js 16+ Cache Components (PPR): diretiva use cache, perfis cacheLife, invalidação com cacheTag/updateTag/revalidateTag, migração de unstable_cache e limitações de runtime.—✅
next-upgradeUpgrade incremental do Next.js: detecta a versão atual, busca o guia oficial, roda codemods automáticos (@next/codemod) e orienta mudanças manuais de breaking changes para cada major.—✅
component-refactoringRefatora componentes React de alta complexidade no Dify frontend: extração de hooks, sub-componentes, context providers e lógica de formulários — acionado quando complexity > 50 ou lineCount > 300.✅✅
shadcnGerencia shadcn/ui em projetos existentes: adicionar, buscar, corrigir, estilizar e compor componentes; aplica/troca presets; orienta CLI, registries e regras críticas de composição.✅✅

Fonte original: Vercel — Agent Resources / Skills · shadcn/ui (shadcn)


🐦 Flutter — Mobile / Desktop

Skills para desenvolvimento cross-platform com Flutter e Dart. Recomendadas para instalação local, em projetos Flutter.

SkillO que faz
flutter-expertEngenheiro Flutter sênior para apps Flutter 3.19+ e Dart 3.3+: gerenciamento de estado com Riverpod 2.0 ou Bloc, navegação com GoRouter, widgets com const optimization, testes e profiling de performance.
flutter-initCria um novo projeto Flutter com Clean Architecture, Riverpod 3.0, Drift e stack moderna: escolha de domínio (Todo/Habit/Note/Expense/Custom), preset (Minimal/Essential/Full Stack), geração de código e validação com flutter analyze.
flutter-building-layoutsConstrói layouts Flutter usando o sistema de constraints: Row/Column, Expanded/Flexible, Stack/Positioned, SizedBox, design responsivo com LayoutBuilder e resolução de erros de unbounded constraints.
flutter-caching-dataImplementa estratégias de cache em apps Flutter: offline-first com repositório (stream local → fetch remoto), SQLite via sqflite, SharedPreferences, cache de imagens (cached_network_image), scroll cache e pre-warming do FlutterEngine no Android.
flutter-dart-code-reviewChecklist de code review Flutter/Dart agnóstico de biblioteca: linguagem Dart, decomposição de widgets, gerenciamento de estado (BLoC, Riverpod, Provider, GetX, MobX, Signals), performance, testes, acessibilidade, segurança e i18n.

Fonte original: github.com/Jeffallan (flutter-expert) · comunidade (demais)


🟩 Node.js — Backend

Skills para design e documentação de APIs e otimização de banco de dados. Recomendadas para instalação local, em projetos Node.js/backend.

SkillO que faz
api-designerArquiteto de API sênior para REST e GraphQL: modelagem de recursos, padrões de URI, versionamento, paginação, error responses (RFC 7807), geração de especificação OpenAPI 3.1 completa, autenticação e deprecation policies.
openapi-spec-generatorGeração automatizada de especificações OpenAPI: boas práticas de API Development (REST, GraphQL, autenticação), código e configurações prontos para produção, validados contra padrões OpenAPI.
sql-optimization-patternsOtimização de queries SQL e estratégias de indexação: análise de plano de execução (EXPLAIN), índices B-Tree/GIN/GiST/BRIN, eliminação de N+1, paginação por cursor, CTEs, materialized views, particionamento e monitoramento de slow queries.

Fonte original: github.com/Jeffallan (api-designer) · Jeremy Longshore (openapi-spec-generator) · comunidade (sql-optimization-patterns)


🔁 n8n — Automação de Workflows

Skills para construção, configuração e depuração de workflows no n8n. Recomendadas para instalação local, em projetos que utilizam n8n como plataforma de automação.

SkillO que faz
n8n-workflow-patterns6 padrões arquiteturais prontos para uso: webhook processing, HTTP API integration, database operations, AI agent workflow, scheduled tasks e batch processing (SplitInBatches, loops aninhados, paginação). Inclui checklist completo de criação de workflow.
n8n-expression-syntaxSintaxe de expressões {{ }}: variáveis $json, $node, $now, $env; acesso a dados de webhook (armadilha do .body); erros comuns e quando NÃO usar expressões (Code nodes, credenciais, paths).
n8n-node-configurationConfiguração orientada a operação: dependências de propriedades (displayOptions), níveis de detalhe do get_node (standard/full/search), padrões por tipo de nó (resource-operation, HTTP, database, conditional) e edições cirúrgicas com patchNodeField.
n8n-validation-expertInterpretação e correção de erros de validação: perfis (minimal/runtime/ai-friendly/strict), auto-sanitização de operadores, falsos positivos, n8n_autofix_workflow e estratégias de recuperação.
n8n-code-javascriptCódigo JavaScript em Code nodes: sintaxe $input/$json/$node, $helpers.httpRequest, DateTime/Luxon, $jmespath, SplitInBatches com acumulação cross-iteration via $getWorkflowStaticData, pairedItem e os 5 erros mais comuns.
n8n-code-pythonCódigo Python (Beta) em Code nodes: sintaxe _input/_json/_node, apenas biblioteca padrão (sem requests/pandas), diferenças entre Python Beta e Native, e guia de quando preferir JavaScript.
n8n-code-toolCode Tool para AI Agents (@n8n/n8n-nodes-langchain.toolCode): retorna string (não array de itens), lê input via query, schemas estruturados com specifyInputSchema, erros comuns ($fromAI indisponível, "Wrong output type") e quando usar toolWorkflow no lugar.

Fonte original: comunidade n8n


🧑‍💻 Pessoais

Skills autorais, otimizadas para o meu fluxo. Sempre se comunicam em português (pt-BR).

SkillO que faz
tonelli-git-commit-generatorGera mensagens de commit de alta qualidade analisando o diff real do staged e seguindo Conventional Commits + versionamento semântico: infere tipo (incl. perf/chore/revert), escopo e descrição, detecta breaking changes e propõe um commit seguro no PowerShell. Disparada por /commit.
tonelli-git-merge-request-generatorGera descrição de Merge/Pull Request (MERGE.md) analisando o diff real entre duas branches: detecta GitLab vs GitHub, aceita /merge <target> usando a branch atual como origem, extrai card/chamado Jira do nome da branch, alerta quando a branch está desatualizada e detecta breaking changes.

Fonte original: autorais (Raphael Tonelli).


🗂 Estrutura do repositório

tonelli-claude-skills/
├── CLAUDE.md                              # → diretrizes globais (~/.claude/CLAUDE.md)
├── .gitignore                             # → ignora artefatos de IA (mantém CLAUDE.md)
│
├── Global/skills/                         # → instalar globalmente (~/.claude/skills)
│   ├── writing-plans/
│   ├── executing-plans/
│   ├── systematic-debugging/
│   ├── verification-before-completion/
│   ├── requesting-code-review/
│   ├── receiving-code-review/
│   ├── finishing-a-development-branch/
│   └── careful/
│
├── Advpl/skills/                   # → instalar local em projetos Protheus
│   ├── advpl-to-tlpp-migration/
│   ├── mvc-generator/
│   ├── tlpp-rest-endpoint-generator/
│   ├── fwrest-client-generator/
│   ├── entry-point-designer/
│   ├── query-builder/
│   ├── data-dictionary-lookup/
│   ├── sql-optimization/
│   ├── code-review/
│   ├── refactor/
│   ├── context-map/
│   └── utf8-to-cp1252-conversion/
│
├── React/skills/                   # → instalar local em projetos React
│   ├── building-components/
│   ├── composition-patterns/
│   ├── react-best-practices/
│   ├── web-design-guidelines/
│   ├── component-refactoring/
│   └── shadcn/
│
├── Next/skills/                    # → instalar local em projetos Next.js
│   ├── building-components/
│   ├── composition-patterns/
│   ├── react-best-practices/
│   ├── web-design-guidelines/
│   ├── next-best-practices/
│   ├── next-cache-components/
│   └── next-upgrade/
│
├── Flutter/skills/                 # → instalar local em projetos Flutter
│   ├── flutter-expert/
│   ├── flutter-init/
│   ├── flutter-building-layouts/
│   ├── flutter-caching-data/
│   └── flutter-dart-code-review/
│
├── Node/skills/                    # → instalar local em projetos Node.js/backend
│   ├── api-designer/
│   ├── openapi-spec-generator/
│   └── sql-optimization-patterns/
│
├── n8n/skills/                     # → instalar local em projetos n8n
│   ├── n8n-workflow-patterns/
│   ├── n8n-expression-syntax/
│   ├── n8n-node-configuration/
│   ├── n8n-validation-expert/
│   ├── n8n-code-javascript/
│   ├── n8n-code-python/
│   └── n8n-code-tool/
│
└── Pessoais/skills/                # → instalar global ou local
    ├── tonelli-git-commit-generator/
    └── tonelli-git-merge-request-generator/

🙏 Créditos e fontes

Este repositório é uma curadoria. O mérito das skills de terceiros é de seus autores originais — todo o crédito a eles. As principais fontes de busca e referência foram:

As skills da pasta Pessoais/ são de autoria própria.


🤝 Contribuindo

Sugestões, correções e novas skills são muito bem-vindas! Se você:

  • conhece uma skill que faz sentido nessas stacks,
  • tem uma melhoria para alguma skill existente, ou
  • quer adaptar uma skill para outro contexto,

abra uma issue ou mande um pull request. Quanto mais gente compartilhando seus fluxos, melhor para toda a comunidade.

Ao adicionar uma skill de terceiros, mantenha sempre o crédito e o link para o repositório original.


📄 Licença

As skills de terceiros mantêm a licença de seus repositórios de origem (em geral MIT — verifique o SKILL.md de cada uma). As skills da pasta Pessoais/ são disponibilizadas sob licença MIT.


Curtiu? Deixe uma ⭐ no repositório e compartilhe com quem usa Claude Code!

Feito com ☕ por Raphael Tonelli

Ver o original no GitHub

Bom para

Relacionados