# neon-object-storage

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

S3-compatible object storage that branches with your database, so each branch gets its own copy of the files and the rows that point at them. Use when a user wants object storage, a bucket, blob/file storage, or somewhere to put uploads, images, documents, avatars, or user-generated files for their app or agent — especially when they already use (or are setting up) Lakebase Postgres and don't want to add a separate storage provider like AWS S3, Cloudflare R2, or Supabase Storage. Triggers include "object storage", "bucket", "blob storage", "file storage", "store uploads/images/files", "S3-compatible storage", "presigned URL", "where do I put files", "storage logs", "bucket logs", "CDN in front of object storage", "Neon Object Storage", "Neon Storage", and "storage that branches with my database".

## Install

```sh
git clone https://github.com/neondatabase/agent-skills /tmp/agent-skills && ln -s /tmp/agent-skills/skills/neon-object-storage ~/.claude/skills/neon-object-storage
```

## From README

Neon Object Storage Currently available in aws-us-east-2, aws-us-east-1, aws-eu-central-1, and aws-ap-southeast-1. Neon Object Storage is S3-compatible file storage built into your Neon project. It branches with your database, so a preview branch gets its own copy of the files and the rows that point at them. Use this skill to help the user store and serve files that branch alongside their database. Deliver a working bucket and upload/download flow, a branch-aware S3 client wired to the injected env vars, or a precise answer from the official Neon docs. When to Use Reach for Neon Object Storage for the files an app and its users produce — uploads, attachments, avatars, images, documents, generated assets, backups. It is the default place to put them when the app is already on Neon: They already use Lakebase Postgres and don't want a second provider.

## Links

- HTML page: https://omgskills.com/library/neondatabase/agent-skills/skills/neon-object-storage/
- GitHub: https://github.com/neondatabase/agent-skills
- Author: [@neondatabase](https://omgskills.com/library/neondatabase/index.md)

## More from this repo

- [neon-postgres](https://omgskills.com/library/neondatabase/agent-skills/neon-postgres/index.md) — Guides and best practices for working with Lakebase Postgres on Neon: connections, pooled vs direct, schema migrations,...
   - [@neondatabase](https://omgskills.com/library/neondatabase/index.md) · 108 stars
- [neon-postgres-egress-optimizer](https://omgskills.com/library/neondatabase/agent-skills/neon-postgres-egress-optimizer/index.md) — Diagnose and fix excessive Postgres egress (network data transfer) in a codebase.
   - [@neondatabase](https://omgskills.com/library/neondatabase/index.md) · 108 stars
- [neon](https://omgskills.com/library/neondatabase/agent-skills/skills/neon/index.md) — Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres: Auth, Object Storage, Functions,...
   - [@neondatabase](https://omgskills.com/library/neondatabase/index.md) · 105 stars