tinybird — Claude Code skill: what it does, how to install
Guides agents when authoring Tinybird data files, fine-tuning analytical queries, and structuring data processing pipelines.
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-codeWhat tinybird does
This skill provides coding assistants with guidelines for .pipe, .datasource, and .connection resources. It outlines conventions for schema architecture, test files, and data workflows where workspace files serve as the source of truth.
Queries are restricted to SELECT statements that comply with Tinybird templating rules and parameter parsing. Standard data targets use MergeTree, switching to AggregatingMergeTree for materialized destinations. Pipelines must filter rows early while deferring heavy computations to subsequent nodes.
Workspace orchestration relies on tinybird.config.json, which determines the target through dev_mode settings (local or branch). CLI utilities like tb sql and tb logs execute locally by default. Connecting to remote instances requires passing --cloud or --branch=<branch-name>.
What it helps with
- structure data sources and analytical pipes
- write templated SELECT queries according to Tinybird syntax
- configure materialized views using AggregatingMergeTree
- apply deduplication rules and endpoint optimizations
Example prompts for the agent
- Generate a
.pipedefinition that aggregates metrics into an AggregatingMergeTree target - Review my
.datasourceschema and check if the filtering happens early in the pipe - Set up a deduplication query pattern for incoming event streams
How to install tinybird
1Skills 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-code2Manually: put the files in place
~/.claude/skills/tinybird-best-practices/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tinybird-best-practices/
1Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-best-practices -a codex2Manually: put the files in place
.agents/skills/tinybird-best-practices/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-best-practices -a cursor2Manually: put the files in place
.cursor/skills/tinybird-best-practices/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tinybirdco/tinybird-agent-skills tinybird-best-practices2Manually: put the files in place
.github/skills/tinybird-best-practices/SKILL.md1Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-best-practices -a gemini-cli2Platform CLI
gemini skills install https://github.com/tinybirdco/tinybird-agent-skills --path skills/tinybird-best-practicesManually: put the files in place
.devin/skills/tinybird-best-practices/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-best-practices -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tinybird
How to install tinybird in Claude Code?
Run npx skills add tinybirdco/tinybird-agent-skills --skill tinybird -a claude-code in your terminal.
What does the tinybird skill do?
It directs the coding agent on data modeling, project layout, and query patterns across Tinybird resources.
Which query engines are recommended by these guidelines?
Standard data targets use MergeTree, whereas materialized pipelines rely on AggregatingMergeTree to store pre-aggregated data.