Como ensinar Cursor e Claude Code a escrever corretamente para Salesforce

Se você já tentou gerar Apex triggers ou Lightning Web Components através do ChatGPT ou do Cursor padrão, provavelmente viu os erros típicos. O modelo confunde contextos de trigger, esquece sobre limites de SOQL dentro de loops, ou monta manifests XML com versões de API desatualizadas. Você acaba escrevendo system prompts massivos e anexando manualmente snippets de documentação a cada requisição.

A Salesforce decidiu resolver isso sistematicamente e lançou um repositório sf-skills. É um conjunto de instruções prontas, templates e scripts executáveis, empacotados de acordo com um padrão aberto de agent skills.

sf-skills/
├── skills/               # Директории с конкретными воркфлоу
│   ├── platform-apex-generate/
│   ├── platform-custom-object-generate/
│   ├── automation-flow-generate/
│   └── ...
├── samples/              # Примеры приложений
└── scripts/

O que são Agent Skills

A ideia do formato é simples. Em vez de alimentar um LLM com texto longo e não estruturado, cada skill é organizada como uma pasta separada com uma arquitetura clara:

• SKILL.md — um arquivo obrigatório com instruções e metadados em YAML front matter. Ele descreve quando e como o agente deve aplicar essa skill.
• scripts/ — scripts executáveis em Python, Bash ou JavaScript que o agente pode executar para validação ou geração de artefatos.
• references/ — materiais de referência e resumos de documentação para um tópico específico.
• assets/ — templates prontos, schemas de metadados e tabelas de mapeamento.

O repositório segue a especificação agentskills.io. Isso significa que as skills não são hardcoded para os serviços internos da empresa. Elas podem ser conectadas a qualquer ferramenta que suporte esse formato aberto.

Como conectar ao seu editor

Se você trabalha no ambiente interno Agentforce Vibes, as skills são puxadas e atualizadas automaticamente. Para ferramentas de desenvolvedor conhecidas como Claude Code, OpenCode ou Cursor, conectar leva um comando de terminal:

npx skills add forcedotcom/sf-skills

O utilitário baixa os bundles necessários e os registra na configuração do assistente. Depois disso, o agente entende comandos e regras específicas da plataforma sem necessidade de esclarecimentos adicionais no chat.

O que tem dentro da biblioteca

O repositório contém fluxos de trabalho para diferentes camadas da plataforma.

A geração de código server-side inclui regras para criar classes Apex, escrita adequada de queries SOQL com foco em FLS (Field-Level Security), e templates para testes unitários. O assistente para de gerar asserts vazios apenas para cobertura de linha.

Para desenvolvimento declarativo, existem skills para criar objetos customizados, campos e permission sets. O agente monta arquivos XML de metadados válidos que podem ser implantados imediatamente através do Salesforce CLI sem edição manual de tags.

Uma seção separada é dedicada a automações e interfaces. Isso inclui fluxos de trabalho para criar Flow e Lightning Web Components (LWC), incluindo bundles UI React auxiliares.

A pasta samples contém exemplos de aplicações prontas. Por exemplo, um template de bundle UI sincroniza diretamente com o pacote npm @salesforce/ui-bundle-template-app-react-sample-b2e via GitHub Actions. Você pode executar a sincronização localmente:

npm install
npm run sync-react-b2e-sample

O que prestar atenção

O projeto está em reestruturação ativa. Os desenvolvedores alertam honestamente no README: a estrutura de pastas e os nomes das skills podem mudar sem compatibilidade retroativa. Não há garantias de estabilidade aqui, diferente do que você esperaria de lançamentos de API GA da Salesforce.

Se você fizer um fork do repositório ou mudanças locais, esteja preparado para resolver conflitos ao atualizar do upstream. Atualmente, o projeto tem pouco menos de 900 estrelas no GitHub, mas a base de commits é atualizada quase diariamente.

Vale a pena tentar

Se você escreve regularmente para Salesforce e usa assistentes de IA no terminal ou IDE, o projeto certamente economizará tempo. Você não precisará mais lembrar manualmente ao modelo sobre a estrutura XML para Custom Field ou explicar as regras para escrever classes mock para chamadas HTTP em Apex.

A maneira mais fácil de começar é instalando via npx skills add em um projeto de teste para ver como seu modelo usual lida com a geração de metadados com as novas instruções.