skill-forge-convert

Conversão de Skills — Multi-Plataforma

Converta skills do Claude Code para funcionar no OpenAI Codex, Google Gemini CLI, Google Antigravity e Cursor, mantendo a qualidade e seguindo as melhores práticas de cada plataforma.

Processo

Passo 1: Ler a Skill de Origem

1. Leia o SKILL.md de origem e analise o frontmatter
2. Detecte o nível de complexidade da skill (1-4)
3. Inventarie todos os arquivos: scripts/, references/, agents/, sub-skills
4. Identifique a configuração MCP (.mcp.json), se presente

Passo 2: Analisar Compatibilidade entre Plataformas

Execute primeiro uma análise simulada:

python scripts/convert_skill.py <caminho> --dry-run --target all

Revise o relatório de compatibilidade:

• Campos portáteis: Transferidos diretamente (nome, descrição, licença)
• Campos adaptáveis: Precisam de tratamento específico por plataforma
• Campos exclusivos do Claude: Serão removidos com avisos

Passo 3: Converter para as Plataformas Alvo

Execute a conversão:

python scripts/convert_skill.py <caminho> --target codex,gemini,antigravity,cursor --output dist/

Para conversão da configuração MCP:

python scripts/convert_skill.py <caminho> --target all --output dist/ --include-mcp

Passo 4: Tratar Funcionalidades Exclusivas do Claude

Funcionalidades que precisam de adaptação manual por plataforma:

Funcionalidade do Claude	Codex	Gemini/Antigravity	Cursor
allowed-tools	Suportado	Remover; todas as ferramentas disponíveis	Remover; sem equivalente
context: fork	Sem equivalente	Sem equivalente	Sem equivalente
hooks	1 evento (notify)	Parcial (CLI)	6 eventos (beta)
Seleção de model	Sem equivalente	Sem equivalente	Sem equivalente
Delegação Task	Dividir em skills separadas	Dividir em skills separadas	Agentes em segundo plano (plano Ultra)
Comandos /slash	Sintaxe $mention	Ativação por descrição	Ativação por descrição + @rule
Roteamento de sub-skills	Skills separadas com $mention	Skills separadas, roteadas por LLM	Skills separadas, roteadas por LLM

Passo 5: Validar Skills Convertidas

Execute a validação em cada saída gerada:

python scripts/validate_skill.py dist/codex/<nome-da-skill>/
python scripts/validate_skill.py dist/gemini/<nome-da-skill>/
python scripts/validate_skill.py dist/antigravity/<nome-da-skill>/
python scripts/validate_skill.py dist/cursor/<nome-da-skill>/

Corrija quaisquer problemas críticos ou de alta prioridade antes de prosseguir.

Passo 6: Gerar Relatório de Implantação

Apresente ao usuário um resumo:

## Relatório de Conversão: {nome-da-skill}

| Plataforma | Pontuação | Arquivos | Avisos | Etapas Manuais |
|------------|-----------|----------|--------|----------------|
| Codex | 92% | 4 | 2 | 1 |
| Gemini | 88% | 3 | 3 | 1 |
| Antigravity | 88% | 3 | 3 | 1 |
| Cursor | 88% | 3 | 3 | 1 |

### Arquivos Gerados
[lista por plataforma]

### Avisos
[lista por plataforma]

### Etapas Manuais Necessárias
[lista por plataforma]

Passo 7: Gerar Script de Instalação Multi-Plataforma

Ao converter para todas as plataformas (--target all), o script gera automaticamente o install-multiplatform.sh que:

• Detecta automaticamente a plataforma do agente atual
• Instala no caminho de skill correto
• Suporta a flag --platform para seleção explícita

Referência Rápida de Plataformas

Plataforma	Caminho da Skill	Arquivo de Instruções	Formato de Configuração
Claude Code	.claude/skills/	CLAUDE.md	JSON (.mcp.json)
OpenAI Codex	.agents/skills/	AGENTS.md	TOML (config.toml)
Gemini CLI	.gemini/skills/	GEMINI.md	JSON (settings.json)
Antigravity	.agent/skills/	GEMINI.md	JSON (mcp_config.json)
Cursor	.cursor/skills/	.cursor/rules/*.mdc	JSON (mcp.json)

Para especificações completas das plataformas, carregue references/platforms.md.

Diretrizes de Conversão por Nível

• Nível 1 (SKILL.md único): Converte de forma limpa. Recomenda-se conversão automática.
• Nível 2 (skill + scripts): Converte bem. Verifique os caminhos dos scripts.
• Nível 3 (multi-skill): Parcial. Cada sub-skill converte de forma independente. O roteamento precisa de trabalho manual.
• Nível 4 (ecossistema): Revisão manual necessária. A delegação de subagentes precisa de adaptação à plataforma.