afv-library/skills/platform-soql-query/README.md

1.7 KiB

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

  • 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