tinybird — скилл для Claude Code: что делает и как установить
Скилл учит агента создавать файлы Tinybird, писать шаблонизированные SQL-запросы и настраивать пайплайны данных с материализованными представлениями.
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird -a claude-code
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-best-practices -a claude-codeЧто делает tinybird
Набор правил помогает агенту работать с ресурсами .datasource, .pipe и .connection. Он направляет проектирование схем данных, составление тестов и сборку эндпоинтов. Главным источником правды остаются локальные файлы проекта.
Запросы ограничены оператором SELECT со строгой проверкой параметров и шаблонизацией Tinybird. По умолчанию агент выбирает движок MergeTree, а для материализованных представлений переключается на AggregatingMergeTree. Вычисления выносятся в конец пайплайна, а фильтрация выполняется на ранних этапах.
Конфигурация проекта считывается из tinybird.config.json: цель сборки определяется параметром dev_mode со значениями local или branch. Утилиты tb sql и tb logs по умолчанию выполняются локально. Без флагов --cloud или --branch=<branch-name> они не обратятся к облаку.
Какие задачи решает
- спроектировать эндпоинты и пайпы обработки данных
- оптимизировать SELECT-запросы под шаблонизатор Tinybird
- настроить схемы с движками MergeTree и AggregatingMergeTree
- реализовать дедупликацию данных и материализованные витрины
Примеры запросов агенту
- Создай пайп
analytics.pipeс материализованным представлением на базе AggregatingMergeTree - Проверь SQL-запрос в
events.datasourceна раннюю фильтрацию строк - Настрой схему дедупликации данных для эндпоинта заказов
Как установить tinybird
1Через Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird -a claude-codenpx skills add tinybirdco/tinybird-agent-skills --skill tinybird-best-practices -a claude-code2Вручную: положить файлы
~/.claude/skills/tinybird-best-practices/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tinybird-best-practices/
1Через Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-best-practices -a codex2Вручную: положить файлы
.agents/skills/tinybird-best-practices/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-best-practices -a cursor2Вручную: положить файлы
.cursor/skills/tinybird-best-practices/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install tinybirdco/tinybird-agent-skills tinybird-best-practices2Вручную: положить файлы
.github/skills/tinybird-best-practices/SKILL.md1Через Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-best-practices -a gemini-cli2Командой платформы
gemini skills install https://github.com/tinybirdco/tinybird-agent-skills --path skills/tinybird-best-practicesВручную: положить файлы
.devin/skills/tinybird-best-practices/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-best-practices -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tinybird
Как установить tinybird в Claude Code?
Выполните команду npx skills add tinybirdco/tinybird-agent-skills --skill tinybird -a claude-code в терминале.
Для чего нужен этот скилл?
Он задаёт агенту правила работы с файлами .pipe, .datasource и .connection, следит за фильтрацией в запросах и помогает проектировать витрины данных.
Какие ограничения действуют для SQL-запросов?
Допускаются только запросы с оператором SELECT, строгой проверкой параметров и шаблонизацией Tinybird.
