Agent skill · Data · phuryn

sql-queries agent skill by phuryn

Generates SQL queries from natural language descriptions for BigQuery, PostgreSQL, MySQL, and other dialects, reading database schemas from uploaded diagrams or documentation.

View on GitHub Read SKILL.md

At a glance

Publisherphuryn
Repositoryphuryn/pm-skills (69 listed skills)
CategoryData, Analytics and Databases
LicenseMIT
Last commitOctober 16, 2026 (repository)
SKILL.md82 lines, 472 words
Bundled files1 file
Quality score78/100 · C Passes all seven graded checks
Security scanNot scanned
README badgeGet the listing badge and raise the score

Before you install

Read from the skill's files at the directory's October 19, 2026 snapshot: what ships with it, what its code reads, and the terms it is published under.

Install sql-queries

The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.

Skills CLI
npx skills add https://github.com/phuryn/pm-skills/tree/main/pm-data-analytics/skills/sql-queries
Claude Code, project-level copy
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/phuryn/pm-skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"pm-data-analytics/skills/sql-queries .claude/skills/
rm -rf "$tmp"
Codex installer
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
    --repo phuryn/pm-skills \
    --path pm-data-analytics/skills/sql-queries

phuryn/pm-skills is third-party code. Read SKILL.md and any bundled scripts before you install it.

How the author describes it

Generate SQL queries from natural language descriptions. Supports BigQuery, PostgreSQL, MySQL, and other dialects. Reads database schemas from uploaded diagrams or documentation. Use when writing SQL, building data reports, exploring databases, or translating business questions into queries.

From the description field of SKILL.md. Agents read this line to decide when to load the skill.

Sections in SKILL.md

Files in the skill folder

Suede Skill Check: 78/100 · C

Report snapshot · · graded-v2

The rubric totals 100 points; published scores are capped at 99. Security scan: not scanned.

Source revision: 07b34f64ee82. Report version 24d55fcb1a68. Badge URLs follow the latest listing; save the report to keep this version.

Download report · Request a fresh review

What to review next

  • Boundary clause: 0 of 4 points. 4 when the description says when not to use the skill (“Not for …”, “Do not use …”, “Use … instead”).
  • Example request: 0 of 3 points. 3 when the description quotes an example request (3–60 characters in quotation marks).
  • Instruction depth: 4 of 7 points. 7 for a SKILL.md body of 500–3,000 words; 4 for 250–4,500; 1 for 100 or more.

Add declarations and bundled files when they describe the skill’s actual needs. Update the source, then request a fresh review with the changed commit or PR.

sql-queries passes the required frontmatter check and all seven graded checks, which cover the SKILL.md format, a declared license and a commit in the last year. Those checks earn 56 of the score’s points; the rest come from description quality, instruction depth, bundled files, maintenance and curated-list citations. How the score works.

See the checks and points
CheckResult
Frontmatter parses and declares a name and a descriptionPass
Name uses lowercase letters, digits and hyphens, 64 characters or fewerPass
Name matches the skill's folder namePass
Description is between 50 and 1,024 charactersPass
Description says when an agent should use the skillPass
SKILL.md body is 500 lines or fewerPass
A license is declared in the frontmatter or the repositoryPass
Repository has a commit in the last 12 monthsPass
Score componentPoints
Structural checks56 of 56
Description length5 of 5
Boundary clause0 of 4
Example request0 of 3
Instruction depth4 of 7
Reference files0 of 3
Bundled scripts0 of 2
Recent maintenance9 of 9
Curated-list citations4 of 7
Tool permissions declared0 of 2
Compatibility declared0 of 2

Show the listing and raise the score

sql-queries is listed with 78/100 · C. This badge links to its Suede listing. Skills scoring 80–99 add a numeric and a letter quality shield; the largest open points for sql-queries are boundary clause (4), example request (3) and instruction depth (3). Send your repository and the points you want to raise, then request a fresh review after updating the skill.

Suede Skills Directory: listed

Markdown
[![Suede Skills Directory: listed](https://skills.suedeai.ai/directory/badge.svg)](https://skills.suedeai.ai/directory/phuryn/pm-skills/sql-queries/)
HTML
<a href="https://skills.suedeai.ai/directory/phuryn/pm-skills/sql-queries/"><img src="https://skills.suedeai.ai/directory/badge.svg" alt="Suede Skills Directory: listed" height="20"></a>

Where this skill is cited

phuryn/pm-skills appears in 3 curated lists: VoltAgent/awesome-agent-skills, heilcheng/awesome-agent-skills, skillmatic-ai/awesome-agent-skills.

All data, analytics and databases skills

More from phuryn/pm-skills

All 69 skills in phuryn/pm-skills