AI Blocks › Write down how work gets done
Plain-words SQL explainer
Paste a SQL query. Get what it counts, which rows it keeps and what each column means, in plain words.
Plain-words SQL explainer is a free AI skill for the job "Write down how work gets done". Give the instructions to an AI assistant that supports the required files and tools, then review its output.
Free · No account · MIT licence · Made by Nimrod Fisher · Level: beginner
Made by Nimrod Fisher. See the original on GitHub; we copied it as it is, with its licence.
What it does
A SQL query turned into a plain description of what it counts, which rows it keeps and what each output column means. Anyone can then check whether the query matches the question. The skill reads the query in order. It describes the tables and how they are joined, including which join type drops or keeps rows. It rewrites each filter as a business rule, explains grouping and totals and the level they work at, and lists each output column with edge cases such as nulls or rounding. It then flags problems such as row duplication or hard-coded dates and adds questions to check. A helper script gives a first parse.
You give it
- The SQL query
- The business question it answers
- Notes on what key tables and columns mean (optional)
You get
- A plain description of sources and joins
- Filters stated as business rules
- A meaning for each output column
- Problems flagged with check questions
Use it when
- A manager asks what exactly a report query measures.
- You inherited undocumented queries and need to document them.
- You want to check a query against the business request.
- A new analyst needs to learn your SQL.
How to use it
- Add it to your AI once: download it and add the folder to Claude, ChatGPT or Codex as a skill.
- Ask for the job in your own words. Your AI opens the skill when it fits.