basin — скилл для Claude Code: работа с Cloudflare Basin
Скилл для построения и отладки аналитических workflows в Cloudflare Basin. Помогает потокировать данные в R2 Iceberg-таблицы, управлять каталогами и выполнять распределённые SQL-запросы.
npx skills add cloudflare/skills --skill basin -a claude-codeЧто делает basin
basin интегрирует три компонента Cloudflare: Basin Pipelines для приёма и трансформации событий, Basin Catalog для управления метаданными и обслуживания Iceberg-таблиц в R2, Basin SQL для аналитических запросов. Типичный workflow: данные поступают через Pipelines, хранятся как таблицы в каталоге, затем запрашиваются SQL или совместимыми внешними движками.
Скилл работает с актуальными командами Wrangler (wrangler basin pipelines, wrangler basin catalog, wrangler basin sql) и отслеживает переход с прежних имён (Data Platform, R2 Data Catalog, R2 SQL). Поддерживает также устаревшие семейства команд wrangler pipelines и wrangler r2 — они остаются рабочими. Basin SQL требует переменной окружения WRANGLER_BASIN_SQL_AUTH_TOKEN.
Перед работой установите актуальную версию Wrangler и ознакомьтесь с текущей документацией, особенно в части лимитов, тарифов и синтаксиса, так как миграция компонентов ещё идёт.
Какие задачи решает
- потокировать события в R2 Iceberg-таблицы через Basin Pipelines
- трансформировать и доставлять строки данных
- управлять метаданными и обслуживанием Iceberg-таблиц
- выполнить аналитический SQL-запрос к таблицам в каталоге
- отладить конфигурацию Pipelines, Catalog или SQL
Примеры запросов агенту
- Помоги настроить Basin Pipeline для потоковой передачи логов в R2
- Как создать и зарегистрировать Iceberg-таблицу в Basin Catalog
- Напиши SQL-запрос к таблицам в Basin, проверь синтаксис
Как установить basin
1Через Skills CLI (Vercel)
npx skills add cloudflare/skills --skill basin -a claude-code2Вручную: положить файлы
~/.claude/skills/basin/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/basin/
1Через Skills CLI (Vercel)
npx skills add cloudflare/skills --skill basin -a codex2Вручную: положить файлы
.agents/skills/basin/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cloudflare/skills --skill basin -a cursor2Вручную: положить файлы
.cursor/skills/basin/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cloudflare/skills basin2Вручную: положить файлы
.github/skills/basin/SKILL.md1Через Skills CLI (Vercel)
npx skills add cloudflare/skills --skill basin -a gemini-cli2Командой платформы
gemini skills install https://github.com/cloudflare/skills --path skills/basinВручную: положить файлы
.devin/skills/basin/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cloudflare/skills --skill basin -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора18
Весь набор →Похожие
Вопросы о basin
Как установить basin в Claude Code?
Выполни npx skills add cloudflare/skills --skill basin -a claude-code, затем найди файл скилла в ~/.claude/skills/basin/SKILL.md.
Что делает скилл basin?
Помогает строить аналитические workflows: потокировать события через Basin Pipelines в R2 Iceberg-таблицы, управлять каталогом таблиц через Basin Catalog и писать распределённые SQL-запросы через Basin SQL.
Какие требования для работы Basin SQL?
Нужна переменная окружения WRANGLER_BASIN_SQL_AUTH_TOKEN. REST-запросы идут по пути /basin-sql/query/{BUCKET}. Проверь версию Wrangler перед использованием.
Исходный текст
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