tinybird-cli-guidelines — Claude Code skill for the Tinybird CLI
Tells your agent how to run tb commands: builds, deploys, local development and data operations.
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -a claude-codeWhat tinybird-cli-guidelines does
The skill drops a set of Tinybird CLI rules into your agent's context. Eleven files sit inside: development workflows, CLI commands, build and deploy, local development, branch development, CI/CD, data operations, appending data, mock data, tokens and secrets. The agent pulls the relevant one when you ask for something involving tb.
The core idea is the CLI 4.0 workflow. You configure dev_mode once, then plain tb build and tb deploy do the rest. The first targets the development environment set in tinybird.config.json — branch or local — while the second goes to Tinybird Cloud production. Flags --cloud, --local and --branch exist only as manual overrides. Check where you are with tb info, and test endpoints with tb endpoint data <pipe>, not tb pipe data.
One rule stands out: the agent verifies commands and flags with tb <command> --help instead of inventing them. That cuts down on made-up flags landing in a deploy script. If your repo already carries its own tb conventions, expect friction — decide which set wins before you install this.
What it helps with
- build a project and ship it to production without guessing flags
- pick between local development, a branch and the cloud
- set up a CI/CD pipeline for a Tinybird project
- append, replace or delete data from the command line
- generate mock data for tests
Example prompts for the agent
- build the project and deploy it to Tinybird Cloud
- show me which environment I'm working in right now
- test this pipe's endpoint against mock data
How to install tinybird-cli-guidelines
1Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -a claude-code2Manually: put the files in place
~/.claude/skills/tinybird-cli-guidelines/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tinybird-cli-guidelines/
1Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -a codex2Manually: put the files in place
.agents/skills/tinybird-cli-guidelines/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -a cursor2Manually: put the files in place
.cursor/skills/tinybird-cli-guidelines/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tinybirdco/tinybird-agent-skills tinybird-cli-guidelines2Manually: put the files in place
.github/skills/tinybird-cli-guidelines/SKILL.md1Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -a gemini-cli2Platform CLI
gemini skills install https://github.com/tinybirdco/tinybird-agent-skills --path skills/tinybird-cli-guidelinesManually: put the files in place
.devin/skills/tinybird-cli-guidelines/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -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-cli-guidelines
How do I install tinybird-cli-guidelines in Claude?
Run npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -a claude-code. The skill lands in ~/.claude/skills/tinybird-cli-guidelines/SKILL.md.
What does tinybird-cli-guidelines do?
It gives the agent rules for the Tinybird CLI: choosing a workflow, building and deploying, and handling data, tokens and secrets.
Is there anything to set up first?
Yes — dev_mode in tinybird.config.json. Configure it once and tb build and tb deploy run without flags.
