Ggsql

Scrive query ggsql (grammar-of-graphics per SQL) usando solo clausole documentate

di posit-dev · posit-dev/skills

Promosso ★ 8.8/10

Ggsql — Scrive query ggsql (grammar-of-graphics per SQL) usando solo clausole documentate

Cosa fa

Una skill di riferimento che insegna a Claude la grammatica delle query ggsql — un'estensione SQL per la visualizzazione dichiarativa dei dati (clausole VISUALISE, DRAW, PLACE, SCALE, FACET, PROJECT, LABEL, tipi di layer e palette nominate). Si attiva quando l'utente vuole creare, modificare, comprendere o validare una query di visualizzazione ggsql. Include una CLI opzionale (ggsql exec/validate) per il rendering e la verifica delle query.

Rapporto di test

SKILL.md recuperato da ggsql/ggsql/SKILL.md tramite raw GitHub; il frontmatter viene analizzato con name+description, nessun script incluso da rompere, nessun percorso hardcoded, nessun problema di sicurezza. Test trigger (3 positivi / 2 negativi): 'write a ggsql query for a scatterplot of penguin bill length vs depth' SÌ, 'how do I make a stacked bar chart in ggsql' SÌ, 'turn this into a grammar-of-graphics SQL visualization query' SÌ; 'write a SQL query to sum revenue by month' NO (SQL semplice, nessuna visualizzazione), 'make a ggplot2 chart in R' NO (strumento diverso) — tutti e 5 corretti. Output: stesso compito (istogramma di densità sfaccettato della massa corporea dei pinguini per specie) scritto baseline vs skill. La baseline ha inventato una sintassi in stile ggplot2 (GEOM histogram(x=..,y=..density..), FACET_WRAP(~species), `penguins` nudo); la skill ha prodotto ggsql documentato (VISUALISE body_mass AS x, species AS fill FROM ggsql:penguins / DRAW histogram / REMAPPING density AS y / FACET species). Ogni clausola baseline è assente dalla grammatica ggsql; ogni clausola skill mappa a un costrutto documentato. Non è stato possibile eseguire la CLI ggsql (non installata) per confermare il rendering, quindi l'output è limitato a 8.

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

Installazione

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

Comandi e prompt di esempio

  • /ggsqlScrive query ggsql (grammar-of-graphics per SQL) usando solo clausole documentate

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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