# tinybird-cli-guidelines

Tells your agent how to run tb commands: builds, deploys, local development and data operations.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1300 installs · ★ 22
- Author: tinybirdco
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tinybirdco/tinybird-agent-skills/tree/HEAD/skills/tinybird-cli-guidelines/SKILL.md
- Updated: 2026-07-29
- HTML: https://affpapa.org/en/nevibecode/skills/tinybird-cli-guidelines

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/tinybird-cli-guidelines/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tinybird-cli-guidelines/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tinybird-cli-guidelines/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tinybird-cli-guidelines/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tinybirdco/tinybird-agent-skills tinybird-cli-guidelines
```

2. **Manually: put the files in place**
- File: `.github/skills/tinybird-cli-guidelines/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/tinybirdco/tinybird-agent-skills --path skills/tinybird-cli-guidelines
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tinybird-cli-guidelines/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/tinybirdco/tinybird-agent-skills/tree/HEAD/skills/tinybird-cli-guidelines/SKILL.md

## When to use it
- 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
- 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

## Similar
- [data-analyst](https://affpapa.org/en/nevibecode/skills/data-analyst.md) — skill · 2200 installs
- [ETL Pipeline](https://affpapa.org/en/nevibecode/skills/etl-pipeline.md) — skill · 4800 installs
- [build-dashboard](https://affpapa.org/en/nevibecode/skills/build-dashboard.md) — skill · 8 installs
- [data-pipeline](https://affpapa.org/en/nevibecode/skills/data-pipeline.md) — skill · 4900 installs
- [parallel-findall](https://affpapa.org/en/nevibecode/skills/parallel-findall.md) — skill · 12300 installs
- [sasjs-cli](https://affpapa.org/en/nevibecode/skills/sasjs-cli.md) — skill · 1000 installs

From the same set: [tinybirdco/tinybird-agent-skills](https://affpapa.org/en/nevibecode/by/tinybirdco/tinybird-agent-skills.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md