Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

basin — Claude Code skill: Cloudflare Basin workflows

Skill for building and troubleshooting Cloudflare Basin analytics. Stream data into R2 Iceberg tables, manage catalogs, and run distributed SQL queries from your IDE.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add cloudflare/skills --skill basin -a claude-code
Open on GitHub

What basin does

basin integrates three Cloudflare components: Basin Pipelines to ingest and transform events, Basin Catalog to manage Iceberg table metadata and maintenance in R2, and Basin SQL for analytical queries. The typical flow moves data through Pipelines into catalogued tables, then queries them with SQL or compatible external engines.

The skill works with current Wrangler commands (wrangler basin pipelines, wrangler basin catalog, wrangler basin sql) and tracks the migration from legacy names (Data Platform, R2 Data Catalog, R2 SQL). Legacy command families like wrangler pipelines and wrangler r2 continue to work. Basin SQL requires the WRANGLER_BASIN_SQL_AUTH_TOKEN environment variable.

Before starting, install the latest Wrangler version and check current docs for limits, pricing, and syntax—the component migration is ongoing.

What it helps with

  • stream events into R2 Iceberg tables using Basin Pipelines
  • transform and deliver data rows
  • manage Iceberg table metadata and maintenance
  • write analytical SQL queries against catalog tables
  • debug Basin Pipelines, Catalog, or SQL configuration

Example prompts for the agent

  • Help me set up a Basin Pipeline to stream logs into R2
  • How do I create and register an Iceberg table in Basin Catalog
  • Write a SQL query for Basin tables and check the syntax

How to install basin

1Skills CLI (Vercel)

npx skills add cloudflare/skills --skill basin -a claude-code

2Manually: put the files in place

~/.claude/skills/basin/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/basin/

From the same set18

The whole set →
cloudflare cloudflare Helps coding agents pick the right Cloudflare products for applications, storage, and AI, while routing between cf CLI and Wrangler. Claude Code CX Codex Cursor +1 136,500installs wrangler cloudflare Runs and troubleshoots Wrangler CLI commands for Cloudflare Workers projects that use wrangler configuration files. Claude Code CX Codex Cursor +1 128,500installs workers-best-practices cloudflare Guides coding agents on production Cloudflare Workers standards, Wrangler typing, observability setup, and runtime anti-pattern checks. Claude Code CX Codex Cursor +1 124,900installs durable-objects cloudflare This skill helps build, debug, and review Cloudflare Durable Objects for state, coordination, and persistent connections. Claude Code CX Codex Cursor +1 109,700installs web-perf cloudflare Audit Core Web Vitals, diagnose rendering bottlenecks, and inspect network dependencies directly through your agent. Claude Code CX Codex Cursor +1 109,300installs agents-sdk cloudflare Helps build, debug, and review Cloudflare Agents SDK applications using the agents package and official documentation. Claude Code CX Codex Cursor +1 105,700installs cloudflare-email-service cloudflare A skill for Cloudflare Email Sending and Email Routing: it walks the agent through sending and receiving mail in Workers. Claude Code CX Codex Cursor +1 101,400installs cloudflare-one cloudflare Walks your agent through designing, configuring and troubleshooting Cloudflare One Zero Trust and SASE deployments. Useful when you need Access, Gateway or tunnel work done without digging through docs yourself. Claude Code CX Codex Cursor +1 92,200installs

Similar

break-trace official anthropics The skill traces a reconciliation break to its source entries and states what differs. Use it after gl-recon has classified the break. Claude Code CX Codex Cursor +1 1,200installs prisma-expert sickn33 This skill helps inspect Prisma schemas, migrations, and queries. Use it to investigate an error or review database changes before deployment. Claude Code CX Codex Cursor +1 4,200installs google-cloud-storage-bucket-architect official google This skill plans and creates Google Cloud Storage buckets around a workload and the project's security settings. Use it when an app, service, or pipeline needs object storage. Claude Code Gemini CLI CX Codex 2,800installs neon neondatabase This skill helps choose and configure a Neon backend with Postgres, auth, storage, functions, the AI Gateway, and Realtime. Use it when building an app. Claude Code CX Codex Cursor +1 231,200installs google-cloud-filestore-nfs-browser official google Inspects, searches, and reads files on Google Cloud Filestore with POSIX metadata. Use it for remote logs and NFS shares without local NFS client packages. Claude Code Gemini CLI CX Codex 2,500installs xlsx official anthropics Creates, reads, edits, and converts spreadsheet files. Use it when the requested deliverable is an Excel workbook or another tabular file. Claude Code Claude.ai 187,223installs google-agents-cli-observability official Google This skill guides you through tracing and monitoring AI agents, including ADK agents. Use it when you need to inspect agent execution or monitor a deployed agent. Claude Code CX Codex Cursor +1 509,900installs caveman-evidence-review JuliusBrussee A read-only skill reviews Caveman Cloud evidence on LLM spend, traces, and routing. Use it to see where a project’s model budget goes. Claude Code CX Codex Cursor +1 103,500installs

Questions about basin

How do I install basin in Claude Code?

Run npx skills add cloudflare/skills --skill basin -a claude-code, then find the skill file at ~/.claude/skills/basin/SKILL.md.

What does the basin skill do?

It helps you build analytics workflows: stream events through Basin Pipelines into R2 Iceberg tables, manage the table catalog with Basin Catalog, and write distributed SQL queries via Basin SQL.

What do I need to run Basin SQL?

Set the WRANGLER_BASIN_SQL_AUTH_TOKEN environment variable. REST queries use the path /basin-sql/query/{BUCKET}. Check your Wrangler version before use.

Source text

SKILL.md · Apache-2.0 
---
name: basin
description: Build and troubleshoot Cloudflare Basin analytics workflows with Basin Pipelines, Basin Catalog, and Basin SQL. Use for streaming data into R2 Iceberg tables, managing catalogs, or querying those tables; also use for requests using the former Data Platform, Pipelines, R2 Data Catalog, or R2 SQL names.
---

# Cloudflare Basin

Basin ingests and transforms events, manages Apache Iceberg tables in R2, and queries them with distributed SQL. Start with the [Basin overview](https://developers.cloudflare.com/basin/index.md) and retrieve the relevant current docs before implementing changes, especially for limits, pricing, permissions, and CLI syntax. While PR #33850 remains open, use the proposed pages in that PR if the new URLs have not been published.

## Rebrand

Cloudflare Data Platform is now **Basin**. Cloudflare Pipelines, R2 Data Catalog, and R2 SQL are now **Basin Pipelines**, **Basin Catalog**, and **Basin SQL**. Existing resources and configurations continue to work. The prior Wrangler command families also continue to work: `wrangler pipelines`, `wrangler r2 bucket catalog`, and `wrangler r2 sql`. Use the new Basin commands and documentation URLs in new guidance. Legacy API identifiers and metrics names may still use the old terms; check the current docs for deprecation details. The migration is documented in [cloudflare-docs PR #33850](https://github.com/cloudflare/cloudflare-docs/pull/33850).

## Choose the workflow

| Need | Product | Reference | Current docs |
|------|---------|-----------|--------------|
| Receive events, transform rows, and deliver to R2 | Basin Pipelines | [Pipelines guide](references/pipelines/README.md) | [Basin Pipelines](https://developers.cloudflare.com/basin-pipelines/index.md) |
| Manage Iceberg metadata, table maintenance, and engine access | Basin Catalog | [Catalog guide](references/catalog/README.md) | [Basin Catalog](https://developers.cloudflare.com/basin-catalog/index.md) |
| Query Iceberg tables with analytical SQL | Basin SQL | [SQL guide](references/sql/README.md) | [Basin SQL](https://developers.cloudflare.com/basin-sql/index.md) |

Typical flow: Basin Pipelines → Basin Catalog tables in R2 → Basin SQL or a compatible external engine. Begin with the [Basin getting started guide](https://developers.cloudflare.com/basin/get-started/guide/index.md) for an end-to-end setup.

The proposed Wrangler command families are `wrangler basin pipelines`, `wrangler basin catalog`, and `wrangler basin sql`. Basin SQL uses `WRANGLER_BASIN_SQL_AUTH_TOKEN`; its REST query path is `/basin-sql/query/{BUCKET}`. Check the installed Wrangler version and current reference pages before running commands because the migration is ongoing.

© cloudflare · Apache-2.0 · cloudflare/skills

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

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