Ggsql

Écrit des requêtes ggsql (grammar-of-graphics pour SQL) en utilisant uniquement des clauses documentées

par posit-dev · posit-dev/skills

Testé · Fonctionne ★ 8.8/10

Ggsql — Écrit des requêtes ggsql (grammar-of-graphics pour SQL) en utilisant uniquement des clauses documentées

Ce que fait

Une compétence de référence qui enseigne à Claude la grammaire de requête ggsql — une extension SQL pour la visualisation de données déclarative (clauses VISUALISE, DRAW, PLACE, SCALE, FACET, PROJECT, LABEL, types de couches et palettes nommées). Se déclenche lorsque l'utilisateur souhaite créer, modifier, comprendre ou valider une requête de visualisation ggsql. Inclut une CLI optionnelle (ggsql exec/validate) pour le rendu et la vérification des requêtes.

Rapport de test

SKILL.md a été récupéré à ggsql/ggsql/SKILL.md via raw GitHub ; le frontmatter est analysé avec name+description, pas de scripts intégrés à casser, pas de chemins codés en dur, pas de failles de sécurité. Test de déclenchement (3 positifs / 2 négatifs) : 'write a ggsql query for a scatterplot of penguin bill length vs depth' OUI, 'how do I make a stacked bar chart in ggsql' OUI, 'turn this into a grammar-of-graphics SQL visualization query' OUI ; 'write a SQL query to sum revenue by month' NON (SQL simple, pas de visualisation), 'make a ggplot2 chart in R' NON (outil différent) — les 5 sont corrects. Sortie : même tâche (histogramme de densité facetté de la masse corporelle des pingouins par espèce) écrite en version de base vs compétence. La version de base a inventé une syntaxe de style ggplot2 (GEOM histogram(x=..,y=..density..), FACET_WRAP(~species), `penguins` nu) ; la compétence a produit du ggsql documenté (VISUALISE body_mass AS x, species AS fill FROM ggsql:penguins / DRAW histogram / REMAPPING density AS y / FACET species). Chaque clause de base est absente de la grammaire ggsql ; chaque clause de compétence correspond à une construction documentée. N'a pas pu exécuter la CLI ggsql (non installée) pour confirmer le rendu, donc la sortie est plafonnée à 8.

Testé le: 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

Commandes et exemples de prompts

  • /ggsqlÉcrit des requêtes ggsql (grammar-of-graphics pour SQL) en utilisant uniquement des clauses documentées

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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