Tinybird Agent Skills

Официальные скиллы Tinybird: правила датафайлов и SQL, работа с CLI tb и SDK для TypeScript и Python

СкиллНизкий риск

tinybirdco/tinybird-agent-skills

Установка

npx skills add tinybirdco/tinybird-agent-skills

Обновление: npx skills update

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Набор из четырех скиллов учит агента правильно работать с проектами Tinybird. Скилл best practices содержит правила для файлов .datasource, .pipe и .connection, SQL, эндпоинтов, материализованных представлений, деплоя и тестов. Скилл по CLI описывает команды tb для локальной разработки, деплоя и операций с данными. Два скилла по SDK объясняют описание источников и пайпов с типами на TypeScript и Python и миграцию со старых датафайлов.

Для кого. Для разработчиков и дата-инженеров, которые строят аналитические API на Tinybird.

Подходит, если

  • Агент создает или правит датасорсы, пайпы и эндпоинты Tinybird
  • Нужно оптимизировать эндпоинт по задержке
  • Проект переходит со старых датафайлов на SDK

Не подходит, если

  • Проект не использует Tinybird
  • Нужен прямой доступ агента к данным, а не правила

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

Создай датасорс для событий пользователей и эндпоинт с топом страниц за день

Ограничения

Скиллы содержат только инструкции, сам Tinybird облачный и требует аккаунта. Доступность Tinybird Cloud из России не проверена.

Как отключить. Удалите папки скиллов tinybird-* из каталога скиллов агента.

Проверка безопасности

  • Скиллы состоят только из инструкций и правил

Коротко о README

README описывает четыре скилла в формате Agent Skills и когда применять каждый. Установка и обновление выполняются через npx skills. Даны рекомендации, какие скиллы держать включенными, и примеры запросов. Каждый скилл состоит из SKILL.md и папки rules с отдельными правилами.

SKILL.md

---
name: tinybird
description: Tinybird file formats, SQL rules, optimization patterns, and best practices for datasources, pipes, endpoints, and materialized views.
---

# Tinybird Best Practices

Guidance for Tinybird file formats, SQL rules, optimization patterns, and data modeling. Use this skill when creating or editing Tinybird datafiles.

## When to Apply

- Creating or updating Tinybird resources (.datasource, .pipe, .connection)
- Writing or optimizing SQL queries
- Designing endpoint schemas and data models
- Organizing project structure and data layers
- Working with materialized views or copy pipes
- Implementing deduplication patterns
- Reviewing or refactoring Tinybird project files

## Rule Files

- `rules/project-files.md`
- `rules/build-deploy.md`
- `rules/datasource-files.md`
- `rules/pipe-files.md`
- `rules/endpoint-files.md`
- `rules/materialized-files.md`
- `rules/materialized-join-prefilter.md`
- `rules/sink-files.md`
- `rules/copy-files.md`
- `rules/connection-files.md`
- `rules/sql.md`
- `rules/endpoint-optimization.md`
- `rules/tests.md`
- `rules/deduplication-patterns.md`

## Quick Reference

- Project local files are the source of truth.
- Build target comes from `tinybird.config.json` `dev_mode` (`local` or `branch`).
- `tb deploy` targets Tinybird Cloud production.
- Commands like `tb sql` and `tb logs` default to local unless `--cloud` or `--branch=<branch-name>` is set.
- SQL is SELECT-only with Tinybird templating rules and strict parameter handling.
- Use MergeTree by default; AggregatingMergeTree for materialized targets.
- Filter early, select only needed columns, push complex work later in the pipeline.

Частые вопросы

Какие скиллы включать?

Всегда best practices, CLI при работе с tb, и один из SDK-скиллов под язык проекта.

Как обновить?

Командой npx skills update.

Выбор редакции

166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам

СкиллСредний риск44,9 тыс.
Выбор редакции

Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml

MCP-серверВысокий риск16,4 тыс.
Выбор редакции

Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой

СкиллВысокий риск11 тыс.
Выбор редакции

Экономный по токенам MCP-сервер для PostgreSQL, MySQL, MariaDB, SQL Server и SQLite с режимом только для чтения

MCP-серверВысокий риск3,5 тыс.