A skill your agent uses when a val needs simple key/value persistence — JSON documents, cached responses, uploaded files, or binary assets.

Apache-2.0Auto-check passedBackend & APIs

Install Blob Storage

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill blob-storage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins blob-storage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/val-town/plugins/skills/blob-storage .claude/skills/blob-storage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
blob-storage
GitHub stars
1.3k
Token cost
~1.1k tokens
SKILL.md length
377 words
Files
1
Skills in repo
714
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when a val needs simple key/value persistence — JSON documents, cached responses, uploaded files, or binary assets.

  • A val needs simple key/value persistence — JSON documents
  • SKILL.md covers Scoping: account-global or…, Basic usage (JSON), Raw and binary data and Listing, deleting, copying, plus 4 more sections
  • Reaches esm.town
  • Cached responses

What it does

Blob Storage is an agent skill from hashgraph-online/awesome-codex-plugins. Use when a val needs simple key/value persistence — JSON documents, cached responses, uploaded files, or binary assets. Covers the std/blob API, listing and deleting keys, account-global or val scoping, and storage limits.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering File uploads and storage. It works with Azure Blob Storage. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • A val needs simple key/value persistence — JSON documents
  • Cached responses

Example prompts

  • “/blob-storage”

What it can do on your machine

Read from SKILL.md and the folder at commit 9e7b281. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • esm.town

    Also links to:

    • docs.val.town

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Blob Storage loads about 1.1k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 377 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 9e7b281, republished under its Apache-2.0 licence (© hashgraph-online). 377 words, ~1,076 tokens.

Download SKILL.mdSave it as .claude/skills/blob-storage/SKILL.md (or your agent's skills folder).
name
blob-storage
description
Use when a val needs simple key/value persistence — JSON documents, cached responses, uploaded files, or binary assets. Covers the std/blob API, listing and deleting keys, account-global or val scoping, and storage limits.
triggers
blob, storage, kv, key-value, persistence, cache, store, upload, file, json, asset, binary

Blob Storage

Val Town provides built-in key/value blob storage via the std/blob module. Reach for it whenever a val needs to persist simple values — JSON documents, cached API responses, uploaded files, or binary assets — keyed by a string. For relational or structured data you query with SQL, prefer std/sqlite instead.

Scoping: account-global or per-val depending on import

There are two exports of the blob utility: global.ts, which is scoped to the user account, and main.ts, which is scoped to the val itself. Prefer the main.ts interface and val scoping for new vals.

Here is the scoped import:

ts
/**
 * Importing from `main.ts` provides an interface to val-scoped blobs.
 */
import { blob } from "https://esm.town/v/std/blob/main.ts";

Here are the global imports:

ts
/**
 * Importing from `global.ts` provides a blob interface that is scoped
 * to your account.
 */
import { blob } from "https://esm.town/v/std/blob/global.ts";
/**
 * This entrypoint is also available as `v/std/blob`. This is common
 * in older vals.
 */
import { blob } from "https://esm.town/v/std/blob";

The scoped & global blob interfaces have the same methods.

Scoped & global blobs are stored separately: you cannot access global blobs with the scoped interface or vice versa.

Basic usage (JSON)

ts
import { blob } from "https://esm.town/v/std/blob/main.ts";

await blob.setJSON("config", { theme: "dark", count: 0 });

const config = await blob.getJSON("config");
// config = { theme: "dark", count: 0 }, or undefined if the key doesn't exist

getJSON returns undefined when the key is missing, so guard before using the result:

ts
const config = (await blob.getJSON("config")) ?? { theme: "light", count: 0 };

Raw and binary data

Use set/get for strings, binary, or any BodyInit. get returns a standard Response, so use its body helpers (.text(), .json(), .arrayBuffer(), .blob()):

ts
await blob.set("logo.png", imageBytes); // string | BodyInit (Blob, ArrayBuffer, ReadableStream, …)

const res = await blob.get("logo.png");
const bytes = await res.arrayBuffer();

Unlike getJSON, get throws ValTownBlobNotFoundError if the key doesn't exist — wrap it in try/catch when the key may be absent.

Listing, deleting, copying

ts
const entries = await blob.list("user_"); // optional key prefix filter
// entries = [{ key, size, lastModified }, …]

for (const { key } of entries) {
  await blob.delete(key);
}

await blob.copy("config", "config.bak"); // duplicate under a new key
await blob.move("draft", "published");   // rename / relocate

list(prefix?) returns an array of { key: string; size: number; lastModified: string } — objects, not bare key strings.

Show full SKILL.md (166 more words)Show less

Limits

  • Key length: up to 512 characters.
  • Total storage: 10 MB on the free plan, 1 GB on Pro — shared across all blobs in the account.
  • Store large or structured datasets in std/sqlite rather than as one giant blob.

Reading/writing blobs via tools

When using the storeBlob, readBlob, listBlobs, or deleteBlob tools against a val owned by an organization (not your personal account), pass the org handle as the org parameter so the call hits that organization's blob storage. Example: { key: "myapp:config", org: "some-org" }. This only matters for the tool calls — code inside the val reads and writes its owning account's storage automatically. Note storeBlob accepts UTF-8 text up to 100 KB; write larger or binary blobs from code with blob.set.

Rules

  • Treat keys as a flat namespace. Use prefixes (feature:subkey) for organization and to scope list.
  • getJSON returns undefined for missing keys; get throws ValTownBlobNotFoundError. Handle the absent case accordingly.
  • Don't store secrets in blobs — use environment variables for credentials.

Reference

Full API docs: https://docs.val.town/std/blob/

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/val-town/plugins/skills/blob-storage of hashgraph-online/awesome-codex-plugins.

Open the folder on GitHubat commit 9e7b281

Compare with similar skills

Blob Storage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Blob Storage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Blob Storage this skillhashgraph-online/awesome-codex-plugins1.3k—~1.1kAutomated safety check: PassApache-2.0
Edgeone Makers StorageTencentEdgeOne/edgeone-makers-tools1.9k1 repos~930Automated safety check: PassMIT
Neon Object Storageneondatabase/agent-skills100—~3.5kAutomated safety check: NotesApache-2.0
Azure Storage Blob Javamicrosoft/skills3.1k5 repos~2.7kAutomated safety check: PassMIT
Azure Storage Blob TSmicrosoft/skills3.1k5 repos~3.3kAutomated safety check: PassMIT
Azure Storage Blob Pymicrosoft/skills3.1k—~2.3kAutomated safety check: PassMIT

Similar skills

  • Edgeone Makers Storage

    TencentEdgeOne/edgeone-makers-tools

    KV and Blob storage services on EdgeOne Makers. An agent skill from TencentEdgeOne/edgeone-makers-tools.

    1.9k GitHub starsUsed in 1 repo~930 tokens
    Backend & APIsAuto-check passed
  • Neon Object Storage

    neondatabase/agent-skills

    Official

    S3-compatible object storage that branches with your Neon project, so files and the database stay in sync across every branch.

    100 GitHub stars~3.5k tokensUpdated today
    Backend & APIsAuto-check: notes
  • Azure Storage Blob Java

    microsoft/skills

    Official

    Build blob storage applications with Azure Storage Blob SDK for Java.

    3.1k GitHub starsUsed in 5 repos~2.7k tokens
    Backend & APIsAuto-check passed
  • Azure Storage Blob TS

    microsoft/skills

    Official

    Azure Blob Storage JavaScript/TypeScript SDK (@azure/storage-blob) for blob operations.

    3.1k GitHub starsUsed in 5 repos~3.3k tokens
    Backend & APIsAuto-check passed
  • Azure Storage Blob Py

    microsoft/skills

    Official

    Azure Blob Storage SDK for Python. An agent skill from microsoft/skills.

    3.1k GitHub stars~2.3k tokensUpdated today
    Backend & APIsAuto-check passed
  • Azure Storage Blob Rust

    microsoft/skills

    Official

    Azure Blob Storage library for Rust. An agent skill from microsoft/skills.

    3.1k GitHub stars~2.7k tokensUpdated today
    Backend & APIsAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 714 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.3k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.3k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.3k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.3k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.3k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.3k GitHub stars~618 tokensUpdated today
    Auto-check passed

Categories

Questions about Blob Storage

What does Blob Storage do?

A skill your agent uses when a val needs simple key/value persistence — JSON documents, cached responses, uploaded files, or binary assets. Blob Storage is an agent skill from hashgraph-online/awesome-codex-plugins. Use when a val needs simple key/value persistence — JSON documents, cached responses, uploaded files, or binary assets.

When should I use Blob Storage?

Blob Storage fits situations like: A val needs simple key/value persistence — JSON documents; cached responses.

How do I install Blob Storage in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill blob-storage -a claude-code`. Or copy the skill folder (plugins/val-town/plugins/skills/blob-storage in hashgraph-online/awesome-codex-plugins) into .claude/skills/blob-storage in your project. Claude Code loads it when a task matches its description.

How do I install Blob Storage in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill blob-storage -a codex`. Or copy the skill folder (plugins/val-town/plugins/skills/blob-storage in hashgraph-online/awesome-codex-plugins) into .agents/skills/blob-storage in your project. Codex loads it when a task matches its description.

Can I use Blob Storage in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill blob-storage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/blob-storage, .gemini/skills/blob-storage, .github/skills/blob-storage and .opencode/skills/blob-storage in your project.

What does Blob Storage need to run?

SKILL.md names no scripts, command-line tools or credentials: Blob Storage is instructions for the agent only.

Does Blob Storage access the network?

SKILL.md names 2 domains. In commands or code: esm.town; the agent is likely to contact it when it follows the instructions. As links in the text: docs.val.town. This is read from the text; nothing was executed.

Is Blob Storage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Blob Storage use?

Blob Storage is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Blob Storage use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Blob Storage?

Skills that share tags, products or a category with Blob Storage: Edgeone Makers Storage (TencentEdgeOne/edgeone-makers-tools, 1.9k stars), Neon Object Storage (neondatabase/agent-skills, 100 stars), Azure Storage Blob Java (microsoft/skills, 3.1k stars) and Azure Storage Blob TS (microsoft/skills, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Blob Storage?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,255 GitHub stars. The repository holds 714 skills in this directory. The repository was last updated on October 9, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.