Ggsql

Pisze zapytania ggsql (grammar-of-graphics dla SQL) używając tylko udokumentowanych klauzul

Autor: posit-dev · posit-dev/skills

Testowano · Działa ★ 8.8/10

Ggsql — Pisze zapytania ggsql (grammar-of-graphics dla SQL) używając tylko udokumentowanych klauzul

Co robi ten skill

Umiejętność referencyjna, która uczy Claude gramatyki zapytań ggsql — rozszerzenia SQL do deklaratywnej wizualizacji danych (klauzule VISUALISE, DRAW, PLACE, SCALE, FACET, PROJECT, LABEL, typy warstw i nazwane palety). Uruchamia się, gdy użytkownik chce utworzyć, zmodyfikować, zrozumieć lub zweryfikować zapytanie wizualizacyjne ggsql. Zawiera opcjonalny CLI (ggsql exec/validate) do renderowania i sprawdzania zapytań.

Raport z testu

Pobrano SKILL.md z ggsql/ggsql/SKILL.md przez raw GitHub; frontmatter parsuje z name+description, brak dołączonych skryptów do uszkodzenia, brak sztywno zakodowanych ścieżek, brak zagrożeń bezpieczeństwa. Test wyzwalacza (3 pozytywne / 2 negatywne): 'write a ggsql query for a scatterplot of penguin bill length vs depth' TAK, 'how do I make a stacked bar chart in ggsql' TAK, 'turn this into a grammar-of-graphics SQL visualization query' TAK; 'write a SQL query to sum revenue by month' NIE (zwykły SQL, bez wizualizacji), 'make a ggplot2 chart in R' NIE (inne narzędzie) — wszystkie 5 poprawne. Wyjście: to samo zadanie (histogram gęstości masy ciała pingwinów według gatunku) napisane w wersji bazowej vs umiejętności. Wersja bazowa wymyśliła składnię w stylu ggplot2 (GEOM histogram(x=..,y=..density..), FACET_WRAP(~species), gołe `penguins`); umiejętność wygenerowała udokumentowany ggsql (VISUALISE body_mass AS x, species AS fill FROM ggsql:penguins / DRAW histogram / REMAPPING density AS y / FACET species). Każda klauzula bazowa jest nieobecna w gramatyce ggsql; każda klauzula umiejętności mapuje się do udokumentowanej konstrukcji. Nie można było uruchomić ggsql CLI (niezainstalowanego) w celu potwierdzenia renderowania, więc wynik ograniczono do 8.

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

Instalacja

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

Komendy i przykładowe prompty

  • /ggsqlPisze zapytania ggsql (grammar-of-graphics dla SQL) używając tylko udokumentowanych klauzul

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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