afv-library/skills/platform-soql-query

platform-soql-query

Salesforce SOQL query generation, optimization, and analysis skill with 100-point scoring. Convert natural language into performant SOQL and validate queries for security, selectivity, and governor-limit awareness.

Features

• Natural Language to SOQL: Convert requests into executable queries
• Query Optimization: Improve selectivity, LIMIT usage, and field selection
• Relationship Queries: Parent-child, child-parent, and polymorphic patterns
• Security Guidance: WITH USER_MODE, WITH SECURITY_ENFORCED, and Apex-safe usage
• 100-Point Scoring: Performance, correctness, security, and readability checks

Quick Start

1. Invoke the skill

Skill: platform-soql-query
Request: "Find Accounts with open Opportunities created this quarter"

2. Typical use cases

• Generate SOQL from plain-English requirements
• Optimize slow or non-selective queries
• Build aggregates and relationship queries
• Validate queries before using them in Apex or CLI workflows

Documentation

• SKILL.md - Core workflow and optimization guidance
• references/query-optimization.md - Selectivity and performance tuning
• references/soql-syntax-reference.md - Syntax, relationships, and aggregates
• references/selector-patterns.md - Reusable Apex selector patterns
• references/cli-commands.md - sf CLI query execution examples

Related Skills

• platform-data-manage - For data creation/import/export workflows
• platform-apex-generate - For inline SOQL inside Apex code
• platform-apex-test-run - For validating query behavior in tests