Porter de Habilidades para Google Antigravity

Quando Usar

Use ao adaptar um pacote de habilidades Claude Code, Cursor, Codex ou genérico obtido localmente para o Google Antigravity. A utilidade preserva arquivos de suporte e faz substituições limitadas de nomes de ferramentas em pré-visualização; ela não comprova a compatibilidade com o cliente.

Pré-requisitos

• Python 3.9+; apenas biblioteca padrão.
• Um diretório de habilidades local revisado contendo SKILL.md, esse arquivo em si, ou um repositório com diretórios skills/<lowercase-hyphenated-id>/SKILL.md.
• Verifique primeiro a identidade upstream, revisão fixada, licença e o pacote completo. Obtenha o material remoto separadamente através do seu fluxo de trabalho de download/clone revisado.
• Use diretórios locais estáveis que você controla. Não execute contra uma árvore que está sendo modificada por outro processo ou usuário. Inspecione os scripts sem executá-los.

Fluxo de Trabalho

1. A partir deste diretório de habilidades, pré-visualize o pacote local:

   python3 scripts/port_skill.py --source "/absolute/path/my-skill" --dry-run
   

2. Revise a diferença. Apenas identificadores de ferramentas exatos entre aspas invertidas como View, Edit e Bash são alterados. O frontmatter e os bytes de suporte permanecem intactos. Verifique cada ferramenta de destino e a semântica de seus argumentos em seu cliente real.

3. Copie para um novo destino de staging, então inspecione antes de ativar:

   python3 scripts/port_skill.py --source "/absolute/path/my-skill" --dest "/absolute/path/staging"
   

   Destinos de habilidades existentes são rejeitados; nenhum caminho global é escrito.

4. Quando o usuário solicitar a instalação do espaço de trabalho, verifique o projeto atual:

   python3 scripts/port_skill.py --source "/absolute/path/my-skill" --workspace --dry-run
   python3 scripts/port_skill.py --source "/absolute/path/my-skill" --workspace
   

   Isso escreve apenas .agents/skills/<id> sob o diretório de trabalho atual. Confirme que o caminho de descoberta é suportado pelo host pretendido primeiro.

5. Revise referências de arquivos de contexto, formas de argumentos de ferramentas, configuração do cliente, dependências, licenciamento e ordenação de múltiplos agentes manualmente. Valide a habilidade adaptada e teste a invocação real do cliente antes de declarar compatibilidade.

Exemplos

Para um repositório de múltiplas habilidades, use sua raiz local como origem:

python3 scripts/port_skill.py --source "/absolute/path/reviewed-repository" --dry-run
python3 scripts/port_skill.py --source "/absolute/path/reviewed-repository" --dest "/absolute/path/fresh-output"

Uma invocação apenas de origem tem como padrão a pré-visualização. URLs remotos são rejeitados; obtenha e inspecione um checkout local fixado primeiro. Execute os testes empacotados a partir deste diretório:

PYTHONDONTWRITEBYTECODE=1 python3 -m unittest scripts/test_port_skill.py -v

Limitações

• Apenas adaptação de texto conservadora: sem conversão de AST, otimização semântica, paralelização automática, geração de artefatos ou certificação de compatibilidade.
• Referências de contexto e scripts de suporte retêm seus bytes originais e podem precisar de adaptação manual. Arquivos de suporte binários são copiados intactos, nunca interpretados.
• Links simbólicos e arquivos não regulares são rejeitados. A entrada é limitada a 1.000 arquivos e 20 MiB. Isso não é uma sandbox contra alterações hostis concorrentes no sistema de arquivos; use apenas diretórios estáveis que você controla.
• Falha no disco ou no sistema de arquivos pode deixar um novo destino parcial. Inspecione-o e escolha uma saída nova para novas tentativas. Não há modo de sobrescrita ou reversão.
• Sem downloads, credenciais, chamadas de rede, instalação global, geração/registro de manifestos de plugins ou configuração externa de MCP. Verifique a disponibilidade da ferramenta no host real, cuja versão e capacidades podem diferir.

Origem e licença

Adaptado de Pranav-Nexus/antigravity-skill-porter. O aviso MIT upstream é preservado em LICENSE.