Copilot Skills — Salesforce

Custom GitHub Copilot Agent Skills & Coding Rulesets for Salesforce Development & Architecture

Turn GitHub Copilot into a Salesforce-aware coding assistant that follows platform best practices, governor limits, security rules, and the Well-Architected Framework — out of the box.

---

What Is This Repo?

This repository contains two GitHub Copilot Agent Skills and two comprehensive coding rulesets that supercharge Copilot with deep Salesforce platform knowledge:

Skills

Coding Rulesets (NEW)

These rulesets are tool-agnostic — they work with GitHub Copilot, Cursor, Claude Code, Windsurf, Cline, Roo Code, or any AI coding tool that supports custom instructions.

When added to a repository, the skills and rulesets teach Copilot to:

• Write bulkified, governor-limit-safe Apex with proper trigger frameworks, error handling, and test patterns
• Generate LWC components with correct decorators, wire adapters, and event communication
• Optimize SOQL/SOSL queries with selective filters, indexing strategies, and cursor-based pagination
• Design integration architectures using the right API pattern (REST, Bulk, Platform Events, CDC, Data 360)
• Apply security by default — WITH SECURITY_ENFORCED, with sharing, CRUD/FLS checks, OAuth flows
• Avoid common AI anti-patterns — 30+ documented mistakes that LLMs typically make in Salesforce code
• Follow the Well-Architected Framework — Trusted > Easy > Adaptable, in that priority order
• Produce architecture deliverables — solution design docs, ERDs (Mermaid), integration diagrams, decision matrices
• Pass PMD and ESLint — rulesets include comprehensive PMD rule mapping for Apex and ESLint config for LWC

---

Repository Structure

.github/
├── copilot-instructions.md                          # Entry point — tells Copilot which skills & rulesets to load
├── Blogs/
│   ├── salesforce-apex-coding-rules.md              # Comprehensive Apex coding ruleset (1,000+ lines)
│   └── salesforce-lwc-coding-rules.md               # Comprehensive LWC coding ruleset (1,500+ lines)
└── skills/
    ├── salesforce-developer/
    │   ├── SKILL.md                                 # Mandatory rules, naming conventions, anti-patterns
    │   ├── evaluations/
    │   │   └── eval-scenarios.json                  # Test scenarios to validate skill quality
    │   └── references/
    │       ├── apex-patterns.md                     # Triggers, async Apex, error handling, testing, JSON, wrappers
    │       ├── soql-optimization.md                 # Query selectivity, indexing, cursors, Big Objects, LDV
    │       ├── lwc-guide.md                         # LWC fundamentals, wire service, dynamic components
    │       ├── api-integration.md                   # REST services, Bulk API, Named Credentials, OAuth
    │       ├── formulas-validation.md               # Formula fields, validation rules, date/time functions
    │       ├── flows-automation.md                  # Record-triggered flows, screen flows, invocable Apex
    │       ├── security-sharing.md                  # Sharing keywords, CRUD/FLS, permission sets, encryption
    │       ├── deployment-devops.md                 # sf CLI, scratch orgs, CI/CD pipelines, packaging
    │       └── agentforce-ai.md                     # Agent actions, Prompt Builder, Models API, Platform Events, CDC
    ├── salesforce-architect-skill/
    │   ├── SKILL.md                                 # Well-Architected Framework, decision guides, anti-patterns
    │   ├── evaluations/
    │   │   └── eval-scenarios.json                  # Architecture evaluation scenarios
    │   └── references/
    │       ├── data-model-patterns.md               # Object design, sharing model, LDV, data skew
    │       ├── integration-patterns.md              # Pattern selection, API decision tree, middleware guidance
    │       └── well-architected-checklist.md        # Trusted/Easy/Adaptable validation checklist
    └── scripts/
        └── validate-skill.py                        # Validates SKILL.md files against the specification

---

How to Use

1. Add to Your Salesforce Project

Copy the .github/ folder into the root of any Salesforce DX project:

# Clone this repo
git clone https://github.com/SalesforceDiariesBySanket/Copilot-Skills-Salesforce.git

# Copy the .github folder to your project
cp -r Copilot-Skills-Salesforce/.github /path/to/your-salesforce-project/

2. Use the Coding Rulesets with Other AI Tools

The rulesets in Blogs/ are tool-agnostic. Drop them into your AI coding tool’s instruction layer:

3. Use with GitHub Copilot

Once the .github/ folder is in your project, GitHub Copilot Chat (in VS Code, Cursor, or GitHub.com) will automatically pick up the skills and apply Salesforce best practices to every response.

Try prompts like:

• “Write an Apex trigger on Account that syncs BillingCity to related Contacts”
• “Create an LWC component for searching Accounts with a datatable”
• “Design the integration architecture for connecting Salesforce to SAP”
• “Review this data model for anti-patterns”
• “Build a Batch Apex class to flag Contacts without email addresses”

4. Validate Skills

python .github/skills/scripts/validate-skill.py .github/skills/salesforce-developer
python .github/skills/scripts/validate-skill.py .github/skills/salesforce-architect-skill

---

What’s Inside the Coding Rulesets?

Apex Coding Rules (Blogs/salesforce-apex-coding-rules.md)

LWC Coding Rules (Blogs/salesforce-lwc-coding-rules.md)

---

How Skills & Rulesets Work Together

The copilot-instructions.md orchestrates everything with a mandatory workflow:

1. Read the relevant SKILL file(s) → architecture & developer patterns
2. Read the relevant RULESET file(s) → detailed coding standards from Blogs/
3. Read the matching REFERENCE file(s) → deep-dive guides for the specific task
4. Generate code that follows ALL rules from skills, rulesets, and references

This layered approach ensures Copilot always has the right level of detail — from high-level architecture decisions down to specific PMD rule compliance.

---

What Makes These Skills Different?

---

Compatibility

These skills and rulesets are designed for:

---

Validated As Of

February 2026 — Salesforce API v66.0 (Spring '26). Reference files are tagged with validation dates and should be reviewed against current release notes.

---

License

MIT