Agent skill

SQL Explainer

by zhuyansen in zhuyansen/agent-skills-hub

Explain what a SQL query does in plain language and point out joins that may multiply rows.

MITAuto-check passedDatabases

Install SQL Explainer

skills CLI
$ npx skills add zhuyansen/agent-skills-hub --skill sql-explainer -a claude-code

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

GitHub CLI
$ gh skill install zhuyansen/agent-skills-hub sql-explainer --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/zhuyansen/agent-skills-hub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ops/skillmgr-runs/in/input/library/sql-explainer .claude/skills/sql-explainer && 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-explainer
GitHub stars
413
Token cost
~191 tokens
SKILL.md length
117 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Explain what a SQL query does in plain language and point out joins that may multiply rows.

  • Works in 3 steps: Read the input the user points to. If… → Do the task described above, step by… → Show the result, then a short list of…
  • Tasks that involve SQL
  • SKILL.md covers When to use, Steps and Notes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SQL Explainer is an agent skill from zhuyansen/agent-skills-hub. Explain what a SQL query does in plain language and point out joins that may multiply rows.

Its SKILL.md is about 190 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 and Plain language and style rules. It works with SQL. The repository describes itself as: Discover and compare open-source Agent Skills, tools & MCP servers — with quality scoring, trending analysis, and automated GitHub sync. The licence is MIT.

When your agent uses it

  • Tasks that involve SQL
  • Tasks that involve Plain language and style rules

Example prompts

  • “/sql-explainer”

Workflow steps

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

  1. Read the input the user points to. If none is given, ask for the file or text.
  2. Do the task described above, step by step, and keep the user's own wording where it matters.
  3. Show the result, then a short list of what you changed or found, so the user can check it.

What it can do on your machine

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

    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 Explainer loads about 191 tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 117 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~191

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

The full file from zhuyansen/agent-skills-hub at commit 2862275, republished under its MIT licence (© zhuyansen). 117 words, ~191 tokens.

Download SKILL.mdSave it as .claude/skills/sql-explainer/SKILL.md (or your agent's skills folder).
name
sql-explainer
description
Explain what a SQL query does in plain language and point out joins that may multiply rows.

Sql Explainer

Explain what a SQL query does in plain language and point out joins that may multiply rows.

When to use

Use this skill when the user asks for it by name or describes this task. Do not use it for unrelated work.

Steps

  1. Read the input the user points to. If none is given, ask for the file or text.
  2. Do the task described above, step by step, and keep the user's own wording where it matters.
  3. Show the result, then a short list of what you changed or found, so the user can check it.

Notes

  • Keep changes small and reversible.
  • Say plainly when the input is incomplete instead of guessing.

© zhuyansen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in ops/skillmgr-runs/in/input/library/sql-explainer of zhuyansen/agent-skills-hub.

Open the folder on GitHubat commit 2862275

Compare with similar skills

SQL Explainer 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 Explainer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SQL Explainer this skillzhuyansen/agent-skills-hub413—~191Automated safety check: PassMIT
SQL To Business Logicnimrodfisher/data-analytics-skills470—~636Automated safety check: PassMIT
SQL Explainermergisi/awesome-openclaw-agents4k—~300Automated safety check: PassMIT
SQL Translatorcriptogus/agent-evolve-network288—~735Automated safety check: PassCC-BY-SA-4.0
511 Frameworks Micronaut Jdbcjabrena/plinth447—~872Automated safety check: PassApache-2.0
704 Technologies SQLjabrena/plinth447—~1kAutomated safety check: PassApache-2.0

Similar skills

  • SQL To Business Logic

    nimrodfisher/data-analytics-skills

    Translate SQL queries into plain language business logic. An agent skill from nimrodfisher/data-analytics-skills.

    470 GitHub stars~636 tokensUpdated 15 days ago
    DatabasesAuto-check passed
  • SQL Explainer

    mergisi/awesome-openclaw-agents

    Paste a SQL query and get a plain English explanation of what it does.

    4k GitHub stars~300 tokensUpdated 13 days ago
    DatabasesAuto-check passed
  • SQL Translator

    criptogus/agent-evolve-network

    Translates a plain-English question into a single, safe, read-only SQL query against a known schema, with assumptions made explicit.

    288 GitHub stars~735 tokensUpdated yesterday
    DatabasesAuto-check passed
  • A skill your agent uses when you need programmatic JDBC in Micronaut — pooled DataSource, parameterized SQL, io.micronaut.transaction.annotation.Transactional, batching, and domain exception…

    447 GitHub stars~872 tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • 704 Technologies SQL

    jabrena/plinth

    A skill your agent uses when you need framework-agnostic SQL guidance — schema naming, relational table design, query readability, indexes, transactions, database security, migrations, testing, and…

    447 GitHub stars~1k tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • SQL Query Explainer

    mohitagw15856/pm-claude-skills

    Explains, optimises, writes, and documents SQL queries. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~1.6k tokensUpdated today
    DatabasesAuto-check passed

More from zhuyansen/agent-skills-hub

All 21 skills in this repo
  • AgentSkillsHub Skill Finder

    zhuyansen/agent-skills-hub

    Searches a locally cached, security-graded catalog of agent skills and MCP servers, and returns install commands after checking each one's grade.

    413 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Accessibility Check

    zhuyansen/agent-skills-hub

    Check an HTML page for missing alt text, low contrast, unlabeled inputs and heading order.

    413 GitHub stars~193 tokensUpdated today
    Auto-check passed
  • API Docs Writer

    zhuyansen/agent-skills-hub

    Write reference documentation for an HTTP endpoint from its handler code: parameters, responses, errors.

    413 GitHub stars~198 tokensUpdated today
    Auto-check passed
  • Changelog Writer

    zhuyansen/agent-skills-hub

    Write a CHANGELOG entry from the commits since the last tag, grouped into added, changed and fixed.

    413 GitHub stars~196 tokensUpdated today
    Auto-check passed
  • Cron Explainer

    zhuyansen/agent-skills-hub

    Explain a cron expression in words and list its next five run times.

    413 GitHub stars~180 tokensUpdated today
    Auto-check passed
  • CSV Cleaner

    zhuyansen/agent-skills-hub

    Clean messy CSV files: fix headers, trim whitespace, normalise dates and drop duplicate rows before analysis.

    413 GitHub stars~199 tokensUpdated today
    Auto-check passed

Works with

Questions about SQL Explainer

What does SQL Explainer do?

Explain what a SQL query does in plain language and point out joins that may multiply rows. SQL Explainer is an agent skill from zhuyansen/agent-skills-hub. Explain what a SQL query does in plain language and point out joins that may multiply rows.

When should I use SQL Explainer?

SQL Explainer fits situations like: tasks that involve SQL; tasks that involve Plain language and style rules.

How do I install SQL Explainer in Claude Code?

Run `npx skills add zhuyansen/agent-skills-hub --skill sql-explainer -a claude-code`. Or copy the skill folder (ops/skillmgr-runs/in/input/library/sql-explainer in zhuyansen/agent-skills-hub) into .claude/skills/sql-explainer in your project. Claude Code loads it when a task matches its description.

How do I install SQL Explainer in Codex?

Run `npx skills add zhuyansen/agent-skills-hub --skill sql-explainer -a codex`. Or copy the skill folder (ops/skillmgr-runs/in/input/library/sql-explainer in zhuyansen/agent-skills-hub) into .agents/skills/sql-explainer in your project. Codex loads it when a task matches its description.

Can I use SQL Explainer 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 zhuyansen/agent-skills-hub --skill sql-explainer -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-explainer, .gemini/skills/sql-explainer, .github/skills/sql-explainer and .opencode/skills/sql-explainer in your project.

What does SQL Explainer need to run?

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

Does SQL Explainer 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 Explainer 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 Explainer use?

SQL Explainer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SQL Explainer use?

About 191 tokens (SKILL.md is roughly 764 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to SQL Explainer?

Skills that share tags, products or a category with SQL Explainer: SQL To Business Logic (nimrodfisher/data-analytics-skills, 470 stars), SQL Explainer (mergisi/awesome-openclaw-agents, 4k stars), SQL Translator (criptogus/agent-evolve-network, 288 stars) and 511 Frameworks Micronaut Jdbc (jabrena/plinth, 447 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SQL Explainer?

zhuyansen (a GitHub user) maintains it in zhuyansen/agent-skills-hub, which has 413 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 10, 2026.

Source: zhuyansen/agent-skills-hub on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.