Ggsql

Skriver ggsql-frågor (grammar-of-graphics för SQL) med endast dokumenterade klausuler

av posit-dev · posit-dev/skills

Testad · Fungerar ★ 8.8/10

Ggsql — Skriver ggsql-frågor (grammar-of-graphics för SQL) med endast dokumenterade klausuler

Vad den gör

En referensfärdighet som lär Claude ggsql-frågegrammatiken — en SQL-utökning för deklarativ datavisualisering (VISUALISE, DRAW, PLACE, SCALE, FACET, PROJECT, LABEL-klausuler, lagertyper och namngivna paletter). Utlöses när användaren vill skapa, modifiera, förstå eller validera en ggsql-visualiseringsfråga. Inkluderar ett valfritt CLI (ggsql exec/validate) för att rendera och kontrollera frågor.

Testrapport

Hämtade SKILL.md på ggsql/ggsql/SKILL.md via rå GitHub; frontmatter parsas med name+description, inga medföljande skript att bryta, inga hårdkodade sökvägar, inga säkerhetsbrister. Trigger-test (3 positiva / 2 negativa): 'skriv en ggsql-fråga för ett scatterplot av pingvinens näbblängd vs djup' JA, 'hur gör jag ett staplat stapeldiagram i ggsql' JA, 'förvandla detta till en grammar-of-graphics SQL-visualiseringsfråga' JA; 'skriv en SQL-fråga för att summera intäkter per månad' NEJ (vanlig SQL, ingen viz), 'gör ett ggplot2-diagram i R' NEJ (annat verktyg) — alla 5 korrekta. Utdata: samma uppgift (facetterat densitetshistogram av pingvinens kroppsmassa per art) skriven baslinje vs färdighet. Baslinjen uppfann ggplot2-stil syntax (GEOM histogram(x=..,y=..density..), FACET_WRAP(~species), bara `penguins`); färdigheten producerade dokumenterad ggsql (VISUALISE body_mass AS x, species AS fill FROM ggsql:penguins / DRAW histogram / REMAPPING density AS y / FACET species). Varje baslinjeklausul saknas från ggsql-grammatiken; varje färdighetsklausul mappas till en dokumenterad konstruktion. Kunde inte köra ggsql CLI (inte installerat) för att bekräfta rendering, så utdata begränsades till 8.

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

Installation

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

Kommandon och exempelprompter

  • /ggsqlSkriver ggsql-frågor (grammar-of-graphics för SQL) med endast dokumenterade klausuler

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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