Como sincronizar skills no Claude Code, Codex, Cursor e OpenCode

Onde cada ferramenta procura

Da documentação de cada ferramenta, consultada em 4 de novembro de 2026. Cada pasta tem uma subpasta por skill, com um SKILL.md dentro.

Duas pastas cobrem as quatro: ~/.claude/skills (Claude Code, Cursor, OpenCode) e ~/.agents/skills (Codex, Cursor, OpenCode).

Uma cópia na sua máquina: links simbólicos

Mantenha os arquivos de verdade em uma pasta e aponte os dois locais para ela. No macOS ou no Linux:

mkdir -p ~/skills
# primeiro mova para cá as skills que já existem, depois:
ln -s ~/skills ~/.claude/skills
ln -s ~/skills ~/.agents/skills

Se alguma das pastas já existir, mova o conteúdo dela para ~/skills e remova a pasta vazia antes de criar o link. O Cursor e o OpenCode leem os dois locais, então chegam aos mesmos arquivos por dois caminhos. Se algum deles mostrar uma skill duas vezes, continua sendo um arquivo só: edite uma vez em ~/skills.

Em um repositório, faça o mesmo com .claude/skills e .agents/skills, faça commit da pasta de verdade, e todo mundo que clonar recebe as skills.

Uma cópia para a equipe: um servidor MCP

Links simbólicos e repositórios funcionam para desenvolvedores. Eles não chegam ao colega que trabalha no Claude ou no ChatGPT pelo navegador, e precisam de um git pull para atualizar. Os quatro agentes de programação também se conectam a servidores MCP remotos:

• Claude Code: claude mcp add --transport http <name> <url>
• Codex: uma entrada de servidor com url = "…" na configuração (Streamable HTTP).
• Cursor: um servidor Streamable HTTP nas configurações de MCP.
• OpenCode: um servidor com "type": "remote" na configuração.

Um servidor que guarda as skills da equipe dá aos agentes de programação, ao Claude e ao ChatGPT a mesma cópia atual, sem nada para puxar nem para religar.

Confira se uma ferramenta vê a sua skill

1. Confira a estrutura: <pasta>/<nome-da-skill>/SKILL.md, com a pasta com o mesmo nome do campo name.
2. Confira o frontmatter: um name com letras minúsculas, números e hifens, até 64 caracteres, e uma description que não esteja vazia. O conversor de SKILL.md escreve os dois.
3. Comece uma nova sessão e pergunte ao agente quais skills ele tem, ou peça a tarefa que a descrição cita.

Perguntas

Como sincronizo as skills do Claude Code com o Claude Desktop e o claude.ai?

O Claude Code lê pastas no disco; o Claude Desktop e o claude.ai guardam na sua conta as skills de que você faz upload. Faça upload da mesma pasta como ZIP em Personalizar > Skills ou conecte os dois a um servidor MCP que sirva as skills.

Por que o Claude Code não vê a minha pasta .agents/skills?

O Claude Code lê ~/.claude/skills e .claude/skills, não .agents/skills. Crie um link da pasta para ~/.claude/skills, como nos passos com links simbólicos acima.