cloudflare-kv

SKILL.md

Global key-value storage at Cloudflare's edge with sub-5ms latency and eventual consistency.

Supports reads, writes, bulk operations, metadata storage, TTL expiration, and pagination across 1,000+ namespaces per account

Enforces 1 write per second per key (use retry logic for rate limits) and eventual consistency within ~60 seconds across regions

Offers cacheTtl for edge caching (minimum 60s), metadata optimization to avoid extra reads, and hot/cold key performance patterns (6-8ms vs 100-300ms)

Includes remote bindings for local development against production data, bulk read API (up to 100 keys as 1 operation), and CLI commands with --remote flag for production access

Cloudflare Workers KV

Status: Production Ready ✅
Last Updated: 2026-01-20
Dependencies: cloudflare-worker-base (for Worker setup)
Latest Versions: wrangler@4.59.2, @cloudflare/workers-types@4.20260109.0

Recent Updates (2025):

August 2025: Architecture redesign (40x performance gain, <5ms p99 latency, hybrid storage with R2)

April 2025: Bulk reads API (retrieve up to 100 keys in single request, counts as 1 operation)

January 2025: Namespace limit increased (200 → 1,000 namespaces per account for Free and Paid plans)

Quick Start (5 Minutes)