Optimizes Snowflake SQL query performance from provided query text.
$ npx skills add AltimateAI/data-engineering-skills --skill optimizing-query-text -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install AltimateAI/data-engineering-skills optimizing-query-text --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/AltimateAI/data-engineering-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/snowflake/optimizing-query-text .claude/skills/optimizing-query-text && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "optimizing-query-text" agent skill from https://github.com/AltimateAI/data-engineering-skills/tree/main/skills/snowflake/optimizing-query-text into .claude/skills/optimizing-query-text/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "optimizing-query-text", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/AltimateAI/data-engineering-skills/tree/main/skills/snowflake/optimizing-query-textType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add AltimateAI/data-engineering-skills --skill optimizing-query-text -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install AltimateAI/data-engineering-skills optimizing-query-text --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AltimateAI/data-engineering-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/snowflake/optimizing-query-text .agents/skills/optimizing-query-text && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "optimizing-query-text" agent skill from https://github.com/AltimateAI/data-engineering-skills/tree/main/skills/snowflake/optimizing-query-text into .agents/skills/optimizing-query-text/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "optimizing-query-text", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AltimateAI/data-engineering-skills --skill optimizing-query-text -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install AltimateAI/data-engineering-skills optimizing-query-text --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AltimateAI/data-engineering-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/snowflake/optimizing-query-text .cursor/skills/optimizing-query-text && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "optimizing-query-text" agent skill from https://github.com/AltimateAI/data-engineering-skills/tree/main/skills/snowflake/optimizing-query-text into .cursor/skills/optimizing-query-text/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "optimizing-query-text", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/AltimateAI/data-engineering-skills.git --path skills/snowflake/optimizing-query-text--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add AltimateAI/data-engineering-skills --skill optimizing-query-text -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install AltimateAI/data-engineering-skills optimizing-query-text --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AltimateAI/data-engineering-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/snowflake/optimizing-query-text .gemini/skills/optimizing-query-text && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "optimizing-query-text" agent skill from https://github.com/AltimateAI/data-engineering-skills/tree/main/skills/snowflake/optimizing-query-text into .gemini/skills/optimizing-query-text/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "optimizing-query-text", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install AltimateAI/data-engineering-skills optimizing-query-textInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add AltimateAI/data-engineering-skills --skill optimizing-query-text -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/AltimateAI/data-engineering-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/snowflake/optimizing-query-text .github/skills/optimizing-query-text && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "optimizing-query-text" agent skill from https://github.com/AltimateAI/data-engineering-skills/tree/main/skills/snowflake/optimizing-query-text into .github/skills/optimizing-query-text/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "optimizing-query-text", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AltimateAI/data-engineering-skills --skill optimizing-query-text -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install AltimateAI/data-engineering-skills optimizing-query-text --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AltimateAI/data-engineering-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/snowflake/optimizing-query-text .opencode/skills/optimizing-query-text && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "optimizing-query-text" agent skill from https://github.com/AltimateAI/data-engineering-skills/tree/main/skills/snowflake/optimizing-query-text into .opencode/skills/optimizing-query-text/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "optimizing-query-text", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
optimizing-query-textOptimizes Snowflake SQL query performance from provided query text.
Optimizing Query Text is an agent skill from AltimateAI/data-engineering-skills. Optimizes Snowflake SQL query performance from provided query text. Use when optimizing Snowflake SQL for: (1) User provides or pastes a SQL query and asks to optimize, tune, or improve it (2) Task mentions "slow query", "make faster", "improve performance", "optimize SQL", or "query tuning" (3) Reviewing SQL for performance anti-patterns (function on filter column, implicit joins, etc.) (4) User asks why a query is slow or how to speed it up
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Databases, covering SQL, Data warehousing and Query optimization. It works with SQL and Snowflake. The repository describes itself as: Skills related to Data Engineering Work for Claude Code. The licence is MIT.
4 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 705c68b. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Optimizing Query Text loads about 1.7k tokens when it runs. Until then it costs about 117 tokens; SKILL.md has 812 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from AltimateAI/data-engineering-skills at commit 705c68b, republished under its MIT licence (© AltimateAI). 812 words, ~1,679 tokens.
.claude/skills/optimizing-query-text/SKILL.md (or your agent's skills folder).Return ONLY the optimized SQL query. No markdown formatting, no explanations, no bullet points - just pure SQL that can be executed directly in Snowflake.
The optimized query MUST return IDENTICAL results to the original.
Before returning ANY optimization, verify:
ORDER BY exactly as writtenLIMIT N, keep LIMIT N. If no LIMIT, do NOT add one.If you cannot guarantee identical results, return the original query unchanged.
Problem: Functions on columns in WHERE clause prevent partition pruning and index usage.
| Original | Optimized | Why Safe |
|---|---|---|
WHERE DATE(ts) = '2024-01-01' | WHERE ts >= '2024-01-01' AND ts < '2024-01-02' | Equivalent range |
WHERE YEAR(dt) = 2024 | WHERE dt >= '2024-01-01' AND dt < '2025-01-01' | Equivalent range |
WHERE MONTH(dt) = 3 AND YEAR(dt) = 2024 | WHERE dt >= '2024-03-01' AND dt < '2024-04-01' | Equivalent range |
WHERE DATE(ts) >= '2024-01-01' AND DATE(ts) < '2024-02-01' | WHERE ts >= '2024-01-01' AND ts < '2024-02-01' | Same boundaries |
WHERE YEAR(dt) BETWEEN 1995 AND 1996 | WHERE dt >= '1995-01-01' AND dt < '1997-01-01' | Equivalent range |
| Pattern | Why Not |
|---|---|
WHERE YEAR(dt) IN (SELECT year FROM ...) | Dynamic values, cannot precompute range |
WHERE DATE(ts) = DATE(other_col) | Comparing two columns, both need function |
WHERE EXTRACT(DOW FROM dt) = 1 | Day-of-week has no contiguous range |
WHERE DATE_TRUNC('month', dt) = '2024-01-01' in GROUP BY | Needed for grouping logic |
SELECT YEAR(dt) AS yr ... GROUP BY YEAR(dt) | Function in SELECT/GROUP BY is fine, only filter matters |
Problem: Functions on JOIN columns prevent hash joins, forcing slower nested loop joins.
| Original | Optimized | Why Safe |
|---|---|---|
ON CAST(a.id AS VARCHAR) = CAST(b.id AS VARCHAR) | ON a.id = b.id | If both are same type (e.g., INTEGER) |
ON UPPER(a.code) = UPPER(b.code) | ON a.code = b.code | If data is already consistently cased |
ON TRIM(a.name) = TRIM(b.name) | ON a.name = b.name | If data has no leading/trailing spaces |
| Pattern | Why Not |
|---|---|
ON CAST(a.id AS VARCHAR) = b.string_id | Types genuinely differ, CAST required |
ON DATE(a.timestamp) = b.date_col | Different granularity, DATE() required |
ON UPPER(a.code) = b.code | If b.code might have different case |
ON a.id = b.id + 1 | Arithmetic transformation, cannot remove |
Problem: NOT IN has poor performance and unexpected NULL behavior.
| Original | Optimized | Why Safe |
|---|---|---|
WHERE id NOT IN (SELECT id FROM t WHERE ...) | WHERE NOT EXISTS (SELECT 1 FROM t WHERE t.id = main.id AND ...) | Equivalent when subquery column is NOT NULL |
WHERE id NOT IN (SELECT id FROM t) where id has NOT NULL constraint | WHERE NOT EXISTS (SELECT 1 FROM t WHERE t.id = main.id) | NOT NULL guarantees equivalence |
| Pattern | Why Not |
|---|---|
WHERE id NOT IN (SELECT nullable_col FROM t) | If subquery returns NULL, NOT IN returns no rows; NOT EXISTS doesn't |
WHERE (a, b) NOT IN (SELECT x, y FROM t) | Multi-column NOT IN has complex NULL semantics |
Key Rule: Only convert NOT IN to NOT EXISTS if you can verify the subquery column cannot be NULL.
Problem: Same subquery executed multiple times causes redundant scans.
| Original | Optimized |
|---|---|
| Subquery appears 2+ times identically | Extract to CTE, reference CTE multiple times |
| Same aggregation used in multiple places | Compute once in CTE |
| Pattern | Why Not |
|---|---|
| Correlated subquery (references outer table) | Each execution is different, cannot cache |
| Subqueries with different filters | Not actually the same subquery |
| Subquery in SELECT that depends on current row | Correlation prevents extraction |
Problem: Comma-separated tables in FROM clause are harder to read and optimize.
Convert FROM a, b, c WHERE a.id = b.id AND b.id = c.id to explicit JOIN syntax.
This is always safe - just restructuring, no semantic change.
SUM(SUM(x)) OVER(...) or similar nested aggregates© AltimateAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/snowflake/optimizing-query-text of AltimateAI/data-engineering-skills.
Open the folder on GitHubat commit 705c68b
Optimizing Query Text next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Optimizing Query Text this skillAltimateAI/data-engineering-skills | 127 | — | ~1.7k | Automated safety check: Pass | MIT | |
| Snowflake Developmentsickn33/agentic-awesome-skills | 47k | 2 repos | ~2.1k | Automated safety check: Pass | MIT | |
| Snowflake Developmentalirezarezvani/claude-skills | 28k | — | ~3.2k | Automated safety check: Pass | MIT | |
| Uipath Process MiningUiPath/skills | 166 | — | ~4.3k | Automated safety check: Notes | MIT | |
| Snowflake Data EngineeringMindrally/skills | 267 | — | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| Analyzing Dataastronomer/agents | 450 | — | ~1.3k | Automated safety check: Pass | Apache-2.0 |
sickn33/agentic-awesome-skills
Comprehensive Snowflake development assistant covering SQL best practices, data pipeline design (Dynamic Tables, Streams, Tasks, Snowpipe), Cortex AI functions, Cortex Agents, Snowpark Python, dbt…
alirezarezvani/claude-skills
A skill your agent uses when writing Snowflake SQL, building data pipelines with Dynamic Tables or Streams/Tasks, using Cortex AI functions, creating Cortex Agents, writing Snowpark Python…
UiPath/skills
UiPath Process Mining via uip pm — build and operate a process app end-to-end from a CSV / event log: templates, data mapping, upload, ingest, the dbt (Snowflake) transformation layer, publish, and…
Mindrally/skills
Best practices for Snowflake SQL, semi-structured data, and data pipelines built with Dynamic Tables, Streams, Tasks, and Snowpipe.
astronomer/agents
Queries the data warehouse with SQL and answers business questions about data.
sidequery/sidemantic
Build, validate, and manage semantic models using Sidemantic.
AltimateAI/data-engineering-skills
Delegates dbt and warehouse tasks such as lineage, migrations and cost attribution to the altimate-code CLI agent and relays its answer back.
AltimateAI/data-engineering-skills
Creates or modifies dbt models in line with a project's own conventions, then runs dbt build and dbt show to check the output instead of stopping at compile.
AltimateAI/data-engineering-skills
Walks through fixing dbt compilation, database and test errors: read the full error, check upstream models, apply a fix, then verify with dbt build and a data preview.
AltimateAI/data-engineering-skills
Helps choose an incremental strategy, design a reliable unique_key and debug failing dbt incremental models, and says when a plain table is the better choice.
AltimateAI/data-engineering-skills
Writes model and column descriptions in dbt schema.yml files, matching the project's existing documentation style and recording grain, business rules and caveats.
AltimateAI/data-engineering-skills
Ranks the costliest, slowest or heaviest-scanning Snowflake queries from query history and suggests how to optimize them.
Categories
Optimizes Snowflake SQL query performance from provided query text. Optimizing Query Text is an agent skill from AltimateAI/data-engineering-skills. Optimizes Snowflake SQL query performance from provided query text.
Optimizing Query Text fits situations like: optimizing Snowflake SQL for:; pastes a SQL query and asks to optimize; task mentions slow query; improve performance.
Run `npx skills add AltimateAI/data-engineering-skills --skill optimizing-query-text -a claude-code`. Or copy the skill folder (skills/snowflake/optimizing-query-text in AltimateAI/data-engineering-skills) into .claude/skills/optimizing-query-text in your project. Claude Code loads it when a task matches its description.
Run `npx skills add AltimateAI/data-engineering-skills --skill optimizing-query-text -a codex`. Or copy the skill folder (skills/snowflake/optimizing-query-text in AltimateAI/data-engineering-skills) into .agents/skills/optimizing-query-text in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AltimateAI/data-engineering-skills --skill optimizing-query-text -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/optimizing-query-text, .gemini/skills/optimizing-query-text, .github/skills/optimizing-query-text and .opencode/skills/optimizing-query-text in your project.
SKILL.md names no scripts, command-line tools or credentials: Optimizing Query Text is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Optimizing Query Text is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Optimizing Query Text: Snowflake Development (sickn33/agentic-awesome-skills, 47k stars), Snowflake Development (alirezarezvani/claude-skills, 28k stars), Uipath Process Mining (UiPath/skills, 166 stars) and Snowflake Data Engineering (Mindrally/skills, 267 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
AltimateAI (a GitHub organization) maintains it in AltimateAI/data-engineering-skills, which has 127 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 1, 2026.
Source: AltimateAI/data-engineering-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.
