Claude Skill: Backblaze B2 Cloud Storage Manager
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 — walks through CLI install, 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.).
