Cómo enseñar a Cursor y Claude Code a escribir correctamente para Salesforce

Si has intentado generar Apex triggers o Lightning Web Components a través de ChatGPT o Cursor estándar, probablemente hayas visto los errores típicos. El modelo confunde los contextos de los triggers, olvida los límites de SOQL dentro de los bucles, o ensambla manifiestos XML con versiones de API obsoletas. Terminas escribiendo system prompts masivos y adjuntando manualmente fragmentos de documentación a cada solicitud.

Salesforce decidió abordar esto sistemáticamente y lanzó un repositorio sf-skills. Es un conjunto de instrucciones listas para usar, plantillas y scripts ejecutables, empaquetados según un estándar abierto de agent skills.

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

¿Qué son los Agent Skills

La idea del formato es simple. En lugar de alimentar a un LLM con texto largo y sin estructura, cada skill se organiza como una carpeta separada con una arquitectura clara:

• SKILL.md — un archivo requerido con instrucciones y metadatos en YAML front matter. Describe cuándo y cómo el agente debe aplicar este skill.
• scripts/ — scripts ejecutables en Python, Bash o JavaScript que el agente puede ejecutar para validación o generación de artefactos.
• references/ — materiales de referencia y resúmenes de documentación para un tema específico.
• assets/ — plantillas listas para usar, esquemas de metadatos y tablas de mapeo.

El repositorio sigue la especificación agentskills.io. Esto significa que los skills no están codificados en los servicios internos de la empresa. Pueden conectarse a cualquier herramienta que soporte este formato abierto.

Cómo conectar con tu editor

Si trabajas en el entorno interno de Agentforce Vibes, los skills se incorporan y actualizan automáticamente. Para herramientas de desarrollo conocidas como Claude Code, OpenCode o Cursor, conectar solo requiere un comando de terminal:

npx skills add forcedotcom/sf-skills

La utilidad descarga los bundles necesarios y los registra en la configuración del asistente. Después de eso, el agente comprende los comandos y reglas específicos de la plataforma sin necesidad de aclaraciones adicionales en el chat.

Qué hay dentro de la biblioteca

El repositorio contiene flujos de trabajo para diferentes capas de la plataforma.

La generación de código del lado del servidor incluye reglas para crear clases Apex, escritura correcta de consultas SOQL considerando FLS (Field-Level Security), y plantillas para pruebas unitarias. El asistente deja de generar asserts vacíos solo para cobertura de líneas.

Para desarrollo declarativo, existen skills para crear objetos personalizados, campos y permission sets. El agente ensambla archivos XML de metadatos válidos que pueden desplegarse inmediatamente a través de Salesforce CLI sin edición manual de etiquetas.

Una sección separada está dedicada a automatizaciones e interfaces. Esto incluye flujos de trabajo para crear Flow y Lightning Web Components (LWC), incluyendo bundles UI auxiliares de React.

La carpeta samples contiene ejemplos de aplicaciones listas para usar. Por ejemplo, una plantilla de bundle UI se sincroniza directamente con el paquete npm @salesforce/ui-bundle-template-app-react-sample-b2e a través de GitHub Actions. Puedes ejecutar la sincronización localmente:

npm install
npm run sync-react-b2e-sample

En qué prestar atención

El proyecto está en rework activo. Los desarrolladores advierten honestamente en el README: la estructura de carpetas y los nombres de los skills pueden cambiar sin compatibilidad hacia atrás. No hay garantías de estabilidad aquí, a diferencia de lo que esperarías de los releases de API de Salesforce GA.

Si haces fork del repositorio o realizas cambios locales, prepárate para resolver conflictos al actualizar desde upstream. Actualmente, el proyecto tiene poco menos de 900 estrellas en GitHub, pero la base de commits se actualiza casi diariamente.

¿Vale la pena probar

Si escribes regularmente para Salesforce y usas asistentes de IA en la terminal o IDE, el proyecto definitivamente te ahorrará tiempo. Ya no tendrás que recordar manualmente al modelo sobre la estructura XML para Custom Field o explicar las reglas para escribir clases mock para llamadas HTTP en Apex.

La forma más fácil de comenzar es instalando a través de npx skills add en un proyecto de prueba para ver cómo tu modelo habitual maneja la generación de metadatos con las nuevas instrucciones.