Agent skill

SQL Expert

by aiskillstore in aiskillstore/marketplace

Expert SQL query writing, optimization, and database schema design with support for PostgreSQL, MySQL, SQLite, and 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/autumnsgrove/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
~3.4k tokens
SKILL.md length
746 words
Files
12 (incl. scripts, references)
Skills in repo
1,085
Repo updated
First seen
Licence
None found

At a glance

Expert SQL query writing, optimization, and database schema design with support for PostgreSQL, MySQL, SQLite, and SQL Server.

  • Works in 10 steps: Always use parameterized queries to… → Use transactions for related operations… → Add appropriate constraints (PRIMARY… → …
  • Working with databases for:
  • SKILL.md covers Core Capabilities, Supported Database Systems, Query Writing and Query Optimization, plus 7 more sections
  • Runs Python scripts from its folder; calls pip

What it does

SQL Expert is an agent skill from aiskillstore/marketplace. Expert SQL query writing, optimization, and database schema design with support for PostgreSQL, MySQL, SQLite, and SQL Server. Use when working with databases for: (1) Writing complex SQL queries with joins, subqueries, and window functions, (2) Optimizing slow queries and analyzing execution plans, (3) Designing database schemas with proper normalization, (4) Creating indexes and improving query performance, (5) Writing migrations and handling schema changes, (6) Debugging SQL errors and query issues

Its SKILL.md is about 3.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including scripts and reference files (for example `README.md`, `references/advanced-patterns.md` and `references/best-practices.md`).

It sits in Databases, covering SQL, Database schema design and Query optimization. It works with SQL, MySQL, PostgreSQL and SQLite. 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 databases for:
  • Writing complex SQL queries with joins
  • Window functions
  • Optimizing slow queries and analyzing execution plans

Example prompts

  • “/sql-expert”

Requirements

  • Python 3

Workflow steps

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

  1. Always use parameterized queries to prevent SQL injection
  2. Use transactions for related operations to ensure atomicity
  3. Add appropriate constraints (PRIMARY KEY, FOREIGN KEY, NOT NULL, CHECK)
  4. Include timestamps (created_at, updated_at) on tables
  5. Use meaningful names for tables and columns
  6. Avoid SELECT * - specify only needed columns
  7. Index foreign keys for join performance
  8. Use VARCHAR instead of CHAR for variable-length strings
  9. Handle NULL values properly with IS NULL / IS NOT NULL
  10. Use appropriate data types (DECIMAL for money, not FLOAT)

What it can do on your machine

Read from SKILL.md and the folder at commit 4ac52da. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    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 3.4k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 129 tokens; SKILL.md has 746 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

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

“Expert guidance for writing, optimizing, and managing SQL databases across PostgreSQL, MySQL, SQLite, and SQL Server.”

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

Read the full SKILL.md on GitHub

Files

SKILL.md and 11 other files (scripts, references) in skills/autumnsgrove/sql-expert of aiskillstore/marketplace.

  • SKILL.md
  • README.md
  • examples/complex_queries.sql
  • examples/migrations.sql
  • examples/schema_examples.sql
  • references/advanced-patterns.md
  • references/best-practices.md
  • references/common-pitfalls.md
  • references/indexes-performance.md
  • references/query-optimization.md
  • scripts/sql_helper.py
  • skill-report.json

Open the folder on GitHubat commit 4ac52da

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—~3.4kAutomated safety check: PassNone
SQL ProJeffallan/claude-skills12k—~1.3kAutomated safety check: PassMIT
Agent SQL Proxiaoyuge886/aigc198—~315Automated safety check: PassMIT
SQL ToolkitLeoYeAI/openclaw-master-skills2.2k—~3kAutomated safety check: PassMIT
Golang Databaseunxed/f42402 repos~2.9kAutomated safety check: PassMIT
SQL Optimizationgithub/awesome-copilot40k2 repos~2.3kAutomated 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 3 days 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 Toolkit

    LeoYeAI/openclaw-master-skills

    Query, design, migrate, and optimize SQL databases. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~3k tokensUpdated 2 mo ago
    DatabasesAuto-check passed
  • Comprehensive guide for Go database access — parameterized queries, struct scanning, NULLable columns, transactions, isolation levels, SELECT FOR UPDATE, connection pool, batch processing, context…

    240 GitHub starsUsed in 2 repos~2.9k tokens
    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

More from aiskillstore/marketplace

All 1,085 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
  • 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
  • File Search

    aiskillstore/marketplace

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

    430 GitHub starsUsed in 1 repo~598 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?

Expert SQL query writing, optimization, and database schema design with support for PostgreSQL, MySQL, SQLite, and SQL Server. SQL Expert is an agent skill from aiskillstore/marketplace. Expert SQL query writing, optimization, and database schema design with support for PostgreSQL, MySQL, SQLite, and SQL Server.

When should I use SQL Expert?

SQL Expert fits situations like: working with databases for:; writing complex SQL queries with joins; window functions; optimizing slow queries and analyzing execution plans.

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/autumnsgrove/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/autumnsgrove/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?

Going by SKILL.md and its folder, SQL Expert needs Python for the scripts in its folder and the command-line tools its instructions call (pip). Our summary lists: Python 3.

Does SQL Expert access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

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 3.4k tokens (SKILL.md is roughly 14k 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 7.8k 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), Agent SQL Pro (xiaoyuge886/aigc, 198 stars), SQL Toolkit (LeoYeAI/openclaw-master-skills, 2.2k stars) and Golang Database (unxed/f4, 240 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,085 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.