📜 .cursorrules - O Formato Legacy
O arquivo .cursorrules foi o primeiro formato de customizacao do Cursor. Colocado na raiz do projeto, era um arquivo de texto plano que definia instrucoes para o agente. Foi o pioneiro na ideia de "instrucoes por repositorio" para editores AI.
Apesar de simples e eficaz, o .cursorrules tinha limitacoes significativas: sem metadata estruturada, sem scoping por arquivo ou diretorio, e completamente proprietario ao Cursor. Isso motivou a criacao do formato .mdc e a adocao do SKILL.md.
Exemplo: .cursorrules classico
You are an expert in TypeScript, React, and Next.js.
Key Principles:
- Write concise, technical TypeScript code
- Use functional and declarative programming patterns
- Prefer iteration and modularization over duplication
- Use descriptive variable names with auxiliary verbs
Naming Conventions:
- Use lowercase with dashes for directories (e.g., components/form-wizard)
- Favor named exports for components
TypeScript Usage:
- Use TypeScript for all code; prefer interfaces over types
- Avoid enums; use maps instead
- Use functional components with TypeScript interfaces📋 .mdc - O Formato Moderno do Cursor
O formato .mdc (Markdown Cursor) e a evolucao do .cursorrules. Armazenados em .cursor/rules/, arquivos .mdc suportam YAML frontmatter com campos como description, globs e alwaysApply - muito similar ao SKILL.md.
Exemplo: .cursor/rules/react-patterns.mdc
---
description: Padroes React para componentes TSX
globs:
- "**/*.tsx"
- "**/*.jsx"
alwaysApply: false
---
# React Component Patterns
- Use functional components com hooks
- Prefira composicao sobre heranca
- Server Components por padrao no Next.js 14+
- Client Components apenas com "use client" quando necessario💡 Compatibilidade
O formato .mdc e praticamente identico ao SKILL.md em estrutura. A principal diferenca e a extensao do arquivo (.mdc vs .md) e o diretorio padrao (.cursor/rules/ vs qualquer lugar).
🌐 SKILL.md no Cursor
O Cursor tambem e capaz de ler arquivos SKILL.md encontrados no repositorio. Quando o Cursor encontra um SKILL.md, ele trata o conteudo como instrucoes adicionais para o agente, similar ao que faz com .mdc. Isso permite que projetos usem um formato unico para todos os agentes.
A compatibilidade nao e 100% perfeita - alguns campos do frontmatter especificos do padrao AgentSkills.io podem ser ignorados pelo Cursor. Porem, os campos essenciais (description, globs, alwaysApply) sao reconhecidos, tornando a portabilidade viavel na pratica.
Campos Reconhecidos
- • description - Usado para ativacao contextual
- • globs - Filtro por tipo de arquivo
- • alwaysApply - Se ativa sempre ou sob demanda
- • Corpo Markdown - Instrucoes completas
Campos Ignorados
- • name - Nao usado para routing
- • version - Sem versionamento nativo
- • tags - Sem sistema de tags
- • Campos customizados - Ignorados silenciosamente
🏪 Cursor Directory - Marketplace de Regras
O cursor.directory e um repositorio comunitario com centenas de .cursorrules prontos para uso. Abrange frameworks, linguagens e stacks completas. E o maior marketplace de instrucoes para agentes AI atualmente, com contribuicoes de milhares de desenvolvedores.
Embora as regras no cursor.directory estejam no formato .cursorrules (legacy), muitas podem ser facilmente convertidas para SKILL.md ou .mdc adicionando frontmatter. A comunidade tambem esta gradualmente migrando para formatos mais modernos.
📊 Categorias Populares no Cursor Directory
🔄 Migracao .cursorrules para SKILL.md
Migrar de .cursorrules para SKILL.md e um processo direto e nao-destrutivo. Voce pode manter o .cursorrules antigo para backward compatibility enquanto cria o SKILL.md com conteudo enriquecido.
Passo-a-Passo de Migracao
Copie o texto do .cursorrules para um novo arquivo SKILL.md
Insira o bloco YAML com name, description, globs e tags
Organize com headings, listas e code blocks para melhor parsing
Valide que funciona tanto no Cursor quanto em outros agentes
🚀 Dicas Avancadas para Cursor
Usuarios avancados do Cursor podem tirar proveito de tecnicas sofisticadas para maximizar a eficacia das suas rules. Composicao de rules, glob patterns complexos e estrategias de debug fazem diferenca significativa.
Composicao de Rules
Crie multiplos arquivos .mdc especializados em vez de um arquivo gigante. Ex: react-rules.mdc, testing-rules.mdc, api-rules.mdc. O Cursor carrega apenas os relevantes baseado nos globs.
Glob Patterns Avancados
Use padroes complexos para ativacao precisa:
globs:
- "src/components/**/*.tsx" # Apenas componentes
- "!**/*.test.tsx" # Excluir testes
- "**/*.{ts,tsx}" # TypeScript files
- "app/**/page.tsx" # Apenas pages Next.jsDebug de Rules
Pergunte ao Cursor "quais rules voce esta usando agora?" para verificar quais .mdc foram carregados no contexto atual. Isso ajuda a diagnosticar quando rules nao estao sendo aplicadas.
🎯 Proximo Passo
No proximo modulo, exploramos o Manus AI - um agente com VM completa que pode executar skills de forma totalmente autonoma.
📚 Resumo do Modulo
Proximo Modulo:
5.4 - Skills no Manus AI