sf-soql

Convert natural language requests into optimized, secure SOQL queries for Salesforce.

6|Updated Dec 20, 2023
One-click install
npx skills add https://github.com/ronitnuguru/Package-Visualizer --skill sf-soql-ronitnuguru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sf-soql
Source: https://github.com/ronitnuguru/Package-Visualizer/tree/main/.cursor/skills/sf-soql
Command: npx skills add https://github.com/ronitnuguru/Package-Visualizer --skill sf-soql-ronitnuguru

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Advanced SOQL query generation from natural language, enabling developers to translate business needs into efficient, secure Salesforce queries that respect governor limits and FLS/sharing.

Core Features & Use Cases

  • Natural Language → SOQL: Convert plain English requests to optimized Salesforce queries.
  • Relationship Traversals & Aggregates: Support parent-child and group-by patterns for reporting.
  • Performance & Security Guidance: Emphasize indexed fields, security enforcement, and governor-limit considerations.
  • Use Case Examples: Build dynamic reports, dashboards, and data-extraction queries from plain language prompts.

Quick Start

Ask it to generate a sample SOQL query from a user request, such as "Show me accounts created this year with name and owner details, limit 50".

Frequently Asked Questions about sf-soql

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

FAQPage Schema
How do I generate Salesforce SOQL queries from natural language?

To generate SOQL queries from natural language, input plain English requests describing your desired Salesforce data extraction. The query generator translates these requests into optimized SOQL syntax, handling relationship traversals and aggregates for dynamic reporting.

Does natural language to SOQL conversion respect Salesforce sharing rules and FLS?

Natural language to SOQL conversion enforces Field Level Security (FLS) and respects Salesforce sharing rules. It ensures generated queries satisfy security requirements by operating within user permissions and data visibility constraints.

Can I use SOQL queries for parent-child relationship traversals and aggregate reporting?

You can use SOQL queries for parent-child relationship traversals and aggregate functions. The generation process supports group-by patterns and relationship queries specifically for building dashboards and dynamic reports within Salesforce orgs.

What is the best way to optimize SOQL queries for Salesforce governor limits?

The best way to optimize SOQL queries for Salesforce governor limits is to use indexed fields where possible and incorporate query plan analysis. This approach ensures performance requirements are met during data extraction.

How to write SOQL queries for Salesforce dashboards and data extraction?

To write SOQL queries for Salesforce dashboards and data extraction, provide a plain language prompt like 'Show me accounts created this year with name and owner details, limit 50'. The tool outputs the corresponding optimized SOQL query.

Why does my SOQL query hit governor limits in Salesforce?

SOQL queries hit Salesforce governor limits when they fail to use indexed fields or lack query plan analysis. Generating queries with governor-limit awareness ensures performance requirements are satisfied during data extraction.