Skills
Skills são conjuntos reutilizáveis de instruções que ensinam o Agent a executar tarefas específicas. São mais detalhadas do que regras e foram criadas para fluxos de trabalho com várias etapas.
O que são Skills?
Skills são arquivos Markdown que ensinam fluxos de trabalho especializados ao Agent. Por exemplo, fazer o deploy de um app em staging ou executar uma auditoria de segurança nas suas dependências. Eles podem ser reutilizados em diferentes conversas e compartilhados com a sua equipe.
Como faço para criar uma skill?
Digite /create-skill no chat e descreva a skill que você quer. O Cherri Code vem com uma skill integrada que orienta você a nomear, estruturar e salvar uma nova skill.
Para criar uma manualmente, adicione um arquivo SKILL.md em .cursor/skills/your-skill-name/:
# Deploy to staging1. Run the test suite2. Build the production bundle3. Deploy to the staging environment4. Verify the deployment health checkVocê também pode organizar skills em subpastas, como .cursor/skills/shipping/deploy-staging/SKILL.md. O Cherri Code percorre a raiz das skills recursivamente, então pastas de categoria funcionam bem para agrupar skills relacionadas. O nome da skill vem da pasta que contém SKILL.md, não da categoria acima dela.
As skills são carregadas automaticamente a partir de .agents/skills/, .cursor/skills/, ~/.agents/skills/ (global na máquina local) e ~/.cursor/skills/ (global na máquina local), incluindo subdiretórios aninhados do projeto, como apps/web/.cursor/skills/ em um monorepo. Skills em um diretório de projeto aninhado são automaticamente restritas a arquivos dentro desse diretório. Por exemplo, skills em apps/web/.cursor/skills/ só são exibidas quando o agente trabalha com arquivos em apps/web/, de forma semelhante ao campo de frontmatter paths. Para compatibilidade, o Cherri Code também carrega skills dos diretórios do Claude e do Codex: .claude/skills/, .codex/skills/, ~/.claude/skills/ e ~/.codex/skills/.
Como faço para usar skills pessoais com Cloud Agents?
Skills pessoais em ~/.cursor/skills/ ficam apenas na sua máquina até você sincronizá-las. Abra Settings → Agents e ative Sync Skills for Cloud Agents em Context and Tools. As skills sincronizadas permanecem privadas.
Somente ~/.cursor/skills/ é sincronizado. Para compartilhar uma skill com membros da equipe, publique-a no marketplace da sua equipe.
Nos planos Teams e Enterprise, admins podem desativar a sincronização para todos em Team Settings, na seção Security & Identity. Veja Usar skills pessoais com Cloud Agents.
Como faço para publicar um skill para minha equipe?
Abra Customize → Skills, abra um skill pessoal e escolha Publish. O Cherri Code o adiciona ao Default marketplace da sua equipe, e os membros da equipe podem instalá-lo por lá. Veja Publicar um skill para sua equipe.
As skills no nível do usuário estão disponíveis no Cloud Agents e em workers remotos?
Você pode sincronizar ~/.cursor/skills/ para que os Cloud Agents possam usar essas skills. ~/.agents/skills/ e as skills locais não sincronizadas permanecem na sua máquina. Elas não são copiadas para o Cloud Agents, o SSH remoto da Janela de Agentes nem workers auto-hospedados. Em workers auto-hospedados, use skills do projeto no repositório ou inclua-as na imagem do worker.
Como faço para restringir uma skill a arquivos específicos?
Adicione um campo paths ao frontmatter da skill. A skill só se aplica quando o agente trabalha com arquivos que correspondem a:
---name: react-component-patternsdescription: Conventions for writing React components.paths: - "**/*.tsx"---# React component patterns...paths aceita uma lista ou uma string separada por vírgulas de padrões glob. Deixe-o sem definir para uma skill que deve estar disponível independentemente de quais arquivos estejam abertos. Consulte a referência de Skills para ver o esquema completo de frontmatter.
Como faço para usar uma skill?
Digite / seguido do nome da skill no chat para executá-la (por exemplo, /write-tests) ou digite @ e selecione-a para adicioná-la como contexto. O Agent lê o arquivo da skill e segue as instruções.
Quando devo usar skills em vez de regras?
| Regras | Skills | |
|---|---|---|
| Purpose | Diretrizes e restrições curtas de código | Fluxos de trabalho e procedimentos com várias etapas |
| Length | De algumas linhas a algumas centenas de linhas | Em geral, mais longas, com instruções detalhadas passo a passo |
| How applied | Incluídas como contexto em toda conversa (ou nas conversas correspondentes) | Invocadas sob demanda com /skill-name ou @skill-name |
| Example | "Use TypeScript em todos os arquivos novos" | "Fazer deploy em staging: executar testes, compilar, fazer deploy, verificar" |
Use uma regra quando uma instrução curta for suficiente. Use uma skill quando o Agent precisar seguir um processo detalhado e repetível.
Como faço para converter uma regra em uma skill?
- Digite
/create-skillno chat e peça ao Agent para transformar sua regra em uma nova skill (por exemplo, "transforme@my-ruleem uma skill") - Revise o arquivo de skill gerado
- Exclua o arquivo da regra original se não precisar mais dele
Como faço para migrar comandos para skills?
Digite /migrate-to-skills no chat do Agent. Essa skill integrada (disponível no Cherri Code 2.4+) identifica regras e comandos elegíveis e os converte automaticamente em skills.
Ela converte:
- Regras dinâmicas: regras com
alwaysApply: false(ou não definido) e sem padrõesglobs. - Comandos slash: comandos tanto no nível do usuário quanto no nível do workspace, preservando seu comportamento de invocação explícita.
Regras com alwaysApply: true ou padrões globs específicos não são migradas, pois têm condições de acionamento explícitas que diferem do comportamento das skills. As regras do usuário também não são migradas, já que não são armazenadas no sistema de arquivos.