AI Toolkit – Distribuidor de Regras e Skills para IDEs
lifesystemsufpr/ai-toolkit
Escreva regras uma vez, distribua para 3 IDEs automaticamente
Ver no GitHubKit de automação que centraliza regras de código e skills em markdown neutro e distribui automaticamente para Cursor, Claude Code e GitHub Copilot via adapters específicos. Reduz duplicação de conhecimento e mantém consistência de padrões em múltiplos repositórios e ambientes de desenvolvimento.
Instalação
npx convez-ai lifesystemsufpr/ai-toolkit1 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
Casos de uso
- Sincronizar padrões de código entre Cursor, Claude Code e Copilot
- Gerenciar skills/procedimentos invocáveis para agentes de IA em um único lugar
- Distribuir regras consistentes em múltiplos repositórios via PR automático
- Adaptar formato de regra quando uma IDE evolui sem duplicar esforço
Veredito

Ferramenta sólida para orgs que trabalham com múltiplas IDEs de IA e querem evitar duplicação de knowledge base. Exige TypeScript/Node e orquestração via scripts, mas compensa em escala — uso recomendado para equipes que mantêm vários repos e precisam de padrões centralizados.
README
A tradução para o português deste README ainda está na fila.
ai-toolkit
Fonte neutra de regras e skills de IA para a org lifesystemsufpr, com adaptadores gerados automaticamente para Cursor, Claude Code e GitHub Copilot.
Ideia central
Você escreve a regra uma vez, em markdown neutro em source/. O sync.ts gera os arquivos no formato específico de cada IDE, para cada repositório. Quando uma regra muda, muda num lugar só e propaga para os 3 ambientes e os 7 repos.
source/ (fonte da verdade, markdown) ──sync.ts──▶ build/<repo>/ ──distribute.ts──▶ PR em cada repo
Estrutura
source/
rules/ Regras de código (markdown com frontmatter)
skills/ Skills/procedimentos invocáveis por agente
config/
projects.ts Mapeia cada repo aos perfis de regra e às IDEs
scripts/
sync.ts Gera build/<repo>/ nos formatos de cada IDE
distribute.ts Abre 1 PR por repo com os arquivos gerados
build/ Saída gerada (não versionar; está no .gitignore)
Formatos gerados por IDE
| IDE | Arquivos |
|---|---|
| Cursor | .cursor/rules/<id>.mdc (com globs e alwaysApply) |
| Claude Code | CLAUDE.md (regras always inline + escopadas em seções) e .claude/skills/<id>/SKILL.md |
| GitHub Copilot | .github/copilot-instructions.md, .github/instructions/<id>.instructions.md (com applyTo), .github/prompts/<id>.prompt.md |
Os formatos de regra/skill de cada IDE evoluem. Toda a lógica de formato está isolada nas funções
emitCursor/emitClaude/emitCopilotemscripts/sync.ts. Se um formato mudar, ajuste só ali e rode o sync de novo.
Anatomia de uma regra
---
id: backend-node
title: Backend Node.js
appliesTo: [backend] # all | ts | backend | frontend | mobile | kotlin
globs: ["src/**/*.ts"] # alvos de arquivo (Cursor globs / Copilot applyTo)
always: false # true = sempre aplicada, independente de arquivo
---
# conteúdo da regra em markdown...
Uma regra entra num repo se appliesTo inclui all ou intersecta os profiles daquele repo em config/projects.ts.
Uso
pnpm install
# Gerar os adaptadores para todos os repos
pnpm sync
# Gerar só para um repo
pnpm sync auth-service
# Distribuir (abre 1 PR por repo). Precisa de PAT com escopo repo.
DRY_RUN=1 pnpm distribute # simula
GITHUB_TOKEN=ghp_xxx pnpm distribute # para valer
Como adicionar uma regra ou skill
- Crie um arquivo em
source/rules/ousource/skills/com o frontmatter. - Rode
pnpm synce confira o resultado embuild/. - Rode
pnpm distributepara abrir os PRs.
Como adicionar uma IDE (ex.: Windsurf)
- Escreva uma função
emitWindsurf(...)emscripts/sync.tsno formato da IDE. - Adicione
"windsurf"ao tipo deidesemconfig/projects.tse chame a função no loop. - Rode o sync. A fonte neutra não muda.
Integração com os agentes de código
As skills em source/skills/ são consumidas tanto pelo Claude Agent SDK quanto pelo Cursor SDK (ambos suportam skills e MCP). O mesmo conteúdo que orienta o desenvolvedor na IDE orienta o agente headless no pipeline de CI — uma fonte, vários consumidores.