Ggsql

Schrijft ggsql-queries (grammar-of-graphics voor SQL) met alleen gedocumenteerde clausules

Door posit-dev · posit-dev/skills

Getest · Werkt ★ 8.8/10

Ggsql — Schrijft ggsql-queries (grammar-of-graphics voor SQL) met alleen gedocumenteerde clausules

Wat het doet

Een referentie-skill die Claude de ggsql-querygrammatica leert — een SQL-extensie voor declaratieve datavisualisatie (VISUALISE, DRAW, PLACE, SCALE, FACET, PROJECT, LABEL-clausules, laagtypen en benoemde paletten). Wordt geactiveerd wanneer de gebruiker een ggsql-visualisatiequery wil maken, wijzigen, begrijpen of valideren. Bevat een optionele CLI (ggsql exec/validate) voor het renderen en controleren van queries.

Testrapport

SKILL.md opgehaald via ggsql/ggsql/SKILL.md via raw GitHub; frontmatter parset met name+description, geen gebundelde scripts om te breken, geen hardgecodeerde paden, geen beveiligingsrisico's. Trigger-test (3 positief / 2 negatief): 'write a ggsql query for a scatterplot of penguin bill length vs depth' JA, 'how do I make a stacked bar chart in ggsql' JA, 'turn this into a grammar-of-graphics SQL visualization query' JA; 'write a SQL query to sum revenue by month' NEE (plain SQL, geen viz), 'make a ggplot2 chart in R' NEE (ander hulpmiddel) — alle 5 correct. Output: dezelfde taak (faceted density histogram van pinguïnlichaamsmassa per soort) geschreven baseline versus skill. Baseline vond ggplot2-achtige syntaxis uit (GEOM histogram(x=..,y=..density..), FACET_WRAP(~species), kale `penguins`); skill produceerde gedocumenteerde ggsql (VISUALISE body_mass AS x, species AS fill FROM ggsql:penguins / DRAW histogram / REMAPPING density AS y / FACET species). Elke baseline-clausule ontbreekt in de ggsql-grammatica; elke skill-clausule verwijst naar een gedocumenteerd construct. Kon de ggsql CLI (niet geïnstalleerd) niet uitvoeren om rendering te bevestigen, dus output beperkt tot 8.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/posit-dev/skills.git /tmp/ggsql-src
mkdir -p ~/.claude/skills
cp -R /tmp/ggsql-src/ggsql/ggsql ~/.claude/skills/ggsql
# Skill is a single self-contained SKILL.md (no bundled scripts).
# Optional runtime dep: the `ggsql` CLI must be on PATH to VALIDATE/RENDER queries
# (subcommands exec/run/validate/parse). Writing queries works without it.
# CLI source/docs: https://ggsql.org

Commando's en voorbeeldprompts

  • /ggsqlSchrijft ggsql-queries (grammar-of-graphics voor SQL) met alleen gedocumenteerde clausules

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • Write a ggsql query to chart monthly sales
  • Explain what this ggsql visualization does
  • Modify this ggsql query to add a facet