Cloudflare Basin Analytics Workflow Guide
A routing skill that picks the right Basin product (Pipelines, Catalog, or SQL) and guides you through building or debugging R2 Iceberg analytics workflows.
Data & AnalyticsIntermediate★ 433⑂ 46AI score 6/10Last updated: Oct 10, 2026
What it does
- Distinguishes Basin Pipelines, Basin Catalog, and Basin SQL and routes your task to the right one via a decision table.
- Maps legacy names (Cloudflare Data Platform, Pipelines, R2 Data Catalog, R2 SQL) onto the new Basin naming.
- Lays out the canonical flow: ingest/transform events → Iceberg tables in R2 → query with Basin SQL or a compatible external engine.
- Surfaces operational details:
wrangler basin pipelines/catalog/sqlcommand families, continued support for legacy commands, theWRANGLER_BASIN_SQL_AUTH_TOKENvariable, and the/basin-sql/query/{BUCKET}REST path. - Enforces a rule to fetch current official docs before acting on limits, pricing, permissions, or CLI syntax.
Who it's for
- Data/platform engineers running analytics on Cloudflare R2 + Apache Iceberg.
- Teams migrating existing R2 Data Catalog or R2 SQL setups to the Basin naming.
- Backend developers streaming event data into R2 for SQL analysis.
Example uses
- "Build a pipeline that ingests HTTP events, transforms rows, and writes to an R2 Iceberg table" → routed to the Basin Pipelines guide.
- "My R2 SQL query returns an auth error" → checks the Basin SQL token env var and REST query path.
- "The R2 Data Catalog docs 404" → explains the Basin Catalog rebrand, new doc URLs, and legacy command compatibility.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/aiskillstore/marketplace/HEAD/pending/cloudflare/basin/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the pending/cloudflare/basin folder from the GitHub repo aiskillstore/marketplace into my ~/.claude/skills/basin/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/aiskillstore/marketplace.git /tmp/aiskillstore && mkdir -p ~/.claude/skills/basin && cp -r /tmp/aiskillstore/pending/cloudflare/basin/* ~/.claude/skills/basin/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the skill repo:
git clone https://github.com/aiskillstore/marketplace.git /tmp/aiskillstore - Create the skill folder:
mkdir -p ~/.claude/skills/basin - Copy the files:
cp -r /tmp/aiskillstore/pending/cloudflare/basin/* ~/.claude/skills/basin/ - Verify
SKILL.mdand thereferences/directory are present. - Restart Claude Code and try a prompt like "help me set up a Basin pipeline".
- Before running real commands, confirm your CLI version with
wrangler --version, since Basin command names are still migrating.