AIKraft/AI/Войти
AIKraft/Skills/ggsql

ggsql

Write ggsql queries — a grammar of graphics for SQL. Use when the user wants to create, modify, or understand a ggsql visualization query.

posit-dev official Дизайн

Что делает навык

ggsql — это инструмент для создания визуализаций данных, объединяющий SQL-запросы с грамматикой графики в едином синтаксисе. Он позволяет создавать, изменять и анализировать визуальные представления, используя специфические предложения для определения слоёв, масштабов и фасетов.

Когда применять

  • Создание стандартных графиков (точечных, линейных, столбчатых) из CSV-файлов или таблиц SQL.
  • Построение сложных статистических визуализаций, таких как ящик с усами, плотность или сглаженные линии.
  • Настройка внешнего вида графиков: изменение цветовых палитр, масштабов осей, подписей и аннотаций.
  • Создание малых множеств (small multiples) с помощью фасетирования по категориям.
  • Преобразование координатной системы, например, создание круговых диаграмм через полярные координаты.

Как работает

  1. Начните с определения источника данных, используя предложение VISUALISE с указанием столбцов для осей или глобальных mappings.
  2. Добавьте визуальные слои с помощью предложения DRAW, указав тип слоя (например, point, bar, line) и необходимые mapping или remapping.
  3. При необходимости настройте агрегацию данных через SETTING aggregate или примените фильтры через FILTER.
  4. Настройте отображение данных с помощью предложения SCALE, определяя типы шкал (continuous, discrete, binned) и палитры цветов.
  5. Добавьте аннотации или текстовые метки с помощью PLACE или LABEL, если требуется уточнить график.
  6. Завершите запрос, применив проекцию координат через PROJECT, если требуется нестандартная система координат (например, полярная).

Примеры запросов агенту

Построй точечную диаграмму зависимости длины клюва от его глубины для пингвинов, используя встроенный датасет ggsql:penguins.
Создай столбчатую диаграмму с подсчётом количества пингвинов по видам, используя данные из файла 'dataset.csv'.
Визуализируй среднюю температуру по дням с доверительным интервалом в виде ленты (ribbon), сгруппированную по месяцам.

Что понадобится

  • Наличие инструмента ggsql в окружении.
  • Доступ к источникам данных (CSV, SQL-таблицы или встроенные датасеты ggsql).*
  • Использование движка DuckDB по умолчанию для чтения данных (через --reader duckdb://memory).

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «ggsql» из репозитория: # https://github.com/posit-dev/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r ggsql/ ~/.claude/skills/ggsql/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.