platform-soql-query

Generate, optimize, and validate Salesforce SOQL and SOSL queries.

Updated Jun 17, 2026
One-click install
npx skills add https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG --skill platform-soql-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: platform-soql-query
Source: https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG/tree/main/.agents/skills/platform-soql-query
Command: npx skills add https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG --skill platform-soql-query

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps Salesforce developers turn plain-English data needs into correct, performant SOQL or SOSL while avoiding common query mistakes that hurt security, readability, or governor-limit safety.

Core Features & Use Cases

  • Natural-language query generation: Convert business requests into executable SOQL or SOSL.
  • Query optimization and review: Improve selectivity, field usage, LIMIT strategy, and relationship traversal depth.
  • Performance and safety guidance: Evaluate query plans, security modes, aggregate patterns, and Apex field coverage before use.
  • Practical scenarios: Build child-parent and parent-child queries, create aggregate summaries, diagnose slow queries, and prepare queries for Apex selectors or Salesforce CLI execution.

Quick Start

Ask the skill to convert your Salesforce data requirement into an optimized SOQL query and explain any performance, security, or governor-limit tradeoffs.

Frequently Asked Questions about platform-soql-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert natural language into optimized SOQL queries for Salesforce?

To convert natural language into optimized SOQL, translate business requests into executable queries while evaluating selectivity, field usage, and LIMIT strategy. This ensures production-safe data retrieval without hitting governor limits.

What is the best way to avoid Salesforce governor limits when running SOQL queries?

Avoid Salesforce governor limits by validating SOQL selectivity, analyzing query plans, and applying aggregate patterns. Designing queries with governor-limit awareness prevents bulk operation failures in Apex.

Can I traverse parent-child and child-parent relationships in a single SOQL query?

You can traverse both parent-child and child-parent relationships in SOQL by generating relationship queries. Optimizing relationship traversal depth prevents performance degradation and excessive field coverage issues.

Does this approach work with Apex selector patterns and Salesforce CLI execution?

This approach works with Apex selector patterns and Salesforce CLI execution by preparing queries specifically for those environments. It enforces security modes and field coverage before execution to ensure safe integration.

Why is my SOQL query slow and how do I analyze the query plan?

Your SOQL query may be slow due to poor selectivity or unoptimized relationship traversal. Analyze the query plan to evaluate performance tradeoffs, adjust LIMIT strategy, and enforce security modes for safer execution.

When should I use SOSL instead of SOQL for Salesforce data retrieval?

Use SOSL instead of SOQL when you need to search text across multiple objects simultaneously. Generating SOSL provides targeted text search results, whereas SOQL is better for structured relationship traversals and aggregates.