As skills transformam a forma como os desenvolvedores trabalham com IA, convertendo fluxos repetitivos em recursos estruturados e reutilizáveis. Sendo um dos principais editores de código com IA, o Cursor costuma ser a ferramenta preferida para aplicar skills, mas configurá-las exige entender a estrutura de arquivos, a gestão de contexto e a elaboração de prompts. Este guia mostra como criar e configurar skills no Cursor, traz exemplos úteis e ensina a montar skills personalizadas com IA para transformar boas práticas em uma verdadeira "memória muscular."
Como criar e usar skills no Cursor?
Para colocar as skills do Cursor em prática, primeiro você precisa entender como configurá-las dentro da estrutura do seu projeto. Com a configuração pronta, fica fácil criar, organizar e usar skills para automatizar seus fluxos de desenvolvimento. Siga estes passos para criar e usar skills no Cursor.
Passo 1: crie uma pasta .cursor
Primeiro, acesse o diretório raiz do seu projeto e crie uma pasta chamada .cursor. Essa pasta armazena os arquivos de configuração específicos do Cursor e as definições no nível do projeto.
Passo 2: adicione um diretório skills
Em seguida, crie uma pasta skills dentro de .cursor. Esse diretório vai conter todas as suas skills personalizadas.
Passo 3: crie uma pasta para cada skill
Cada skill deve ter sua própria pasta dentro do diretório skills. Por exemplo:
api-creation-skilldocumentation-creatorcode-review-assistant
Separar as skills em pastas individuais ajuda a evitar conflitos e facilita as atualizações à medida que sua biblioteca de skills cresce
Passo 4: adicione um arquivo SKILL.md
Dentro de cada pasta de skill, crie um arquivo chamado SKILL.``md. Esse arquivo segue o formato padrão usado para definir como a skill funciona e quando o Cursor deve aplicá-la.
Passo 5: defina a estrutura central
Com o arquivo criado, adicione as seções essenciais que descrevem a skill.
Um arquivo SKILL.md típico deve incluir:
Título: o nome da skill.
Descrição: explica quando a skill deve ser usada.
Instruções: orientações passo a passo que o Cursor segue ao executar as tarefas.
Uma estrutura clara ajuda o Cursor a entender a finalidade da skill e a gerar resultados mais consistentes.
Passo 6: adicione melhorias opcionais (se necessário)
Depois de definir o básico, você pode reforçar a skill acrescentando seções adicionais, como:
Modelos
Exemplos
Observações
Regras de validação
Requisitos de saída
Passo 7: use a skill no Cursor
Com a skill configurada, abra o Cursor Chat com Ctrl + I. Digite / para ver as skills disponíveis, selecione a que deseja usar e descreva sua tarefa. O Cursor carrega automaticamente as instruções da skill escolhida e as aplica à tarefa.
Passo 8: deixe o Cursor executar o fluxo de trabalho
A IA seguirá as regras da sua skill, fará perguntas de esclarecimento quando preciso e gerará resultados estruturados, como APIs ou documentação, conforme o caso.
Skills personalizadas podem melhorar bastante a forma como os desenvolvedores trabalham com o Cursor. Ao transformar prompts usados com frequência em fluxos de trabalho reutilizáveis, as equipes economizam tempo, mantêm a consistência e simplificam tarefas complexas de desenvolvimento.
| Skill | Finalidade |
|---|---|
| canvas | Criar/editar .canvas.tsx e abrir o Canvas visual (gráficos, tabelas, painéis de análise etc.) ao lado do chat |
| sdk | Usar o Cursor SDK (@cursor/sdk/ cursor-sdk) para chamar o Agent em scripts, CI e automações |
| babysit | Manter o PR em condições de merge: tratar comentários, resolver conflitos e corrigir o CI |
| statusline | Configurar a barra de status personalizada da CLI (statusLine in ~/.cursor/cli-config.json) |
| split-to-prs | Dividir as alterações atuais em vários PRs pequenos e fáceis de revisar |
| update-cursor-settings | Modificar as configurações da IDE (settings.json: tema, fonte, formatação etc.) |
| update-cli-config | Modificar a configuração da CLI (~/.cursor/cli-config.json: permissões, modo de aprovação, vim etc.) |
| shell | Tratar o comando /shell, executando o texto seguinte como um comando de shell literal |
| migrate-to-skills | Migrar .cursor/rules/.mdc e .cursor/commands/.md para o formato Skills |
| create-subagent | Criar um subagent personalizado (sub-agente de IA dedicado) |
| create-rule | Criar Cursor Rules (.cursor/rules/, AGENTS.md etc.) |
| create-hook | Criar Cursor Hooks (hooks.json, executar lógica personalizada antes/depois de eventos do Agent) |
| create-skill | Criar uma nova Agent Skill (escrever a estrutura e as especificações do SKILL.md) |
Skills externas que funcionam no Cursor
| Skill | Descrição | Link do GitHub |
|---|---|---|
| best-of-n-solving | Testa várias abordagens para um problema difícil em paralelo usando git worktrees isolados e, em seguida, escolhe a melhor solução. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/best-of-n-solving/SKILL.md |
| parallel-exploring | Explora rapidamente uma base de código extensa lançando vários subagents somente leitura que investigam áreas diferentes ao mesmo tempo. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/parallel-exploring/SKILL.md |
| adding-e2e-tests | Configura o Playwright com arquivo de configuração, testes de exemplo, page objects e integração com CI. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-e2e-tests/SKILL.md |
| adding-auth | Adiciona login OAuth, gerenciamento de sessão e rotas protegidas com Auth.js (NextAuth). | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-auth/SKILL.md |
| adding-stripe | Integra checkout, assinaturas, webhooks e portal do cliente da Stripe. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-stripe/SKILL.md |
| adding-docker | Containeriza qualquer aplicação com um Dockerfile multi-estágio, docker-compose e .dockerignore. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-docker/SKILL.md |
| adding-analytics | Adiciona rastreamento de eventos do PostHog, visualizações de página, feature flags e replay de sessão a qualquer aplicação web. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-analytics/SKILL.md |
| adding-error-tracking | Adiciona relatórios de falhas, monitoramento de desempenho e source maps do Sentry. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-error-tracking/SKILL.md |
| auditing-security | Auditoria de segurança sistemática em busca das vulnerabilidades do OWASP Top 10, exposição de segredos e padrões inseguros. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/auditing-security/SKILL.md |
| profiling-performance | Faz o profiling de desempenho de CPU de uma aplicação em execução usando o profiler de navegador do Cursor para capturar pilhas de chamadas e identificar funções lentas. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/profiling-performance/SKILL.md |
| converting-css-to-tailwind | Converte folhas de estilo CSS comuns em classes utilitárias do Tailwind — seletores, media queries, pseudoclasses, animações e valores arbitrários. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/converting-css-to-tailwind/SKILL.md |
| generating-images | Gera ou edita imagens (ícones, logos, imagens de destaque de blog, imagens OG, ilustrações, mockups) usando o gpt-image-2 da OpenAI. Suporta texto-para-imagem, imagem-para-imagem, inpainting com máscara e tarefas em lote paralelas. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/generating-images/SKILL.md |
| api-smoke-testing | Descobre as rotas de API a partir da base de código, aciona cada endpoint e informa quais retornam erros. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/api-smoke-testing/SKILL.md |
| creating-pr | Cria pull requests limpos e prontos para revisão, com títulos convencionais, descrições estruturadas e issues vinculadas. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/creating-pr/SKILL.md |
| babysitting-pr | Monitora um PR aberto em busca de falhas de CI, comentários de revisão e conflitos de merge — e os corrige automaticamente para manter o PR pronto para merge. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/babysitting-pr/SKILL.md |
Dica bônus: crie skills pessoais com a Kimi sem complicação
O recurso de documento em skills da Kimi permite transformar documentos, códigos ou modelos existentes em skills de IA reutilizáveis. Em vez de apenas ler ou resumir arquivos, ele extrai fluxos de trabalho estruturados diretamente do seu conteúdo e os converte em ações automatizadas. Assim, fica fácil reaproveitar processos de arquivos do Office ou documentos internos, ajudando você a automatizar tarefas repetitivas sem precisar refazer fluxos do zero.
Como converter documentos em skills?
Se você já tem SOPs, modelos, relatórios ou arquivos estruturados, pode convertê-los diretamente em uma Skill dentro da Kimi. Veja como fazer.
Passo 1: acesse a ferramenta de documento em skills
Acesse kimi.com para começar. Clique no botão "+" (criar), vá até "Skills" e selecione a opção "Document to skills".
Passo 2: envie arquivos do Office
Envie seus arquivos existentes, como documentos do Word, PDFs, planilhas do Excel ou apresentações. Após o envio, explique claramente o que você quer que a Kimi extraia, reproduza ou converta em uma skill reutilizável. A Kimi então processa o arquivo, reconhece os padrões principais e extrai automaticamente a estrutura de fluxo de trabalho subjacente do seu documento.
Passo 3: crie e use suas skills
Clique em "Create skill" para iniciar a geração. A Kimi analisa o documento e o converte em uma skill estruturada e reutilizável, o que pode levar alguns minutos dependendo do tamanho e da complexidade do arquivo.
Quando estiver pronta, você pode abrir a skill e usá-la diretamente. Também dá para modificá-la, copiar o conteúdo ou baixá-la como um arquivo .md para reaproveitar ou compartilhar.
Principais recursos da ferramenta de documento em skills da Kimi
Agora que você entende como documentos podem ser convertidos em skills reutilizáveis, vale conhecer o que torna esse recurso tão poderoso.
Transforme documentos em um sistema reutilizável de skills e conhecimento
A Kimi converte documentos como SOPs, manuais e diretrizes em Skills estruturadas. Essas Skills capturam fluxos de trabalho, regras e conhecimento de domínio em um formato reutilizável. Em vez de arquivos estáticos, seus documentos viram instruções de IA prontas para a ação. Isso ajuda você a reaproveitar o mesmo conhecimento em várias tarefas.
Combine skills personalizadas e existentes para obter melhores resultados
A Kimi permite usar várias skills em conjunto, incluindo suas próprias skills personalizadas e as nativas. Ao combinar diferentes skills em um único fluxo de trabalho, você gera resultados mais alinhados às suas expectativas e às exigências da tarefa. Essa abordagem flexível facilita adaptar skills a diferentes cenários e melhorar a qualidade geral dos resultados.
Conclusão
As skills facilitam a gestão de tarefas de desenvolvimento ao empacotar instruções em fluxos de trabalho reutilizáveis dentro do editor. Isso ajuda a manter a consistência dos resultados e reduz a necessidade de prompts manuais repetidos durante a programação. Os desenvolvedores podem aplicar a mesma lógica estruturada em diferentes projetos, ganhando em eficiência e organização. Para uma configuração ainda mais rápida, ferramentas como a Kimi convertem documentos existentes em skills reutilizáveis, tornando a automação de fluxos de trabalho mais simples e escalável.