Tinybird file formats, SQL rules, optimization patterns, and best practices for datasources, pipes, endpoints, and materialized views.
Add this skill
npx mdskills install tinybirdco/tinybird-best-practicesComprehensive reference for Tinybird development with clear rule files and well-scoped use cases
A collection of skills for AI coding agents. Skills are packaged instructions that extend agent capabilities for working with Tinybird.
Skills follow the Agent Skills format.
Install with
npx skills add tinybirdco/tinybird-agent-skills
Update with
npx skills update
Use these for day-to-day Tinybird project work. They are safe defaults to keep enabled.
Tinybird project guidelines from Tinybird Engineering. Contains 18 rule files covering datasources, pipes, endpoints, SQL, deployments, and testing.
Use when:
Categories covered:
Use these when operating Tinybird with the CLI (local dev, deployments, data ops) and the datafile (.pipe, .connection, .datasource) format
Tinybird CLI commands, workflows, and operations. Use when running tb commands, managing local development, deploying, or working with data operations.
Use when:
tb commandUse these when working with the @tinybirdco/sdk package and type-safe projects.
Tinybird TypeScript SDK for defining datasources, pipes, and queries with full type inference. Use when working with @tinybirdco/sdk, TypeScript Tinybird projects, or type-safe data ingestion and queries.
Use when:
Skills are automatically available once installed. The agent will use them when relevant tasks are detected. You can use the agent cli to check, e.g., amp skill list, or directly ask the agent to tell you what skills are available.
Recommended defaults:
tinybird-best-practices for general Tinybird project work.tinybird-cli-guidelines whenever you plan to run tb commands.tinybird-typescript-sdk-guidelines for TypeScript SDK projects.Examples:
Each skill contains:
SKILL.md - Instructions for the agentrules/ - Individual guidance filesInstall via CLI
npx mdskills install tinybirdco/tinybird-best-practicesTinybird Agent Skills is a free, open-source AI agent skill. Tinybird file formats, SQL rules, optimization patterns, and best practices for datasources, pipes, endpoints, and materialized views.
Install Tinybird Agent Skills with a single command:
npx mdskills install tinybirdco/tinybird-best-practicesThis downloads the skill files into your project and your AI agent picks them up automatically.
Tinybird Agent Skills works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Codex, Gemini Cli, Amp, Roo Code, Goose, Opencode, Trae, Qodo, Command Code. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.