Agent skill

SQL Expert

by aiskillstore in aiskillstore/marketplace

Write, optimize, and debug T-SQL queries for Microsoft SQL Server.

No licenceAuto-check passedDatabases

Install SQL Expert

skills CLI
$ npx skills add aiskillstore/marketplace --skill sql-expert -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aiskillstore/marketplace sql-expert --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aiskillstore/marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hmohamed01/sql-expert .claude/skills/sql-expert && rm -rf skills-src

Use ~/.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/

Facts

Skill name
sql-expert
GitHub stars
430
Token cost
~720 tokens
SKILL.md length
204 words
Files
8 (incl. references)
Skills in repo
1,108
Repo updated
First seen
Licence
None found

At a glance

Write, optimize, and debug T-SQL queries for Microsoft SQL Server.

  • Works in 6 steps: Gather context first - Ask about table… → Write for performance - Produce queries… → Explain reasoning - Describe why a… → …
  • Working with SQL Server
  • SKILL.md covers Instructions, Core Capabilities, Quick Reference and Additional References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SQL Expert is an agent skill from aiskillstore/marketplace. Write, optimize, and debug T-SQL queries for Microsoft SQL Server. Covers CTEs, window functions, PIVOT, MERGE, APPLY operators, execution plan analysis, indexing strategies, and stored procedures. Use when working with SQL Server, T-SQL scripts, .sql files, stored procedures, query optimization, or database performance tuning.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `evaluation.json`, `references/data-types.md` and `references/patterns.md`).

It sits in Databases, covering SQL and Query optimization. It works with SQL and Microsoft SQL Server. The repository describes itself as: Security-audited skills for Claude, Codex & Claude Code. One-click install, quality verified.

When your agent uses it

  • Working with SQL Server
  • Stored procedures
  • Query optimization
  • Database performance tuning

Example prompts

  • “/sql-expert”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Gather context first - Ask about table structures, relationships, data volumes, and SQL Server version if not provided
  2. Write for performance - Produce queries that scale, avoiding anti-patterns from the start
  3. Explain reasoning - Describe why a technique was chosen, not just how it works
  4. Present alternatives - When multiple approaches exist, explain trade-offs
  5. Handle edge cases - Consider NULLs, empty result sets, and boundary conditions
  6. Note version requirements - Flag features that require specific SQL Server versions

What it can do on your machine

Read from SKILL.md and the folder at commit ad8daf7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    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.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are sql).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SQL Expert loads about 720 tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 85 tokens; SKILL.md has 204 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~85
When it runs · the whole SKILL.md, loaded when a task matches
~720
With references · SKILL.md plus every file in references/, read only if the agent opens them
~13k

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.

Safety

Auto-check passed

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.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 204 words (~720 tokens).

“Expert assistance for Microsoft SQL Server and T-SQL development.”

— opening of SKILL.md by aiskillstore
name
sql-expert

Read the full SKILL.md on GitHub

Files

SKILL.md and 7 other files (references) in skills/hmohamed01/sql-expert of aiskillstore/marketplace.

  • SKILL.md
  • evaluation.json
  • references/data-types.md
  • references/patterns.md
  • references/performance.md
  • references/security.md
  • references/transactions.md
  • skill-report.json

Open the folder on GitHubat commit ad8daf7

Compare with similar skills

SQL Expert 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.

SQL Expert compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SQL Expert this skillaiskillstore/marketplace430—~720Automated safety check: PassNone
SQL ProJeffallan/claude-skills12k—~1.3kAutomated safety check: PassMIT
SQL Optimizationgithub/awesome-copilot40k2 repos~2.3kAutomated safety check: PassMIT
Optimizing SQLancoleman/ai-design-components526—~3kAutomated safety check: PassMIT
Agent SQL Proxiaoyuge886/aigc198—~315Automated safety check: PassMIT
SQL Optimizationtotvs/engpro-advpl-tlpp-skills143—~1.2kAutomated safety check: PassMIT

Similar skills

  • SQL Pro

    Jeffallan/claude-skills

    Optimizes SQL queries and designs schemas using CTEs, window functions, covering indexes and EXPLAIN ANALYZE, with notes on dialect differences between major databases.

    12k GitHub stars~1.3k tokensUpdated 4 days ago
    DatabasesAuto-check passed
  • SQL Optimization

    github/awesome-copilot

    Official

    Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server…

    40k GitHub starsUsed in 2 repos~2.3k tokens
    DatabasesAuto-check passed
  • Optimizing SQL

    ancoleman/ai-design-components

    Optimize SQL query performance through EXPLAIN analysis, indexing strategies, and query rewriting for PostgreSQL, MySQL, and SQL Server.

    526 GitHub stars~3k tokensUpdated 10 mo ago
    DatabasesAuto-check passed
  • Agent SQL Pro

    xiaoyuge886/aigc

    Expert SQL developer specializing in complex query optimization, database design, and performance tuning across PostgreSQL, MySQL, SQL Server, and Oracle.

    198 GitHub stars~315 tokensUpdated 2 mo ago
    DatabasesAuto-check passed
  • SQL Optimization

    totvs/engpro-advpl-tlpp-skills

    Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across SQL databases (PostgreSQL, SQL Server, Oracle).

    143 GitHub stars~1.2k tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • SQL Optimization Patterns

    ynulihao/AgentSkillOS

    Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries.

    617 GitHub starsUsed in 11 repos~3.3k tokens
    DatabasesAuto-check passed

More from aiskillstore/marketplace

All 1,108 skills in this repo
  • Code Stats

    aiskillstore/marketplace

    Analyze codebase with tokei (fast line counts by language) and difft (semantic AST-aware diffs).

    430 GitHub starsUsed in 2 repos~697 tokens
    Auto-check: notes
  • File Search

    aiskillstore/marketplace

    Modern file and content search using fd, ripgrep (rg), and fzf.

    430 GitHub starsUsed in 2 repos~598 tokens
    Auto-check: notes
  • Data Processing

    aiskillstore/marketplace

    Process JSON with jq and YAML/TOML with yq. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 1 repo~720 tokens
    Auto-check: notes
  • Doc Scanner

    aiskillstore/marketplace

    Scans for project documentation files (AGENTS.md, CLAUDE.md, GEMINI.md, COPILOT.md, CURSOR.md, WARP.md, and 15+ other formats) and synthesizes guidance.

    430 GitHub starsUsed in 1 repo~644 tokens
    Auto-check: notes
  • Find Replace

    aiskillstore/marketplace

    Modern find-and-replace using sd (simpler than sed) and batch replacement patterns.

    430 GitHub starsUsed in 1 repo~527 tokens
    Auto-check: notes
  • Investigating Codebases

    aiskillstore/marketplace

    Automatically activated when user asks how something works, wants to understand unfamiliar code, needs to explore a new codebase, or asks questions like "where is X implemented?", "how does Y…

    430 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: notes

Categories

Questions about SQL Expert

What does SQL Expert do?

Write, optimize, and debug T-SQL queries for Microsoft SQL Server. SQL Expert is an agent skill from aiskillstore/marketplace. Write, optimize, and debug T-SQL queries for Microsoft SQL Server.

When should I use SQL Expert?

SQL Expert fits situations like: working with SQL Server; stored procedures; query optimization; database performance tuning.

How do I install SQL Expert in Claude Code?

Run `npx skills add aiskillstore/marketplace --skill sql-expert -a claude-code`. Or copy the skill folder (skills/hmohamed01/sql-expert in aiskillstore/marketplace) into .claude/skills/sql-expert in your project. Claude Code loads it when a task matches its description.

How do I install SQL Expert in Codex?

Run `npx skills add aiskillstore/marketplace --skill sql-expert -a codex`. Or copy the skill folder (skills/hmohamed01/sql-expert in aiskillstore/marketplace) into .agents/skills/sql-expert in your project. Codex loads it when a task matches its description.

Can I use SQL Expert in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aiskillstore/marketplace --skill sql-expert -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sql-expert, .gemini/skills/sql-expert, .github/skills/sql-expert and .opencode/skills/sql-expert in your project.

What does SQL Expert need to run?

SKILL.md names no scripts, command-line tools or credentials: SQL Expert is instructions for the agent only.

Does SQL Expert access the network?

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.

Is SQL Expert safe to install?

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.

What licence does SQL Expert use?

No licence was found for SQL Expert or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does SQL Expert use?

About 720 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 12k tokens, read only when the agent opens those files.

What are the alternatives to SQL Expert?

Skills that share tags, products or a category with SQL Expert: SQL Pro (Jeffallan/claude-skills, 12k stars), SQL Optimization (github/awesome-copilot, 40k stars), Optimizing SQL (ancoleman/ai-design-components, 526 stars) and Agent SQL Pro (xiaoyuge886/aigc, 198 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SQL Expert?

aiskillstore (a GitHub organization) maintains it in aiskillstore/marketplace, which has 430 GitHub stars. The repository holds 1,108 skills in this directory. The repository was last updated on October 7, 2026.

Source: aiskillstore/marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.