A Salesforce-native reusable skill library for agentic coding tools, providing 36 skills, 7 specialized agents, and automated validation hooks covering Apex, Flow, LWC, SOQL, Agentforce, Data Cloud, and more.
sf-skills is an open-source project (MIT license, version 4.0.0) maintained by Salesforce Certified Technical Architect Jag Valaiyapathy, designed for AI coding agents like Claude Code. It encapsulates the full Salesforce development stack into reusable skills.
Skill Coverage#
36 skills across 10 capability domains:
- Development: sf-apex, sf-flow, sf-lwc, sf-soql
- Quality: sf-testing, sf-debug
- Foundation: sf-metadata, sf-data, sf-docs, sf-permissions
- Integration: sf-connected-apps, sf-integration
- Planning: sf-flex-estimator (Flex Credit estimation and cost optimization)
- Data Cloud: 7 skills covering connect, ingest, harmonize, segment, activate, retrieve full lifecycle (Beta/Community Preview)
- AI & Automation: 6 skills covering Agentforce full chain (design, Agent Script, testing, observability, persona, grid)
- DevOps & Tooling: sf-deploy, sf-vlocity-build-deploy, sf-diagram-mermaid, sf-diagram-nanobananapro
- Industries: 6 OmniStudio skills (EPC, Data Mappers, Integration Procedures, FlexCards, etc.)
Agent Team#
7 specialized agent roles: FDE team (fde-strategist orchestration, fde-engineer configuration, fde-experience-specialist conversational design) + cross-domain agents (fde-qa-engineer testing, fde-release-engineer deployment) + PS team (ps-technical-architect, ps-solution-architect). fde-strategist coordinates up to 4 concurrent worker threads.
Automated Validation Hook System#
Validation pipeline triggers automatically on every file write/edit:
- Apex (.cls/.trigger): Prettier formatting → Apex LSP compilation check → 90-point scorer → Code Analyzer PMD
- Flow (.flow-meta.xml): 110-point scoring → Code Analyzer Flow Scanner
- LWC JS: LWC LSP → 165-point SLDS scorer → ESLint → retire-js
- LWC HTML: Template anti-pattern validation
- SOQL: 100-point scoring → Live Query Plan API
- Agent Script (.agent): Syntax validation → LSP auto-fix loop
LSP Integration & Auto-Fix#
Three language servers supported: apex-jorje-lsp.jar (Java 11+), @salesforce/lwc-language-server (Node.js 18+), Agent Script Language Server (Node.js 18+). Auto-fix loop: write → LSP verify (~500ms) → detect errors → Claude diagnose and fix → up to 3 retries.
Hook Lifecycle#
- SessionStart: Session directory lifecycle initialization
- PreToolUse (Bash/MCP): Guardrail prompts (sfdx deprecation warning, old API version warning)
- PreToolUse (Bash): SOQL Schema JIT validation (sf sobject describe)
- PostToolUse (Write/Edit): Validation dispatcher → Prettier + LSP + Scorer + Code Analyzer
- PostToolUse (Bash): Debug Log analysis (anomaly detection, Governor Limits, performance hotspots)
Installation Methods#
- npx (skills only):
npx skills add Jaganpro/sf-skills - Claude Code full installation (recommended):
curl -sSL https://raw.githubusercontent.com/Jaganpro/sf-skills/main/tools/install.sh | bash, includes 36 skills + 7 agents + Hook system + LSP engine + guardrails - Python installer (Windows/CI):
curl -sSL https://raw.githubusercontent.com/Jaganpro/sf-skills/main/tools/install.py | python3
Prerequisites: Node.js 18+, Python 3.10+, Salesforce CLI v2.x, API 62.0+ (Agentforce requires 66.0+), authenticated Salesforce Org, sfdx-project.json.
Unconfirmed Information#
- Data Cloud runtime depends on external gthoppae/sf-cli-plugin-data360, not part of this repo; independent license and stability unconfirmed
- Claude Code only specifies "latest version", minimum compatible version not clarified
- README title states "14 skills, 420+ validation points" while body describes 36 skills, possibly a title sync issue
- Specific scoring dimensions and deduction rules for each scorer (90/100/110/165 points) not detailed in available materials