Apresentação e instalação do **Polyskill**, ferramenta que converte…
INEMA
A diferença principal é que Claude Code e Codex podem usar “skills”, mas cada um interpreta, carrega e configura essas skills de um jeito diferente.
Claude Code é mais direto com arquivos SKILL.md. Ele usa o corpo em Markdown, aceita campos próprios no frontmatter, permite definir ferramentas autorizadas como allowed-tools, e pode executar comandos dinâmicos dentro da própria skill, por exemplo algo como !git status --short. Também permite controlar se a skill pode ser chamada automaticamente pelo modelo ou apenas manualmente, usando campos como disable-model-invocation.
Codex também usa skills, mas costuma depender de uma estrutura mais organizada para o runtime da OpenAI. Além do SKILL.md, ele pode usar um arquivo extra chamado agents/openai.yaml, também conhecido como sidecar, para configurar metadados de interface, política de invocação e dependências de ferramentas.
Resumindo: Claude Code é mais flexível e “Markdown-first”, enquanto Codex é mais estruturado e usa configuração adicional para integrar melhor com o ecossistema OpenAI. Por isso uma mesma skill pode funcionar em um e falhar no outro, mesmo tendo a mesma ideia central. É justamente esse problema que o Polyskill tenta resolver: converter uma skill entre os dois formatos sem reescrever tudo manualmente.
Os comandos principais são estes:
No Claude Code:
/polyskill convert my <nome-da-skill> to codex
Exemplo:
/polyskill convert my front-end-design to codex
No Codex:
$polyskill convert my <nome-da-skill> to claude
Exemplo:
$polyskill convert my agent-inbox to claude
Também aparece no vídeo a ideia de instalar/construir antes com:
polyskill install
Fluxo resumido:
polyskill install
/polyskill convert my <skill-name> to codex
$polyskill convert my <skill-name> to claude
No Claude Code o prefixo é /polyskill; no Codex é $polyskill.
A ideia central é: você escreve uma skill uma vez, em uma estrutura portátil, e o Polyskill converte/adapta essa skill para funcionar nos dois ambientes. Isso resolve diferenças técnicas entre os runtimes, como a forma como Claude Code executa comandos no meio da skill, o limite do Codex para ler descrições longas e o uso de arquivos extras de configuração no Codex, como o “sidecar” em YAML.
O Polyskill funciona como um adaptador universal: identifica a estrutura da skill original, separa uma base comum, aplica adaptadores específicos para cada provedor e gera a versão correta para Claude Code ou Codex. O autor também sugere que a mesma lógica pode ser expandida futuramente para Gemini CLI, Cursor e outros ambientes.
Em resumo: é uma ferramenta para manter skills sincronizadas entre diferentes agentes, economizando tempo, reduzindo retrabalho e permitindo alternar entre Claude Code, Codex e futuros provedores com mais facilidade.
polyskill — compila uma skill portátil pra múltiplos runtimes (Claude Code + OpenAI Codex hoje, Gemini/Cursor/Copilot planejados).
Escreve uma vez em formato neutro, gera SKILL.md
otimizado pra cada ferramenta. Suporta round-trip (importa skill existente → portátil → reexporta).
Instalar — 2 caminhos:
A) Drag-and-drop (só a skill, sem CLI): cp -r skill/dist/claude/polyskill ~/.claude/skills/polyskill cp -r skill/dist/codex/polyskill ~/.agents/skills/polyskill Claude Code recarrega sozinho. No Codex: Plugins → refresh.
B) Fonte + CLI (recomendado): cd /home/nmaldaner/projetos/polyskill npm install npm run build npm link polyskill --version cd skill && polyskill install
Depois invoca com /polyskill
Quer que eu rode o Path B aqui agora?
✻ Crunched for 14s
❯ qual diferenca ou vantagem entre a e b
● A — Drag-and-drop - Só copia a skill (o SKILL.md + arquivos) pros diretórios dos runtimes. - Não instala o binário polyskill no PATH. - Skill responde a /polyskill ..., mas se ela precisar executar comandos tipo polyskill build / polyskill install por baixo, falha — o CLI não existe. - Serve pra: usar a polyskill como skill consultiva, sem autorar/compilar skills novas.
B — Source + CLI - Clona, builda e linka o binário polyskill no PATH. - Você ganha os comandos: init, import, build, install, validate, reconcile, detect, etc. - A skill /polyskill fica 100% funcional (consegue rodar o CLI por baixo). - Serve pra: criar skills portáveis, importar skills existentes, compilar pra múltiplos runtimes, contribuir adapters.
Resumo: A é demo/preview. B é o uso real. Se você quer de fato escrever uma skill uma vez e gerar pra Claude+Codex, precisa do B.
✻ Cooked for 20s
❯ instala o B
● Bash(npm install) ⎿ added 21 packages, and audited 22 packages in 687ms
1 package is looking for funding
… +3 lines (ctrl+o to expand)
Called plugin:context-mode:context-mode (ctrl+o to expand)
● CLI instalado. Agora instala a meta-skill nos dois runtimes.
Called plugin:context-mode:context-mode (ctrl+o to expand)
● Pronto. CLI polyskill no PATH + skill instalada nos dois runtimes (Claude Code e Codex). Testa com /polyskill
Como otimizar todas as Skills tanto para Claude Code quanto para Codex 🧩
Para quem está cansado de reescrever as mesmas skills toda vez que alterna entre Claude Code e Codex.
Uma skill chamada /polyskill, que converte qualquer skill entre os dois ambientes de execução a partir de uma única fonte portátil. Você escreve a skill uma vez, o polyskill gera a versão otimizada para cada runtime, e ambos a reconhecem nativamente. Mesma fonte, dois runtimes, sem reescritas manuais.
Pegue o código-fonte aqui ↩️ siga para receber atualizações
Também anexei o kit como um arquivo ZIP neste post, caso você não queira lidar com o GitHub.
Como instalar⌗
- Coloque
install/claude_code/polyskillem~/.claude/skills/ - Coloque
install/codex/polyskillem~/.agents/skills/ - No Claude Code, digite
/polyskill convert my <nome da skill> to codex. No Codex, o prefixo é$polyskillem vez de/polyskill.
Se tiver problemas para instalar, basta jogar o repositório no Claude Code ou no Codex e pedir para ele configurar o polyskill para você. O README interno foi escrito para ser legível por agentes, então o modelo vai conseguir entender o que fazer a partir dele.
Pretendo manter isso atualizado conforme novos provedores forem lançados, como Gemini CLI, Cursor etc. Então ative as notificações se quiser saber quando um novo adaptador estiver disponível.
PollySkill - Converte Claude Code e Codex
1