Build and troubleshoot Cloudflare K2 or K2 Streams durable logs. Use for stream setup, producing from Workers or HTTP, configuring retention and inputs, and consuming through subscriptions.

npx skills add https://github.com/cloudflare/skills --skill k2

Cloudflare K2

K2 is a durable log for decoupling event producers and consumers. Start with the K2 overview, then retrieve the relevant current documentation before giving setup instructions, code, limits, availability, permissions, or API details. The docs are the source of truth over this skill. K2 is in public beta on the Workers Paid plan; check the overview for current availability and beta storage limits.

Documentation

TaskDocsCheck for
Create a stream and try K2Get startedPrerequisites, setup sequence, current API examples
Understand streams and subscriptionsConceptsRecord model and delivery behavior
Configure a streamConfigurationInputs, authentication, CORS, retention
Produce from HTTP or a WorkerProduce recordsRequest and binding syntax, encoding, errors, retries
Consume through subscriptionsConsume recordsLeases, acknowledgements, retries, errors
Reason about duplicates and redeliveryDelivery guaranteesAt-least-once delivery, leases, retention effects
Size a stream or consumerLimitsCurrent quotas and size limits
Estimate costPricingBilling status, data produced, consumed, and retained

Retrieve the matching pages above for each task and use their current examples. For capacity or cost questions, check current limits and pricing before quoting values, and state whether billing is enabled yet.

For SQL transformation and delivery to R2 Iceberg tables, use the basin skill. For task processing, consult Queues.

Skill feedback

If the user reports that this skill gave incorrect or outdated guidance, or is missing information, read references/skill-feedback.md.

More skills from cloudflare

add-autogate
cloudflare
Step-by-step guide for adding a new autogate to workerd for gradual rollout of risky changes, including enum registration, string mapping, usage pattern, and…
add-autogate
cloudflare
Step-by-step guide for adding a new autogate to workerd for gradual rollout of risky changes, including enum registration, string mapping, usage pattern, and…
add-compat-flag
cloudflare
Step-by-step guide for adding a new compatibility flag to workerd, including capnp schema, C++ usage, testing, and documentation requirements.
add-compat-flag
cloudflare
Step-by-step guide for adding a new compatibility flag to workerd, including capnp schema, C++ usage, testing, and documentation requirements.
agents-sdk
cloudflare
Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks,…
architecture
cloudflare
Use when navigating the codebase for the first time, adding a new client method, adding a new container handler/service, or understanding how a request flows…
basin
cloudflare
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.
data-analysisawsdatabase
bazel-test-hygiene
cloudflare
Mandatory rules for running bazel tests during development. Load this skill before running any bazel test command, especially when validating fixes or…