Backblaze B2 Cloud Storage — a skill for Claude Code

A Claude Code skill for managing Backblaze B2 cloud storage directly from your terminal — list files, audit buckets, clean up stale data, and review security posture.

Built on the open Agent Skills specification. Compatible with Claude Code, Codex CLI, Cursor, Gemini CLI, and other skills-compatible agents.

What each badge means

Badge	Meaning
CI	GitHub Actions runs lint, tests, frontmatter validation, and pre-commit on every PR across Python 3.10–3.14.
License: MIT	Permissive open-source license — free to fork, modify, and ship.
Python 3.10–3.14	Tested on every currently-supported CPython version. Python 3.9 reached EOL in October 2025 and is no longer in the matrix.
Ruff	Linted and formatted with Astral's Ruff. Enforced via pre-commit.
Checked with mypy	Static type-checked. The audit script's public surface and the B2 JSON inputs are fully annotated.
pre-commit	Hooks for whitespace, JSON/YAML validity, ruff, markdownlint, yamllint, cspell, and mypy run on every commit.
Spell-checked: cspell	Markdown and Python prose are spell-checked with a project-specific allowlist.
Claude Code	First-class compatibility with Claude Code — auto-invoked when you mention B2 in chat.
Agent Skills	Conforms to the open Agent Skills SKILL.md specification — works in any compatible agent (Codex CLI, Cursor, Gemini CLI, etc.).
Backblaze B2	Targets the Backblaze B2 Cloud Storage platform via the official b2 CLI v4+.
GitHub stars	Community signal — give it a ⭐ if it's useful.

Features

• List & search objects across buckets with prefix filtering
• Storage audit — live vs. billable storage, breakdown by prefix + extension, configurable thresholds
• Hidden-cost detection — surfaces unfinished large uploads, old versions, and hide markers that still bill
• Cost estimation — monthly storage cost + potential savings after cleanup
• Duplicate detection — groups files by contentSha1 (true duplicates, not same-name)
• Stale & large-file flags — configurable --stale-days and --large-mb thresholds
• JSON output — --json flag for downstream analysis
• Cleanup with safety — mandatory dry-run + explicit "yes" confirmation before any deletion
• Security review — per-bucket checklist (type, SSE, CORS, object lock, replication, lifecycle coverage)
• Lifecycle rules — view and update expiration policies
• Guided setup — checks for a user-installed CLI, then walks through app-key creation and authorization
• Per-project config — different buckets and credentials per project

Install

Pick whichever fits your tooling. All methods install the same skill folder; only the delivery differs.

1. npx skills add — open spec CLI (recommended cross-agent)

Works with any Agent Skills-compatible client (Claude Code, Codex CLI, Cursor, Gemini CLI, Goose, OpenCode, etc.).