Ggsql

Escribe consultas ggsql (grammar-of-graphics para SQL) usando solo cláusulas documentadas

Por posit-dev · posit-dev/skills

Probado · Funciona ★ 8.8/10

Ggsql — Escribe consultas ggsql (grammar-of-graphics para SQL) usando solo cláusulas documentadas

Qué hace

Una habilidad de referencia que enseña a Claude la gramática de consulta ggsql — una extensión de SQL para visualización declarativa de datos (cláusulas VISUALISE, DRAW, PLACE, SCALE, FACET, PROJECT, LABEL, tipos de capa y paletas nombradas). Se activa cuando el usuario quiere crear, modificar, entender o validar una consulta de visualización ggsql. Incluye una CLI opcional (ggsql exec/validate) para renderizar y verificar consultas.

Informe de la prueba

SKILL.md obtenido en ggsql/ggsql/SKILL.md vía raw GitHub; el frontmatter se analiza con name+description, sin scripts incluidos para romper, sin rutas codificadas, sin problemas de seguridad. Prueba de activación (3 positivas / 2 negativas): '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 simple, sin visualización), 'make a ggplot2 chart in R' NO (herramienta diferente) — las 5 correctas. Salida: misma tarea (histograma de densidad facetado de la masa corporal de pingüinos por especie) escrita línea base vs habilidad. La línea base inventó sintaxis estilo ggplot2 (GEOM histogram(x=..,y=..density..), FACET_WRAP(~species), `penguins` desnudo); la habilidad produjo ggsql documentado (VISUALISE body_mass AS x, species AS fill FROM ggsql:penguins / DRAW histogram / REMAPPING density AS y / FACET species). Cada cláusula de línea base está ausente de la gramática ggsql; cada cláusula de habilidad se mapea a una construcción documentada. No se pudo ejecutar la CLI ggsql (no instalada) para confirmar la renderización, por lo que la salida se limitó a 8.

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

Instalación

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

Comandos y prompts de ejemplo

  • /ggsqlEscribe consultas ggsql (grammar-of-graphics para SQL) usando solo cláusulas documentadas

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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