SQL Whisperer /sql-whisperer

About this skill

SQL Whisperer lets anyone on the team ask data questions in plain English and get back correct, readable SQL. Point it at your schema and it learns your table names, join paths, and naming quirks — no more guessing whether it's user_id or users.id.

Safety is the point: every generated query is checked against a read-only allowlist, destructive statements are refused outright, and each query ships with a plain-English explanation of what it does before it ever runs.

It speaks Postgres, MySQL, BigQuery, Snowflake, SQLite, and DuckDB, and it optimizes for the dialect — window functions where they shine, CTEs where they're clearer. Analysts get answers; engineers stop being the SQL helpdesk.

Inputs

• question · string
  The data question in plain English.
• dialect · string
  postgres | mysql | bigquery | snowflake | sqlite | duckdb.
• schema · string
  Schema DDL or connection reference for context.

Outputs

• sql · string
  Generated, dialect-optimized SQL.
• explanation · string
  Plain-English explanation of the query.
• safety_report · string
  Read-only verification result.

Permissions

Deny-by-default: the skill can only use what it declares.

Manifest

{
  "spec": "agentskills.io/v1",
  "name": "sql-whisperer",
  "version": "1.8.4",
  "description": "Converts plain-English questions into safe, optimized SQL for your dialect, using your actual schema — with a plain-English explanation of what the query does.",
  "inputs": {
    "question": {"type": "string", "description": "The data question in plain English.", "required": true},
    "dialect": {"type": "string", "description": "postgres | mysql | bigquery | snowflake | sqlite | duckdb.", "required": true},
    "schema": {"type": "string", "description": "Schema DDL or connection reference for context.", "required": false}
  },
  "outputs": {
    "sql": {"type": "string", "description": "Generated, dialect-optimized SQL."},
    "explanation": {"type": "string", "description": "Plain-English explanation of the query."},
    "safety_report": {"type": "string", "description": "Read-only verification result."}
  },
  "permissions": ["fs:read", "env:read"],
  "author": "Tablestakes",
  "category": "Data"
}

Changelog