Platform Soql Query

This is your SOQL authoring and optimization companion for Salesforce. It generates queries from natural language, handles relationship traversals and aggregates, and scores output on a 100-point scale with specific optimization feedback. The skill knows when to use child-to-parent vs subqueries, how to write selective filters, and catches common anti-patterns like querying in loops. It won't execute queries itself but hands off to platform-data-manage when you need results. The reference files cover syntax, indexing strategy, and selector patterns, plus it includes validation scripts that run query plan analysis after you save .soql files. Best for writing new queries or fixing slow ones, not for bulk operations or broader Apex logic.

skills.sh installs: 7.1K
GitHub stars: 1.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add forcedotcom/sf-skills --skill platform-soql-query --agent claude-code

Installs into .claude/skills of the current project.

Files

platform-soql-query: Salesforce SOQL Query Expert

Use this skill when the user needs SOQL/SOSL authoring or optimization: natural-language-to-query generation, relationship queries, aggregates, query-plan analysis, and performance/safety improvements for Salesforce queries.

When This Skill Owns the Task

Use platform-soql-query when the work involves:

.soql files
query generation from natural language
relationship queries and aggregate queries
query optimization and selectivity analysis
SOQL/SOSL syntax and governor-aware design

Delegate elsewhere when the user is:

performing bulk data operations → platform-data-manage
embedding query logic inside broader Apex implementation → platform-apex-generate
debugging via logs rather than query shape → platform-apex-logs-debug