A resposta curta
- 1Coloque a Skill em
~/.cursor/skills/para usá-la em todos os projetos (é também a única pasta que pode sincronizar com os Cloud Agents), ou em.cursor/skills/para um projeto. - 2O
namenoSKILL.mdprecisa ser igual ao nome da pasta, usando só letras minúsculas, números e hífens. - 3Encontre-a em Customize → Skills. Rode com
/skill-nameou anexe a uma mensagem com@skill-name. - 4Quer Skills prontas? Explore Skills para Cursor que você instala com um comando.
Onde o Cursor procura Skills
O Cursor verifica as próprias pastas, a compartilhada ~/.agents/skills/ e também as pastas do Claude Code e do Codex. Se você já usa outro agente, suas Skills talvez já estejam no Cursor.
| Pasta | Para que serve |
|---|---|
~/.cursor/skills/ | Todos os projetos. A única pasta que sincroniza com os Cloud Agents. |
~/.agents/skills/ | Todos os projetos neste computador. A Skillry instala aqui, e o Codex também lê esta pasta. |
.cursor/skills/ ou .agents/skills/ | Um projeto, em qualquer lugar do repositório. Uma pasta aninhada vale para os arquivos abaixo dela. |
.claude/skills/, .codex/skills/ e as mesmas em ~ | Lidas para que Skills do Claude Code e do Codex também funcionem aqui. |
Como adicionar Skills ao Cursor
A Skillry CLI instala em ~/.agents/skills/, que o Cursor lê, então você não precisa de flag. Se copiar uma pasta manualmente, coloque-a em ~/.cursor/skills/; essa é a pasta que pode acompanhar você até os Cloud Agents.
- 1
Abra a Skill na Skillry, selecione Copiar prompt de instalação e depois Copiar na janela.
- 2
Cole no Cursor e envie. O agente lê as instruções de instalação da Skillry e roda o comando certo por conta própria.
Prompt de instalação Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
Quando o navegador pedir que você aprove um código de dispositivo, aprove.
Você deve ver: o Cursor informando a versão que instalou e a pasta que usou, em
~/.agents/skills/.
- 1
Faça login uma vez. Uma janela do navegador abre com um código de dispositivo para você aprovar.
Terminal npx --yes skillry-cli@latest login - 2
Instale. Não precisa de flag, porque a pasta padrão da CLI é a que o Cursor lê.
Terminal npx --yes skillry-cli@latest install <slug>Você deve ver:
Installed <slug> <version> to ~/.agents/skills/<slug>
Selecione Baixar ZIP na página da Skill ou use uma pasta de Skill que você conseguiu em outro lugar. Leia o SKILL.md e o que houver em scripts/ antes de instalar, já que o agente segue essas instruções e pode rodar esses scripts. Depois mova a pasta inteira:
mkdir -p ~/.cursor/skills
mv ~/Downloads/my-skill ~/.cursor/skills/ZIPs costumam descompactar com um nível a mais, como my-skill/my-skill/SKILL.md. O SKILL.md precisa ficar diretamente dentro da pasta da Skill, senão o agente não o encontra.
O Cursor procura Skills quando inicia. Depois de instalar, abra um novo chat ou recarregue a janela e confira Customize → Skills, no grupo Agent Decides.
A regra de nome que faz Skills sumirem
O Cursor só carrega uma Skill quando o name no SKILL.md é exatamente igual ao da pasta em que ela está. Quando são diferentes, não aparece erro nenhum. A Skill simplesmente não está lá.
Por que ela sumiu?
Você baixa a launch-page, renomeia a pasta para landing para organizar e ela desaparece do Cursor. A pasta e o name não batem mais. Volte o nome da pasta ou mude o name para landing.
Um nome que o Cursor aceita
- Só letras minúsculas, números e hífens
- Idêntico ao da pasta que contém o
SKILL.md - Acompanhado de uma
description
Como rodar uma Skill no Cursor
No chat, digite / e o nome da Skill e depois o seu pedido:
/launch-page Parcelo, a parcel-tracking dashboard for small online shopsPara manter uma Skill ativa durante a sessão inteira, escolha-a no menu / e pressione Option+Enter (Mac) ou Alt+Enter (Windows), ou escolha Use as Mode. Ela vira um Custom Mode e fica ativa até você sair.
Use Skills nos Cloud Agents
Os Cloud Agents não rodam no seu computador, então só recebem as Skills que o Cursor sincroniza para eles. Veja como configurar:
- 1Mantenha a Skill em
~/.cursor/skills/. Skills de projeto e~/.agents/skills/ficam na sua máquina. - 2Abra Settings → Agents → Context and Tools e ative Sync Skills for Cloud Agents.
- 3Para compartilhar uma Skill pessoal com o seu time, abra-a em Customize → Skills e escolha Publish.
Regras do Cursor vs Skills
As regras do Cursor são orientações curtas que o Cursor adiciona à conversa, sempre ou para arquivos correspondentes. Uma Skill é um procedimento que o agente só carrega quando a tarefa pede. Use regras para convenções e Skills para trabalhos com vários passos.
Um procedimento, sob demanda
- Uma pasta com
SKILL.md - Roda quando é relevante ou quando você digita
/name - Trabalho com vários passos, scripts, templates
Orientação no contexto
- Arquivos
.mdcem.cursor/rules/(arquivos.mdsimples são ignorados) - Always Apply, Apply Intelligently, Apply to Specific Files ou Apply Manually
- Convenções curtas. O Cursor também lê
AGENTS.mdeCLAUDE.md
Vai migrar regras antigas? O /migrate-to-skills nativo do Cursor converte regras “Apply Intelligently” e slash commands em Skills.
Skill do Cursor não aparece? Tente isto
Confira o nome primeiro. Uma diferença entre o name e a pasta é o motivo mais comum para uma Skill sumir no Cursor.
Não aparece em Customize → Skills
Confira se o name é igual ao da pasta e depois abra um novo chat ou recarregue a janela.
Falta nos Cloud Agents
Mova-a para ~/.cursor/skills/ e ative a sincronização.
Nunca é escolhida sozinha
A descrição talvez não combine com o jeito como você pede, ou o paths a limita a outros arquivos.
Perguntas frequentes
Qual é a diferença entre regras do Cursor e Skills?
Regras são orientações que o Cursor adiciona às conversas, sempre ou para arquivos correspondentes. Skills são pastas com um procedimento que o agente usa quando é relevante ou quando você a chama.
O Cursor pode usar Claude Skills?
Sim. O Cursor lê ~/.claude/skills/ e .claude/skills/, desde que o name de cada Skill seja igual ao da pasta.
Onde ficam as Skills do Cursor?
~/.cursor/skills/ ou ~/.agents/skills/ para todos os projetos, e .cursor/skills/ ou .agents/skills/ para um único projeto.
Skills funcionam nos Cursor Cloud Agents?
Só as Skills em ~/.cursor/skills/, e só depois que você ativa Sync Skills for Cloud Agents.
Fontes
Este guia ajudou?
