Hoe je Cursor en Claude Code leert om correct voor Salesforce te schrijven

Als je ooit Apex-triggers of Lightning Web Components hebt laten genereren door ChatGPT of standaard Cursor, heb je waarschijnlijk de typische fouten gezien. Het model raakt trigger-contexten door elkaar, vergeet SOQL-limieten binnen loops, of stelt XML-manifesten samen met verouderde API-versies. Je eindigt met het schrijven van enorme systeemprompts en het handmatig toevoegen van documentatiefragmenten aan elk verzoek.

Salesforce heeft besloten dit systematisch aan te pakken en heeft een repository vrijgegeven sf-skills. Het is een set kant-en-klare instructies, templates en uitvoerbare scripts, verpakt volgens een open agent skills-standaard.

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

Wat zijn Agent Skills

Het idee achter het formaat is eenvoudig. In plaats van een LLM lange, ongestructureerde tekst te voeren, is elke skill georganiseerd als een aparte map met een duidelijke architectuur:

• SKILL.md — een verplicht bestand met instructies en metadata in YAML front matter. Het beschrijft wanneer en hoe de agent deze skill moet toepassen.
• scripts/ — uitvoerbare scripts in Python, Bash of JavaScript die de agent kan uitvoeren voor validatie of artifact-generatie.
• references/ — referentiemateriaal en documentatiesamenvattingen voor een specifiek onderwerp.
• assets/ — kant-en-klare templates, metadataschema's en mapping-tabellen.

De repository volgt de agentskills.io specificatie. Dit betekent dat de skills niet hardcoded zijn aan de interne services van het bedrijf. Ze kunnen worden verbonden met elk gereedschap dat dit open formaat ondersteunt.

Hoe te verbinden met je editor

Als je in de interne Agentforce Vibes-omgeving werkt, worden skills automatisch opgehaald en bijgewerkt. Voor bekende ontwikkelaarstools zoals Claude Code, OpenCode of Cursor kost het verbinden slechts één terminalcommando:

npx skills add forcedotcom/sf-skills

Het hulpprogramma downloadt de vereiste bundles en registreert ze in de assistent-configuratie. Daarna begrijpt de agent platform-specifieke commando's en regels zonder extra toelichting in de chat.

Wat zit er in de bibliotheek

De repository bevat workflows voor verschillende platformlagen.

Generatie van server-side code omvat regels voor het maken van Apex-klassen, correct SOQL-query-schrijven met FLS (Field-Level Security) in gedachten, en templates voor unit tests. De assistent stopt met het genereren van lege asserts alleen voor regel-dekking.

Voor declaratieve ontwikkeling zijn er skills voor het maken van custom objects, velden en permission sets. De agent assembleert geldige XML-metadata-bestanden die direct via Salesforce CLI kunnen worden gedeployed zonder handmatige tag-bewerking.

Een apart onderdeel is gewijd aan automatisering en interfaces. Dit omvat workflows voor het maken van Flow en Lightning Web Components (LWC), inclusief hulpreacties voor React UI-bundles.

De samples map bevat voorbeelden van kant-en-klare applicaties. Een UI-bundletemplate synchroniseert bijvoorbeeld direct met het @salesforce/ui-bundle-template-app-react-sample-b2e npm-pakket via GitHub Actions. Je kunt synchronisatie lokaal uitvoeren:

npm install
npm run sync-react-b2e-sample

Waar op te letten

Het project is in actieve herwerking. De ontwikkelaars waarschuwen eerlijk in de README: mapstructuur en skill-namen kunnen zonder backward compatibility veranderen. Er zijn hier geen stabiliteitsgaranties, in tegenstelling tot wat je zou verwachten van GA Salesforce API-releases.

Als je de repository fork of lokale wijzigingen maakt, wees dan voorbereid op het oplossen van conflicten bij het updaten van upstream. Momenteel heeft het project iets minder dan 900 sterren op GitHub, maar de commit-basis wordt bijna dagelijks bijgewerkt.

Is het de moeite waard om te proberen

Als je regelmatig voor Salesforce schrijft en AI-assistenten gebruikt in de terminal of IDE, zal het project zeker tijd besparen. Je hoeft niet meer handmatig het model te herinneren aan de XML-structuur voor Custom Field of de regels uit te leggen voor het schrijven van mock-klassen voor HTTP-calls in Apex.

De makkelijkste manier om te beginnen is door te installeren via npx skills add in een testproject om te zien hoe je gebruikelijke model omgaat met metadatageneratie met de nieuwe instructies.