Agent skill

SQL Explainer

by mergisi in mergisi/awesome-openclaw-agents

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

MITAuto-check passedDatabases

Install SQL Explainer

skills CLI
$ npx skills add mergisi/awesome-openclaw-agents --skill sql-explainer -a claude-code

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

GitHub CLI
$ gh skill install mergisi/awesome-openclaw-agents 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/mergisi/awesome-openclaw-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gemma/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
4k
Token cost
~300 tokens
SKILL.md length
162 words
Files
3 (incl. scripts, assets)
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

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

  • Tasks that involve SQL
  • SKILL.md covers Examples and Instructions
  • Tasks that involve Plain language and style rules

What it does

SQL Explainer is an agent skill from mergisi/awesome-openclaw-agents. Paste a SQL query and get a plain English explanation of what it does.

Its SKILL.md is about 300 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and assets.

It sits in Databases, covering SQL and Plain language and style rules. It works with SQL. The repository describes itself as: 162 production-ready AI agent templates for OpenClaw. SOUL.md configs across 19 categories. Submit yours! 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”

What it can do on your machine

Read from SKILL.md and the folder at commit 05820c5. 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/, which the agent can run.

    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 300 tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 162 words of instructions outside code blocks.

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

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

The full file from mergisi/awesome-openclaw-agents at commit 05820c5, republished under its MIT licence (© mergisi). 162 words, ~300 tokens.

Download SKILL.mdSave it as .claude/skills/sql-explainer/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
sql-explainer
description
Paste a SQL query and get a plain English explanation of what it does.

SQL Explainer

Turn any SQL query into a clear, plain English breakdown. No database knowledge required.

Examples

  • "SELECT * FROM users WHERE created_at > NOW() - INTERVAL 7 DAY"
  • "Explain: SELECT p.name, COUNT(o.id) FROM products p LEFT JOIN orders o ON p.id = o.product_id GROUP BY p.id"
  • "What does this do: DELETE FROM sessions WHERE expires_at < NOW()"
  • "EXPLAIN SELECT u.email, SUM(o.total) FROM users u JOIN orders o ON u.id = o.user_id GROUP BY u.id HAVING SUM(o.total) > 1000"

Instructions

You MUST use the run_js tool with the following exact parameters:

  • data: A JSON string with the following fields:
    • query: String - the SQL query (truncate to first 120 characters if longer)
    • summary: String - one sentence plain English summary of what the query does
    • step1: String - first thing the query does (short phrase)
    • step2: String - second thing the query does (short phrase)
    • step3: String - third thing the query does, or empty string if not applicable
    • tip: String - one useful tip or potential issue to watch out for with this query

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

Files

SKILL.md and 2 other files (scripts, assets) in skills/gemma/sql-explainer of mergisi/awesome-openclaw-agents.

  • SKILL.md
  • assets/webview.html
  • scripts/index.html

Open the folder on GitHubat commit 05820c5

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 skillmergisi/awesome-openclaw-agents4k—~300Automated safety check: PassMIT
SQL To Business Logicnimrodfisher/data-analytics-skills465—~636Automated safety check: PassMIT
704 Technologies SQLjabrena/plinth445—~1kAutomated safety check: PassApache-2.0
SQL Query Explainermohitagw15856/pm-claude-skills1.4k—~1.6kAutomated safety check: PassMIT
Evolving The Data ModelTriliumNext/Trilium38k—~2.1kAutomated safety check: PassAGPL-3.0
SQL Optimization Patternsynulihao/AgentSkillOS61710 repos~3.3kAutomated safety check: PassNone

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.

    465 GitHub stars~636 tokensUpdated 12 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…

    445 GitHub stars~1k tokensUpdated today
    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 yesterday
    DatabasesAuto-check passed
  • Evolving The Data Model

    TriliumNext/Trilium

    A skill your agent uses when adding a DB migration or a new column/field to a Becca entity in Trilium ("add a migration", "new column on notes/attributes", "ALTER TABLE", "add a field to…

    38k GitHub stars~2.1k tokensUpdated today
    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 10 repos~3.3k tokens
    DatabasesAuto-check passed
  • SQL Portability

    HL7/sql-on-fhir

    Analyse whether a SQL query is portable across database implementations using sqlglot transpilation.

    150 GitHub stars~512 tokensUpdated yesterday
    DatabasesAuto-check passed

More from mergisi/awesome-openclaw-agents

All 16 skills in this repo
  • Claude Code Cost Optimizer

    mergisi/awesome-openclaw-agents

    Audits a project's Claude Code setup for common token-cost leaks and returns a prioritized fix list, using only static inspection of files and settings.

    4k GitHub stars~1.1k tokensUpdated 11 days ago
    Auto-check passed
  • Excalidraw Architecture Diagram

    mergisi/awesome-openclaw-agents

    Generates or updates a whiteboard-style architecture diagram of the current codebase as an Excalidraw JSON file, showing services and data flow.

    4k GitHub stars~1.1k tokensUpdated 11 days ago
    Auto-check passed
  • Git Commit Message Writer

    mergisi/awesome-openclaw-agents

    Drafts a commit message from your staged diff, matching the repo's own style and explaining why the change happened, not just what changed.

    4k GitHub stars~664 tokensUpdated 11 days ago
    Auto-check passed
  • Model Cost Compare

    mergisi/awesome-openclaw-agents

    Trigger when the user asks which model to use, wants to compare model costs, says "what's cheapest for this task", "should I use Opus or Sonnet", "can a smaller model handle this", or…

    4k GitHub stars~1k tokensUpdated 11 days ago
    Auto-check passed
  • Openclaw Debugger

    mergisi/awesome-openclaw-agents

    Trigger when an OpenClaw agent is broken, silent, crashing, stuck, not responding, returning empty output, or the user says "my agent is down", "agent not working", "/openclaw-debugger".

    4k GitHub stars~959 tokensUpdated 11 days ago
    Auto-check passed
  • Code Explainer

    mergisi/awesome-openclaw-agents

    Explains a pasted code snippet in plain English, returning the detected language, a one-sentence summary, how it works and one practical tip.

    4k GitHub stars~283 tokensUpdated 11 days ago
    Auto-check passed

Works with

Categories

Questions about SQL Explainer

What does SQL Explainer do?

Paste a SQL query and get a plain English explanation of what it does. SQL Explainer is an agent skill from mergisi/awesome-openclaw-agents. Paste a SQL query and get a plain English explanation of what it does.

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 mergisi/awesome-openclaw-agents --skill sql-explainer -a claude-code`. Or copy the skill folder (skills/gemma/sql-explainer in mergisi/awesome-openclaw-agents) 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 mergisi/awesome-openclaw-agents --skill sql-explainer -a codex`. Or copy the skill folder (skills/gemma/sql-explainer in mergisi/awesome-openclaw-agents) 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 mergisi/awesome-openclaw-agents --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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

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 300 tokens (SKILL.md is roughly 1.2k 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, 465 stars), 704 Technologies SQL (jabrena/plinth, 445 stars), SQL Query Explainer (mohitagw15856/pm-claude-skills, 1.4k stars) and Evolving The Data Model (TriliumNext/Trilium, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SQL Explainer?

mergisi (a GitHub user) maintains it in mergisi/awesome-openclaw-agents, which has 3,995 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on September 26, 2026.

Source: mergisi/awesome-openclaw-agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.