Agent Skills › MapleTechLabs/maple › tinybird

tinybird

GitHub

提供Tinybird开发的最佳实践，涵盖文件格式、SQL规则、优化模式及数据建模。适用于创建或编辑数据源、管道、端点、物化视图等资源，指导项目结构组织与查询性能优化。

.agents/skills/tinybird/SKILL.md MapleTechLabs/maple

Trigger Scenarios

创建或更新Tinybird资源文件编写或优化SQL查询设计端点Schema和数据模型重构Tinybird项目文件

Install

npx skills add MapleTechLabs/maple --skill tinybird -g -y

More Options

Non-standard path

npx skills add https://github.com/MapleTechLabs/maple/tree/main/.agents/skills/tinybird -g -y

Use without installing

npx skills use MapleTechLabs/maple@tinybird

指定 Agent (Claude Code)

npx skills add MapleTechLabs/maple --skill tinybird -a claude-code -g -y

安装 repo 全部 skill

npx skills add MapleTechLabs/maple --all -g -y

预览 repo 内 skill

npx skills add MapleTechLabs/maple --list

SKILL.md

Frontmatter

{
    "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.