Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
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
Open on GitHub

What 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 .pipe definition that aggregates metrics into an AggregatingMergeTree target
  • Review my .datasource schema 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-code
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-best-practices -a claude-code

2Manually: put the files in place

~/.claude/skills/tinybird-best-practices/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tinybird-best-practices/

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.

Similar skills

All skills for Data and databases →

From the same set2

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor