# blob-storage

> Claude/Codex skill by [@val-town](https://omgskills.com/library/val-town/index.md) · 10 stars · Updated 2026-10-13

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.

## Install

```sh
git clone https://github.com/val-town/plugins /tmp/plugins && ln -s /tmp/plugins/plugin/skills/blob-storage ~/.claude/skills/blob-storage
```

## From README

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: Here are the global imports: 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 (JSON) getJSON returns undefined when the key is missing, so guard before using the result: Raw and binary data Use set/get for strings, binary, or any BodyInit.

## Links

- HTML page: https://omgskills.com/library/val-town/plugins/plugin/skills/blob-storage/
- GitHub: https://github.com/val-town/plugins
- Author: [@val-town](https://omgskills.com/library/val-town/index.md)

## More from this repo

- [client-side-js](https://omgskills.com/library/val-town/plugins/plugin/skills/client-side-js/index.md) — Used when a val needs to ship JavaScript that runs in the browser — React apps, vanilla DOM scripts, canvas/games,...
   - [@val-town](https://omgskills.com/library/val-town/index.md) · 10 stars
- [create-skill](https://omgskills.com/library/val-town/plugins/plugin/skills/create-skill/index.md) — Used when the user wants to persist a preference, skill, or knowledge.
   - [@val-town](https://omgskills.com/library/val-town/index.md) · 10 stars
- [cron-and-intervals](https://omgskills.com/library/val-town/plugins/plugin/skills/cron-and-intervals/index.md) — Used when building a val that runs on a schedule — periodic jobs, recurring tasks, polling, cron jobs, monitoring,...
   - [@val-town](https://omgskills.com/library/val-town/index.md) · 10 stars