{"_id":"@clientellai/salesforce-skills","_rev":"3-6688fa30c5b1e800d35625bd9da1f20a","name":"@clientellai/salesforce-skills","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@clientellai/salesforce-skills","version":"1.0.0","keywords":["agent-skills","agentskills","salesforce","apex","lwc","soql","sosl","claude-code","cursor","codex","ai-coding","salesforce-dx","flow","lightning-web-components","salesforce-cli","sfdx","process-builder","appexchange","security-review","crud-fls","governor-limits","test-class","code-coverage","deployment","ci-cd","bulk-api","data-migration","permission-sets","custom-metadata","salesforce-skills"],"author":{"name":"Clientell"},"license":"Apache-2.0","_id":"@clientellai/salesforce-skills@1.0.0","maintainers":[{"name":"clientell","email":"engineering@getclientell.com"}],"homepage":"https://github.com/clientell/salesforce-skills","bugs":{"url":"https://github.com/clientell/salesforce-skills/issues"},"dist":{"shasum":"7a3e28138e2851ee3d4a321bfa100c84668b08f2","tarball":"https://registry.npmjs.org/@clientellai/salesforce-skills/-/salesforce-skills-1.0.0.tgz","fileCount":39,"integrity":"sha512-qjGnjLFTzZv/BBVGngXNDWGXp3deU0rj2JuS8XxeDxz65XCTyH9EsdKu6VyN/yuEoS2VaQKjPIfToo9VZ3hjzA==","signatures":[{"sig":"MEUCIH8GC1Xzu8hg1EIETLtwaQISLTllU6gsXVtvXRyQB2QvAiEAuY2+qNYzT55NYdT+XkNA4of8yGmWFymOVYFd+kEvz6M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":467511},"gitHead":"e1eecea76fdc0cf85a238d4f29932ba77b9f7859","_npmUser":{"name":"clientell","email":"engineering@getclientell.com"},"repository":{"url":"git+https://github.com/clientell/salesforce-skills.git","type":"git"},"_npmVersion":"11.6.2","description":"Salesforce development skills for AI coding agents — Apex, Flows, LWC, SOQL, security, deployments, and more. Works with Claude Code, Cursor, Codex, and 50+ AI tools.","directories":{},"_nodeVersion":"22.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/salesforce-skills_1.0.0_1773946340338_0.3987480422501417","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@clientellai/salesforce-skills","version":"1.0.1","keywords":["agent-skills","agentskills","salesforce","apex","lwc","soql","sosl","claude-code","cursor","codex","ai-coding","salesforce-dx","flow","lightning-web-components","salesforce-cli","sfdx","process-builder","appexchange","security-review","crud-fls","governor-limits","test-class","code-coverage","deployment","ci-cd","bulk-api","data-migration","permission-sets","custom-metadata","salesforce-skills"],"author":{"name":"Clientell"},"license":"Apache-2.0","_id":"@clientellai/salesforce-skills@1.0.1","maintainers":[{"name":"clientell","email":"engineering@getclientell.com"}],"homepage":"https://github.com/Clientell-Ai/salesforce-skills","bugs":{"url":"https://github.com/Clientell-Ai/salesforce-skills/issues"},"dist":{"shasum":"6f15b039f85ba61e7c2e345cfd1e8cd7a96dd0ae","tarball":"https://registry.npmjs.org/@clientellai/salesforce-skills/-/salesforce-skills-1.0.1.tgz","fileCount":39,"integrity":"sha512-nhSdzMY5zZttKdk332jIDZ7i2XKfLjBNq7sMtmJWmnVBik6cKgF3tsxN9bTubIUgyj0Xa2NdP/2VVRkjTStwag==","signatures":[{"sig":"MEYCIQCgBtUUConJFvCMPSUIQ8qg4wcBSymmbsSn5m1ygxLyjAIhAIvKFhI3xMaHyoaYB2n5+oDZhHapFwFPzGUwEtzFj21y","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":467568},"gitHead":"4e4a0b4b96e9d993e42b266f6d276463281d3e38","_npmUser":{"name":"clientell","email":"engineering@getclientell.com"},"repository":{"url":"git+https://github.com/Clientell-Ai/salesforce-skills.git","type":"git"},"_npmVersion":"11.6.2","description":"Salesforce development skills for AI coding agents — Apex, Flows, LWC, SOQL, security, deployments, and more. Works with Claude Code, Cursor, Codex, and 50+ AI tools.","directories":{},"_nodeVersion":"22.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/salesforce-skills_1.0.1_1773946720358_0.9223458119355745","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@clientellai/salesforce-skills","version":"1.0.2","description":"Salesforce development skills for AI coding agents — Apex, Flows, LWC, SOQL, security, deployments, and more. Works with Claude Code, Cursor, Codex, and 50+ AI tools.","keywords":["agent-skills","agentskills","salesforce","apex","lwc","soql","sosl","claude-code","cursor","codex","ai-coding","salesforce-dx","flow","lightning-web-components","salesforce-cli","sfdx","process-builder","appexchange","security-review","crud-fls","governor-limits","test-class","code-coverage","deployment","ci-cd","bulk-api","data-migration","permission-sets","custom-metadata","salesforce-skills"],"author":{"name":"Clientell"},"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/Clientell-Ai/salesforce-skills.git"},"homepage":"https://github.com/Clientell-Ai/salesforce-skills","bugs":{"url":"https://github.com/Clientell-Ai/salesforce-skills/issues"},"gitHead":"38dd0c74fe77f39cb88bef867e8eebd02beb2d38","_id":"@clientellai/salesforce-skills@1.0.2","_nodeVersion":"22.16.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-djp1esPPWwiWjQQQ2XpTdFlJhwPPT4ToV6eLbbUTcveCH0IwMbwI9nupc0sZj6ywTPR1XFWOlEYjbBm/06cyOQ==","shasum":"ad64dc5bab1e96809952b25d4510e15f515e46cf","tarball":"https://registry.npmjs.org/@clientellai/salesforce-skills/-/salesforce-skills-1.0.2.tgz","fileCount":53,"unpackedSize":670377,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFpikgunzFY0E3RTi/Qdy8ftZeqzuutXm5n820uDwthrAiAzBbX10Mh65sxkyaoVFp62dMkZ8A6/m0kc4+igf5LR0w=="}]},"_npmUser":{"name":"clientell","email":"engineering@getclientell.com"},"directories":{},"maintainers":[{"name":"clientell","email":"engineering@getclientell.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/salesforce-skills_1.0.2_1774013949951_0.0009020015179272978"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-19T18:52:20.253Z","modified":"2026-03-20T13:39:10.271Z","1.0.0":"2026-03-19T18:52:20.516Z","1.0.1":"2026-03-19T18:58:40.521Z","1.0.2":"2026-03-20T13:39:10.146Z"},"bugs":{"url":"https://github.com/Clientell-Ai/salesforce-skills/issues"},"author":{"name":"Clientell"},"license":"Apache-2.0","homepage":"https://github.com/Clientell-Ai/salesforce-skills","keywords":["agent-skills","agentskills","salesforce","apex","lwc","soql","sosl","claude-code","cursor","codex","ai-coding","salesforce-dx","flow","lightning-web-components","salesforce-cli","sfdx","process-builder","appexchange","security-review","crud-fls","governor-limits","test-class","code-coverage","deployment","ci-cd","bulk-api","data-migration","permission-sets","custom-metadata","salesforce-skills"],"repository":{"type":"git","url":"git+https://github.com/Clientell-Ai/salesforce-skills.git"},"description":"Salesforce development skills for AI coding agents — Apex, Flows, LWC, SOQL, security, deployments, and more. Works with Claude Code, Cursor, Codex, and 50+ AI tools.","maintainers":[{"name":"clientell","email":"engineering@getclientell.com"}],"readme":"[![Clientell](assets/logo.svg)](https://getclientell.com)\n\n# Salesforce Skills for AI Coding Agents\n\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Agent Skills](https://img.shields.io/badge/Agent_Skills-compatible-brightgreen)](https://agentskills.io)\n[![Install](https://img.shields.io/badge/npx_skills_add-clientell%2Fsalesforce--skills-8A2BE2)](https://skills.sh)\n[![Salesforce](https://img.shields.io/badge/Salesforce-API_v62.0-00A1E0?logo=salesforce)](https://developer.salesforce.com)\n\nProduction-ready [Agent Skills](https://agentskills.io) for Salesforce development. Generate Apex, Flows, LWC, SOQL, and more — with governor limit awareness, security compliance, and deployment orchestration built in.\n\nWorks with **Claude Code, Cursor, Codex, Gemini CLI, VS Code Copilot**, and [50+ AI tools](https://agentskills.io).\n\n## Quick Start\n\n```bash\nnpx skills add Clientell-Ai/salesforce-skills\n```\n\nThat's it. All 18 skills are now available in your AI coding agent.\n\n## Install Individual Skills\n\n```bash\nnpx skills add Clientell-Ai/salesforce-skills@sf-apex       # Apex code generation & review\nnpx skills add Clientell-Ai/salesforce-skills@sf-test       # Test class generation\nnpx skills add Clientell-Ai/salesforce-skills@sf-flow       # Flow generation & PB migration\nnpx skills add Clientell-Ai/salesforce-skills@sf-lwc        # LWC scaffolding\nnpx skills add Clientell-Ai/salesforce-skills@sf-soql       # SOQL/SOSL query building\nnpx skills add Clientell-Ai/salesforce-skills@sf-security   # Security & AppExchange audit\nnpx skills add Clientell-Ai/salesforce-skills@sf-deploy     # Deployment orchestration & CI/CD\nnpx skills add Clientell-Ai/salesforce-skills@sf-data       # Data migration & bulk operations\nnpx skills add Clientell-Ai/salesforce-skills@sf-schema     # Schema & permission management\nnpx skills add Clientell-Ai/salesforce-skills@sf-debug      # Debug log analysis & troubleshooting\nnpx skills add Clientell-Ai/salesforce-skills@sf-agentforce # Agentforce agents, topics & actions\nnpx skills add Clientell-Ai/salesforce-skills@sf-permissions # Permission sets & access auditing\nnpx skills add Clientell-Ai/salesforce-skills@sf-integration # Named Credentials, OAuth, Platform Events\nnpx skills add Clientell-Ai/salesforce-skills@sf-docs       # Salesforce documentation navigator\nnpx skills add Clientell-Ai/salesforce-skills@sf-diagram    # Mermaid diagrams from metadata\nnpx skills add Clientell-Ai/salesforce-skills@sf-omnistudio # OmniStudio (OmniScripts, FlexCards, IPs)\nnpx skills add Clientell-Ai/salesforce-skills@sf-find       # Skill discovery\n```\n\n### Install globally (all projects)\n\n```bash\nnpx skills add Clientell-Ai/salesforce-skills -g\n```\n\n### Manual installation\n\n```bash\ngit clone https://github.com/Clientell-Ai/salesforce-skills.git\ncd salesforce-skills\n./install.sh /path/to/your/salesforce-project\n```\n\n## What Problems Do These Skills Solve?\n\n| Pain Point | Skill | What It Does |\n|------------|-------|-------------|\n| Writing test classes is tedious | **sf-test** | Generates comprehensive tests with @TestSetup, 200-record bulk, permission testing, callout mocks, async testing, Stub API |\n| Deployment failures (37-60% fail rate) | **sf-deploy** | Resolves dependencies, diagnoses errors, generates CI/CD pipelines, manages scratch orgs and packages |\n| AppExchange security review failures | **sf-security** | Audits CRUD/FLS, SOQL injection, sharing violations, PII exposure, XSS — full AppExchange checklist |\n| Process Builder migration (support ended Dec 2025) | **sf-flow** | Converts PB to optimized Flows with bypass logic, consolidation, proper XML generation |\n| Governor limit violations | **sf-apex** | Generates bulkified Apex with async decision tables, exception handling, integration patterns |\n| Complex SOQL/SOSL queries | **sf-soql** | Builds optimized queries with date literals, geolocation, dynamic SOQL, FIELDS(), FOR UPDATE |\n| LWC scaffolding complexity | **sf-lwc** | Full bundles with LDS, navigation, LMS, lifecycle hooks, Jest tests, accessibility |\n| Data migration headaches | **sf-data** | Bulk API 2.0, relationship ordering, external ID upsert, file migration, sandbox seeding |\n| Metadata XML boilerplate | **sf-schema** | All field types, formulas, rollup summaries, Global Value Sets, record types, permission set groups |\n\n## Skills Catalog\n\n| Skill | Description | Invoke |\n|-------|-------------|--------|\n| **sf-apex** | Generate and review Apex classes, triggers, batch jobs with governor limit awareness, CRUD/FLS compliance, async patterns (future/queueable/batch/schedulable), integration patterns, and invocable methods | `/sf-apex` |\n| **sf-test** | Generate comprehensive test classes with @TestSetup, bulk data, permission testing, callout mocks, async testing, Platform Event/CDC testing, Stub API, and REST endpoint testing | `/sf-test` |\n| **sf-flow** | Generate Flow metadata XML, migrate Process Builders to Flows with bypass logic, screen flows, orchestrations, scheduled paths, global variables, and flow test coverage | `/sf-flow` |\n| **sf-lwc** | Scaffold Lightning Web Components with LDS, lifecycle hooks, navigation, Lightning Message Service, shadow/light DOM, Jest tests, and SLDS compliance | `/sf-lwc` |\n| **sf-soql** | Build and optimize SOQL/SOSL queries with date literals, FIELDS(), geolocation, dynamic SOQL, record locking, ALL ROWS, and WITH USER_MODE | `/sf-soql` |\n| **sf-security** | Audit codebases for CRUD/FLS violations, SOQL injection, sharing model issues, custom permission checks, Shield encryption awareness, and AppExchange review readiness | `/sf-security` |\n| **sf-deploy** | Orchestrate deployments with scratch orgs, unlocked/2GP packages, destructive changes, Code Analyzer, multiple auth methods, and CI/CD pipeline generation | `/sf-deploy` |\n| **sf-data** | Data migration with Bulk API 2.0, external ID upserts, relationship ordering, record type mapping, file migration, and sandbox seeding | `/sf-data` |\n| **sf-schema** | Scaffold custom objects with formulas, rollup summaries, geolocation, Global Value Sets, record types, Custom Metadata Types, and permission set groups | `/sf-schema` |\n| **sf-find** | Discover the right Salesforce skill for your task | `/sf-find` |\n\n## Agents (Claude Code)\n\nSpecialized subagents for parallel, focused work:\n\n| Agent | Purpose | Model |\n|-------|---------|-------|\n| **apex-reviewer** | Read-only code review for governor limits, bulkification, security | Haiku (fast) |\n| **test-generator** | Generate comprehensive test classes from existing code | Sonnet |\n| **security-auditor** | Scan entire codebases for security vulnerabilities | Haiku (fast) |\n| **deploy-orchestrator** | Multi-step deployment management with error diagnosis | Sonnet |\n\n## Compatibility\n\nThese skills follow the open [Agent Skills specification](https://agentskills.io/specification) and work with:\n\n**IDEs & Editors:** Claude Code, Cursor, VS Code Copilot, Windsurf, Cline, Continue, Augment, Junie, OpenCode, Roo Code\n\n**Standalone Agents:** OpenHands, Goose, Mux, Amp, Gemini CLI, Codex\n\n**Platforms:** Databricks, GitHub Copilot, Factory AI, Spring AI\n\nAnd [many more](https://agentskills.io).\n\n## Prerequisites\n\n1. **Salesforce CLI v2+** — [Install](https://developer.salesforce.com/tools/salesforcecli)\n   ```bash\n   npm install @salesforce/cli -g\n   ```\n\n2. **Authenticated Salesforce org**\n   ```bash\n   sf org login web --alias myOrg\n   ```\n\n3. **Any compatible AI coding agent** — [See full list](https://agentskills.io)\n\n## Configuration\n\n### MCP Server (Optional)\n\nEnable the Salesforce DX MCP server for enhanced org interaction. Edit `.claude/.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"salesforce-dx\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@anthropic/salesforce-dx-mcp-server\"],\n      \"env\": { \"SF_ORG_ALIAS\": \"myOrg\" },\n      \"disabled\": false\n    }\n  }\n}\n```\n\n### Project Context\n\nUpdate `CLAUDE.md` in your Salesforce project with org-specific conventions:\n- Custom object naming patterns\n- API version\n- Deployment targets\n- Team coding standards\n\n## Benchmark: Do Skills Actually Help?\n\nYes. Across 15 tasks, skills improve AI-generated Salesforce code by **+108%** (10.3 → 21.4 out of 25).\n\n| Category | Without Skills | With Skills | Improvement |\n|----------|:---:|:---:|:---:|\n| **Security** | 1.5/5 | 4.5/5 | +200% |\n| **Governor Limits** | 2.5/5 | 4.4/5 | +76% |\n| **Bulkification** | 2.1/5 | 4.3/5 | +105% |\n| **Patterns** | 2.1/5 | 4.2/5 | +100% |\n| **Completeness** | 2.1/5 | 4.0/5 | +90% |\n| **Total** | **10.3/25 (41%)** | **21.4/25 (86%)** | **+108%** |\n\n> Scored by Claude as judge against a [Salesforce-specific rubric](evals/benchmarks/rubric.md) across [15 tasks](evals/benchmarks/tasks.json).\n> [Full results with per-task breakdown](evals/benchmarks/results/BENCHMARK.md) | [Run it yourself](#evaluate-yourself)\n\n### Evaluate Yourself\n\n```bash\n# In Claude Code — run the benchmark interactively\n/sf-eval\n\n# Run a single task\n/sf-eval apex-trigger-bulk\n\n# Static analysis on your own code (no LLM needed)\nbash evals/checks/static-checks.sh MyClass.cls\n\n# Headless benchmark (requires API key)\nexport ANTHROPIC_API_KEY=\"sk-ant-...\"\nbash evals/benchmarks/run-benchmark.sh\n```\n\n## Project Structure\n\n```\nsalesforce-skills/\n├── skills/                  # All skills (canonical location)\n│   ├── sf-apex/             # Apex + 3 reference files\n│   ├── sf-test/             # Testing + 1 reference file\n│   ├── sf-flow/             # Flows + 2 reference files\n│   ├── sf-lwc/              # LWC + 1 reference file\n│   ├── sf-soql/             # SOQL/SOSL + 1 reference file\n│   ├── sf-security/         # Security + 2 reference files\n│   ├── sf-deploy/           # Deploy + 1 reference file\n│   ├── sf-data/             # Data + 1 reference file\n│   ├── sf-schema/           # Schema + 1 reference file\n│   ├── sf-debug/            # Debug log analysis & troubleshooting\n│   ├── sf-agentforce/       # Agentforce agents, topics & actions\n│   ├── sf-permissions/      # Permission sets & access auditing\n│   ├── sf-integration/      # Named Credentials, OAuth, Platform Events\n│   ├── sf-docs/             # Salesforce documentation navigator\n│   ├── sf-diagram/          # Mermaid diagrams from metadata\n│   ├── sf-omnistudio/       # OmniStudio (OmniScripts, FlexCards, IPs)\n│   ├── sf-find/             # Discovery\n│   └── sf-eval/             # Skill evaluation & benchmarking\n├── .agents/skills/          # Cross-client symlinks\n├── .claude/                 # Claude Code config + agents\n├── references/              # Shared reference docs\n├── scripts/                 # Helper scripts (--help, --format json)\n└── evals/                   # Skill evaluation framework\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for how to add new skills, improve existing ones, or report issues.\n\n## License\n\nApache-2.0 — see [LICENSE](LICENSE).\n\nBuilt by [Clientell](https://getclientell.com).\n","readmeFilename":"README.md"}