sql-writing SKILL.md skillA
sql-writing from stringnlplab/flexsql is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add stringnlplab/flexsql/sql-writing@git:20260504.f1763a1Pins git:20260504.f1763a1 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- stringnlplab/flexsql
- Path
claude_harness/.claude/skills/sql-writing/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260504.f1763a1, committed May 4, 2026
- Size
- 2,142 bytes
- Repository stars
- 12
- License
- none declared
Construct a SQL query that correctly answers a natural-language question grounded in the actual database.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# SQL Writing Text-to-SQL is harder than it looks, and most of the difficulty is interpretation. Before a single clause is written, the question has to be read precisely, the database has to be understood as it actually is, and the possible readings of the question have to be checked against the data. Most mistakes are baked in at interpretation time — a word misread, a scope assumed, a grain inferred — and no amount of SQL polish will fix them afterwards. ## Principles - **The question is a specification, not a description.** Every filter, every constraint, every column in the output shape is part of what you have to satisfy. The `SELECT` list is part of the spec, not an afterthought. - **Ambiguity is more common than it looks.** Most real questions have at least one phrase that can be read more than one way — in scope, in grain, in aggregation, in filter semantics, or in output shape. Find them. - **Test interpretations with data, not with reasoning.** When a phrase could mean two things, the cheapest way to tell which it means is to run a small query under each reading and look at the output. The surprise in the data is often the ambiguity you missed. …
Read the whole file at its exact version.
How to install
mdr add stringnlplab/flexsql/sql-writing@sha256:54c6cad9f59a9f57The line at the top of this page pins the label git:20260504.f1763a1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_idmhrkunujfiv6pr)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on May 4, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2142 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
stringnlplab/flexsql · 12 stars · license none declared · pushed 2026-09-12 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_idmhrkunujfiv6pr GET https://markdownregistry.com/api/v1/resolve?ref=stringnlplab/flexsql/sql-writing GET https://markdownregistry.com/api/v1/blob/54c6cad9f59a9f57437bc06242fba7ff8612f87f3095aeea49ea6d9579869b12
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.