Salesforce Skills for Agentic Coding Tools

💙 Community-powered agentic coding knowledge, shared by a Salesforce Certified Technical Architect (CTA)

A reusable skill library for Salesforce-focused coding agents—covering Apex, Flow, LWC, SOQL, metadata, Data Cloud, integration, testing, deployment, Agentforce workflows, and Flex Credit estimation.

Included: 36 Salesforce skills, 7 specialist Claude Code agents, a shared hook system for guardrails and auto-validation, and LSP-backed feedback for Apex, LWC, and Agent Script.

Recommended workflow for this repository: agent-first development in Claude Code, Pi, and similar coding agents. VS Code is optional tooling, not the primary operating model.

The primary value of this repo is the skill library itself, not a VS Code-first workflow.

Start here: Available Skills · Installation · Claude Code Features · Skill Architecture

✨ Available Skills

The library is organized by capability area so you can scan quickly, pick the right entry point, and jump straight into the relevant skill folder.

🚀 Installation

Choose Your Path

Any AI Coding Agent

Requires Node.js 18+ (provides the npx command)

npx skills add Jaganpro/sf-skills

Works with Claude Code, Codex, Gemini CLI, OpenCode, Amp, and 40+ agents.

Note for Data Cloud users: the sf-datacloud-* family uses an external community sf data360 CLI runtime. Install sf-skills normally, then follow skills/sf-datacloud/references/plugin-setup.md if you plan to use the Data Cloud family.

# Install a single skill
npx skills add Jaganpro/sf-skills --skill sf-apex

# List available skills before installing
npx skills add Jaganpro/sf-skills --list

Claude Code (Full Experience)

Using Claude Code? This path is recommended — npx installs skills only, while the installer adds the full local experience: skills + agents + hooks + LSP + guardrails.

curl -sSL https://raw.githubusercontent.com/Jaganpro/sf-skills/main/tools/install.sh | bash

This installs 36 skills, 7 specialist agents, a shared hook system, and the local LSP engine. It also configures LLM-powered guardrails (Haiku prompt hook), SOQL schema validation, Prettier auto-formatting, Code Analyzer (PMD/ESLint), and debug log analysis (Haiku agent hook).

Data Cloud note: the installer brings in the sf-datacloud-* skills, but the external community sf data360 CLI runtime is still a separate prerequisite. On first-time install the installer can prompt for it, or you can request it explicitly with --with-datacloud-runtime.

Restart Claude Code after installation.

Direct Python Installer (manual / Windows / CI)

curl -sSL https://raw.githubusercontent.com/Jaganpro/sf-skills/main/tools/install.py | python3

Want the optional Data Cloud runtime too?

curl -sSL https://raw.githubusercontent.com/Jaganpro/sf-skills/main/tools/install.py | python3 - --with-datacloud-runtime

Use this path when you want to:

• review installer output directly
• run on Windows without the bash wrapper
• script installs in CI or managed environments
• access advanced installer commands immediately

Updating

Managing install.py

After sf-skills is installed, use the installed copy at ~/.claude/sf-skills-install.py for normal updates. Use tools/install.py only when developing or testing from a cloned repo checkout.

Data Cloud: the sf-datacloud-* family ships with sf-skills, but live Data Cloud execution also needs the optional community sf data360 runtime. Install it during setup when prompted, or later with python3 ~/.claude/sf-skills-install.py --with-datacloud-runtime.

Troubleshooting: if a Data Cloud runtime clone error mentions gthoppae/sf-cli-plugin-data360, your local installer copy is stale. First refresh it with python3 ~/.claude/sf-skills-install.py --force-update, then rerun python3 ~/.claude/sf-skills-install.py --with-datacloud-runtime.

python3 ~/.claude/sf-skills-install.py --status                  # Check version and install state
python3 ~/.claude/sf-skills-install.py --update                  # Update to latest
python3 ~/.claude/sf-skills-install.py --force-update            # Reinstall even if already current
python3 ~/.claude/sf-skills-install.py --with-datacloud-runtime  # Install optional Data Cloud runtime
python3 ~/.claude/sf-skills-install.py --diagnose                # Run installer diagnostics
python3 ~/.claude/sf-skills-install.py --restore-settings        # Restore settings.json from backup
python3 ~/.claude/sf-skills-install.py --cleanup                 # Clean legacy artifacts
python3 ~/.claude/sf-skills-install.py --uninstall               # Remove everything installed by sf-skills
python3 ~/.claude/sf-skills-install.py --dry-run                 # Preview without applying

Installer Profiles

python3 ~/.claude/sf-skills-install.py --profile list
python3 ~/.claude/sf-skills-install.py --profile save personal
python3 ~/.claude/sf-skills-install.py --profile use enterprise
python3 ~/.claude/sf-skills-install.py --profile show enterprise
python3 ~/.claude/sf-skills-install.py --profile delete old

Upgrading from npx to install.py? Just run the installer command above — it auto-detects and migrates.

What Gets Installed (install.py only)

~/.claude/
├── skills/                    # 36 Salesforce skills
│   ├── sf-apex/SKILL.md
│   ├── sf-flow/SKILL.md
│   └── ... (33 more)
├── agents/                    # 7 FDE + PS agents
│   ├── fde-strategist.md
│   ├── fde-engineer.md
│   └── ... (5 more)
├── hooks/                     # Shared hook system and registry
│   ├── scripts/
│   └── skills-registry.json
├── lsp-engine/                # LSP wrappers (Apex, LWC, AgentScript)
├── .sf-skills.json            # Version + metadata
└── sf-skills-install.py       # Installer for updates

Active hook lifecycle:

For deeper install and hook internals, see tools/README.md and shared/hooks/README.md.

⚙️ Claude Code Features

💡 Auto-Activation

Skills are available as slash commands (for example /sf-apex, /sf-flow, /sf-ai-agentscript). Claude can also select the appropriate skill dynamically from your request context — keywords, intent, and file patterns in shared/hooks/skills-registry.json document what each skill is best at.

Automatic Validation Hooks

Each skill includes validation hooks that run automatically on Write and Edit operations:

🌐 Live Query Plan Analysis (Org: my-dev-org)
   L42: ✅ Cost 0.3 (Index)
   L78: ⚠️ Cost 2.1 (TableScan) ⚠️ IN LOOP
      📝 Field Status__c is not indexed

🔤 Language Server Protocol (LSP) Integration

Skills leverage official Salesforce LSP servers for real-time syntax validation with auto-fix loops:

How Auto-Fix Loops Work:

1. Claude writes/edits a file
2. LSP hook validates syntax (~500ms)
3. If errors found → Claude receives diagnostics and auto-fixes
4. Repeat up to 3 attempts

Prerequisites: See LSP table in Prerequisites section. LWC uses a standalone npm package; Apex and Agent Script use official extension-bundled language-server artifacts.

Hooks provide advisory feedback — they inform but don't block operations.

🤖 Agent Team

Seven specialized Claude Code agents for Salesforce implementations, installed to ~/.claude/agents/.

FDE Team (Agent-Focused)

Cross-Cutting (Serve Both Teams)

PS Team (Platform Infrastructure)

Hierarchy

fde-strategist (orchestrator — plans, researches, delegates)
├── FDE: fde-engineer, fde-experience-specialist
├── QA/Release: fde-qa-engineer, fde-release-engineer
└── PS: ps-technical-architect, ps-solution-architect

The strategist spawns up to 4 concurrent workers via Task(). PS agents have WebSearch and WebFetch for self-directed Salesforce docs lookup.

🔗 Skill Architecture

This is the working mental model for the ecosystem: foundation and integration skills support build work, quality skills reinforce delivery, AI skills cluster around Agentforce workflows, and sf-deploy carries finished assets across environments.

• AI & Automation sits at the top, centered on Agentforce workflows.
• Development + Integration occupy the middle of the map where most implementation work happens.
• Quality sits after build work and before delivery.
• DevOps is separated for release and deployment automation.
• Diagrams is separated for Mermaid and premium visual artifact generation.
• Foundation anchors the base with metadata, data, and permissions context.

Why SVG instead of Mermaid here? GitHub renders larger Mermaid graphs very small. A custom SVG keeps labels crisp, gives us better spacing, and reads more like a clean capability map than a dense dependency graph.

Deployment path: use sf-deploy for Salesforce deployments across Apex, Flow, LWC, metadata, and Agentforce assets. For local browser viewing, a standalone companion lives at docs/assets/skill-ecosystem-overview.html and now uses the refreshed skill-capability-map-v3.svg asset.

🎬 Video Tutorials

🔧 Prerequisites

Cross-CLI minimum

• Node.js 18+ — required for npx skills add

Claude Code full install

• Claude Code (latest version)
• Salesforce CLI v2.x (sf command) — npm install -g @salesforce/cli
• Python 3.10+ — for hooks, validation, and installer tooling
• Authenticated Salesforce Org — DevHub, Sandbox, or Scratch Org
• sfdx-project.json — standard DX project structure

API Version Requirements

Optional dependencies (enable richer validation / LSP features)

Data Cloud family runtime (sf-datacloud-*):

• Community sf data360 CLI plugin — external runtime required for the Data Cloud family
• Setup guide — see skills/sf-datacloud/references/plugin-setup.md
• Bootstrap helper — bash ~/.claude/skills/sf-datacloud/scripts/bootstrap-plugin.sh

Code Analyzer V5 engines:

• Java 11+ — Enables PMD, CPD, SFGE engines (brew install openjdk@11)
• Node.js 18+ — Enables ESLint, RetireJS for LWC (brew install node)
• Code Analyzer plugin — sf plugins install @salesforce/sfdx-code-analyzer

LWC Testing & Linting:

• @salesforce/sfdx-lwc-jest — Jest testing for LWC (npm install @salesforce/sfdx-lwc-jest --save-dev)
• @salesforce-ux/slds-linter — SLDS validation (npm install -g @salesforce-ux/slds-linter)

LSP real-time validation (auto-fix loops):

• LWC Language Server — npm install -g @salesforce/lwc-language-server (standalone, no VS Code needed)
• VS Code with Salesforce Extensions — Official Salesforce extension artifacts are still the source of the Apex and Agent Script language servers. In this repository, VS Code Marketplace usage is optional from a workflow perspective; install those extensions only if you want the bundled language-server binaries locally.
  • Apex: Install "Salesforce Extension Pack" (Java JAR bundled in extension)
  • Agent Script: Install "Salesforce Agent Script" extension (server.js bundled in extension)
• Java 11+ — Required for Apex LSP (same as Code Analyzer)
• Node.js 18+ — Required for Agent Script and LWC LSP

Apex Development:

• Trigger Actions Framework (TAF) — Optional package for sf-apex trigger patterns
  • Package ID: 04tKZ000000gUEFYA2 or GitHub repo

"Generate an Apex trigger for Account using Trigger Actions Framework"
"Review my AccountService class for best practices"
"Create a batch job to process millions of records"
"Generate a test class with 90%+ coverage"

"Create a screen flow for account creation with validation"
"Build a record-triggered flow for opportunity stage changes"
"Generate a scheduled flow for data cleanup"

"Create a custom object called Invoice with auto-number name field"
"Add a lookup field from Contact to Account"
"Generate a permission set for invoice managers with full CRUD"
"Create a validation rule to require close date when status is Closed"
"Describe the Account object in my org and list all custom fields"

"Query all Accounts with related Contacts and Opportunities"
"Create 251 test Account records for trigger bulk testing"
"Insert 500 records from accounts.csv using Bulk API"
"Generate test data hierarchy: 10 Accounts with 3 Contacts each"
"Clean up all test records created today"

"Create a datatable component to display Accounts with sorting"
"Build a form component for creating new Contacts"
"Generate a Jest test for my accountCard component"
"Create an Apex controller with @AuraEnabled methods for my LWC"
"Set up Lightning Message Service for cross-component communication"

"Query all Accounts with more than 5 Contacts"
"Get Opportunities by Stage with total Amount per Stage"
"Find Contacts without Email addresses"
"Optimize this query: SELECT * FROM Account WHERE Name LIKE '%Corp%'"
"Generate a SOQL query to find duplicate Leads by Email"

"Run all Apex tests in my org and show coverage"
"Generate a test class for my AccountTriggerHandler"
"Create a bulk test with 251 records for trigger testing"
"Generate mock classes for HTTP callouts"
"Run tests for a specific class and show failures"

"Analyze this debug log for performance issues"
"Find governor limit violations in my log"
"What's causing this SOQL in loop error?"
"Show me how to fix this null pointer exception"
"Optimize my Apex for CPU time limits"

"Create a Connected App for API integration with JWT Bearer flow"
"Generate an External Client App for our mobile application with PKCE"
"Review my Connected Apps for security best practices"
"Migrate MyConnectedApp to an External Client App"

"Create a Named Credential for Stripe API with OAuth client credentials"
"Generate a REST callout service with retry and error handling"
"Create a Platform Event for order synchronization"
"Build a CDC subscriber trigger for Account changes"
"Set up an External Service from an OpenAPI spec"

"Create an Agentforce agent for customer support triage"
"Build a FAQ agent with topic-based routing"
"Generate an agent that calls my Apex service via Flow wrapper"
"Create a GenAiFunction for my @InvocableMethod Apex class"
"Build an agent action that calls the Stripe API"
"Generate a PromptTemplate for case summaries"

"Estimate Flex Credits for an Agentforce agent with 3 standard prompts and 5 actions"
"Compare low, medium, and enterprise monthly costs for this Agentforce + Data Cloud design"
"How much does Private Connect add to this Data Cloud estimate?"
"Show me the biggest cost drivers in this proposed agent architecture"
"Generate a public list-price Flex Credit estimate for this rollout"

"Set up a Data Cloud pipeline from CRM ingestion to unified profiles"
"Show me which Data Cloud connections and streams already exist in my org"
"Map this DLO to ssot__Individual__dlm and create an identity resolution ruleset"
"Create and publish a high-value customer segment in Data Cloud"
"Run a Data Cloud SQL query and describe the table before I build segment logic"
"Help me bootstrap the external sf data360 plugin required for the sf-datacloud family"

"Capture Builder traces for this agent test run and summarize routing issues"
"Analyze this Agentforce session trace for topic/action drift"
"Run trace-test against my agent and suggest Agent Script fixes"

"Create a JWT Bearer OAuth flow diagram"
"Generate an ERD for Account, Contact, Opportunity, and Case"
"Diagram our Salesforce to SAP integration flow"
"Create a system landscape diagram for our Sales Cloud implementation"
"Generate a role hierarchy diagram for our sales org"

"Deploy my Apex classes to sandbox with tests"
"Validate my metadata changes before deploying to production"

🤖 Supported Agentic Coding Tools

CLI Compatibility

All skills follow the Agent Skills open standard. Install with npx skills add for any supported agent:

npx skills add Jaganpro/sf-skills

Tool	Status	Install Method
Claude Code CLI	✅ Full Support	npx skills add or bash installer
OpenCode CLI	✅ Compatible	npx skills add
Codex CLI	✅ Compatible	npx skills add
Gemini CLI	✅ Compatible	npx skills add
Amp CLI	✅ Compatible	npx skills add or .claude/skills/
Droid CLI	✅ Compatible	npx skills add

🤝 Call for Volunteers! This repo is community-driven. We need testers on different CLIs — open an issue to get started.

sf-{capability}           # Cross-cutting (apex, flow, admin)
sf-ai-{name}              # AI features (agentforce, copilot)
sf-datacloud-{phase}      # Data Cloud family (connect, prepare, harmonize, segment, act, retrieve)
sf-cloud-{name}           # Clouds (sales, service)
sf-industry-{name}        # Industries (healthcare, finserv)
sf-industry-commoncore-{name}  # Industries Common Core (omnistudio)

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test locally: python3 tools/install.py --dry-run
5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

Contributors

Issues & Support

• GitHub Issues

License

MIT License - Copyright (c) 2024-2026 Jag Valaiyapathy