Neon Object Storage Skill for Claude Code: What It Does and How to Install It

Makes your assistant set up S3-compatible object storage on a Neon branch, so files and database rows stay in sync across environments.

Installs: 32.9K; on skills.sh
Stars: 108; on GitHub
Updated: Oct 2026; last repo commit

SKILL.md sets up a bucket in neon.ts, applies it with neon deploy, pulls the branch's S3 credentials with neon env pull, and writes upload, download and presigned URL code with the Files SDK or the AWS S3 client.

It loads when you ask for object storage, buckets, file storage or presigned URLs. It needs the Neon CLI and a project in one of four AWS regions, and it points to the parent neon skill first.

Good for

Developers who need uploads, images or documents stored next to their Neon database
Teams that want preview and CI branches to have their own files
People avoiding a separate S3-style storage provider

Install neon-object-storage

Claude Code

Copy this prompt.

Install the neon-object-storage skill in Claude Code. Run this command:

npx skills add neondatabase/agent-skills --skill neon --skill neon-object-storage

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, A Neon account.

Install the parent neon skill with this one: SKILL.md starts with 'Use the parent neon skill', and the commands here use the Neon CLI. The parent neon skill gives the CLI install (npm i -g neon, plus bun, pnpm or brew variants) and sign-in (neon login). The plugin route installs the neon-postgres plugin: 9 skill folders and the Neon MCP server (https://mcp.neon.tech/mcp), which asks you to sign in with Neon over OAuth on first use. The folder routes copy skills only. There is no Claude app upload route because the skill drives the Neon CLI.

Built from the package data we hold. Not yet tested by us.

What's in the skill

When it loads

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".

Sections in SKILL.md

When to Use
What It Does
Availability
Architecture: Where Object Storage Fits
Setup
Neon Infrastructure as Code (neon.ts)
Environment Variables
Working with Objects: the Files SDK (Recommended)
Working with Objects: the AWS S3 Client (Alternative)
Pairing Storage with the Database on a Branch
CLI Bucket and Object Commands
Built-in Branch Logs
Neon Documentation
Further Reading

Key facts

Author: Neon (neondatabase/agent-skills, vendor's own repo)
Repo: neondatabase/agent-skills
License: Apache-2.0 (LICENSE and plugin.json agree)
Installs on skills.sh: 32,860 (Nov 2, 2026)
GitHub stars: 108 for the whole neondatabase/agent-skills repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: warn
What it includes: 1 file: SKILL.md (counted from the repo tree)
Needs: The parent neon skill, the Neon CLI and a Neon account (the parent skill gives npm i -g neon)
Part of plugin: neon-postgres (9 skill folders and the Neon MCP server)

What it includes

Confirms the project is in one of four supported AWS regions.
Read · Availability check
Declares buckets in neon.ts and creates them with neon config plan and apply.
neon deploy is an alias for neon config apply. Buckets are branch-scoped.
Try: “Add a bucket for user avatars to my Neon project.”
Runs code · neon.ts buckets
Writes the branch AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, endpoint and region to .env.
neon-env run injects them at runtime without a file.
Runs code · neon env pull
Uploads and downloads objects with the files-sdk neon adapter.
Installs files-sdk and AWS SDK packages with npm install.
Write · Files SDK (recommended)
Uses the standard AWS SDK with presigned URLs against the branch endpoint.
Write · AWS S3 client (alternative)
Creates, lists and deletes buckets and puts, gets, lists and deletes objects.
For scripting and one-off operations.
Delete · neon bucket / neon bucket object
Reads built-in branch logs for storage.
Runs code · neon logs query --source storage
Puts a CDN in front of public assets; public_read objects are readable anonymously.
Read · CDN and public_read

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can delete buckets and objects
SKILL.md lists neon bucket delete and neon bucket object delete. Use a preview branch for tests, because storage branches with the database. github.com
It puts S3 keys in your env file
neon env pull writes AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY for the branch to .env. Keep .env out of git. github.com
public_read objects are open
SKILL.md says a public_read object is read anonymously at the branch storage endpoint. Mark only public assets that way. github.com

Technical details

Turning on read-only	No read-only mode is documented for this skill.
Talks to	Neon API and the branch S3 endpoint
Sign-in and keys	Uses your Neon CLI sign-in or API key. Branch S3 credentials are written to .env by neon env pull.
Scopes	Runs the Neon CLI as your Neon account Creates buckets and S3 credentials on a Neon branch Writes S3 credentials into your .env with neon env pull Installs files-sdk and AWS SDK packages with npm

Questions

What does the neon-object-storage skill do?

It helps your assistant set up Neon Object Storage, an S3-compatible bucket that branches with your database. It declares buckets in neon.ts, wires in the injected credentials and writes upload and download code.

How do I install it?

Use the install box at the top of this page. It installs the parent neon skill with this one, because SKILL.md starts by pointing to the neon skill. You also need the Neon CLI and a Neon account.

Is it the official Neon skill?

Yes. It is in Neon's own agent-skills repo, and the repo's marketplace file calls its plugins official Neon plugins for Claude Code.

Does it work in the Claude app?

The install box has no Claude app upload route, because the skill drives the Neon CLI on your machine.

Where is it available?

SKILL.md says Object Storage is currently available in aws-us-east-2, aws-us-east-1, aws-eu-central-1 and aws-ap-southeast-1, and tells the assistant to check your project region first.

Can I use my existing S3 tools?

SKILL.md says it speaks the S3 API, so the AWS SDKs, boto3, the AWS CLI and presigned URLs work. It lists path-style addressing and SigV4 only.

Is it safe?

It creates buckets, writes S3 keys to your .env and can delete objects through the Neon CLI. Our advice: try it on a preview branch and keep .env out of git.

Information

updated Nov 2, 2026

Repository: neondatabase/agent-skills
Folder: skills/neon-object-storage

neondatabase/agent-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

neondatabase/agent-skills README · github.com
neon marketplace.json · github.com
neon plugin.json · github.com
neon mcp.json · github.com
neon SKILL.md (parent skill) · github.com
neon-object-storage SKILL.md · github.com