Agent skill · Neon
Neon Postgres skill for Claude Code, Codex and Cursor
Officialname: neon-postgres★ 105 (repo)pushed 2026-10-23Apache-2.0SKILL.md on GitHubchecked 2026-11-07
What it does, in the publisher's words
Guides and best practices for working with Lakebase Postgres on Neon: connections, pooled vs direct, schema migrations, branching (including schema-only, reset-from-parent, and branch-per-PR workflows), autoscaling, scale-to-zero, instant restore, read replicas, IP allow lists, logical replication, egress optimization, and Lakebase Search.
The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.
Install Neon Postgres
The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs
npx skills add neondatabase/agent-skills --skill neon-postgres
This repo is a plugin marketplace. Inside Claude Code, add it and install the plugin that holds the skill (neon-postgres), or copy only this skill into ~/.claude/skills. docs
/plugin marketplace add neondatabase/agent-skills /plugin install <plugin>@neon # or only this skill: npx skills add neondatabase/agent-skills --skill neon-postgres -a claude-code
Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs
git clone --depth 1 https://github.com/neondatabase/agent-skills.git /tmp/neon-postgres-src cp -r /tmp/neon-postgres-src/skills/neon-postgres ./neon-postgres zip -r neon-postgres.zip neon-postgres
Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs
npx skills add neondatabase/agent-skills --skill neon-postgres -a codex
gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs
gh skill install neondatabase/agent-skills neon-postgres
Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs
npx skills add neondatabase/agent-skills --skill neon-postgres -a cursor
Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs
gemini skills install https://github.com/neondatabase/agent-skills.git --path skills/neon-postgres
OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs
npx skills add neondatabase/agent-skills --skill neon-postgres -a opencode
Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs
npx skills add neondatabase/agent-skills --skill neon-postgres -a windsurf
Works with
Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.
What's in the SKILL.md
- Setup Flow
- 1. Select the organization and project
- 2. Get the connection string
- 3. Pick the connection method and driver
- 4. Set up the schema
- Branching
- Migrations
- Egress Optimization
- Troubleshooting and Neon-Specific Performance
- Choose CLI or MCP
- Pick the Diagnostic
- Interpret Results Safely
- Inspect Neon Cache Behavior Per Query
- Performance Workflow
- Computes
- Autoscaling
- Scale to Zero
- Keep hot reads off Postgres
- Instant Restore
- Read Replicas
- Connection Pooling
- IP Allow Lists
- Logical Replication
- Lakebase Search
- + 2 more
Bundled files
- references/branching.md
- references/egress-optimization.md
- references/full-text-search.md
- references/hybrid-search.md
- references/lakebase-search-drizzle.md
- references/vector-search.md
Loaded only when the instructions point to them.
Facts
- Skill name
- neon-postgres
- Publisher
- Neon (official)
- Repo
- neondatabase/agent-skills
- License
- Apache-2.0
- SKILL.md size
- 2,390 words, 291 lines
- Bundled files
- 6, 6 docs
- Repo stars
- 105 (as of 2026-10-24)
- SKILL.md checked
- 2026-11-07
Pairs with the Neon MCP server: the server gives the agent the tools, the skill teaches it how to use them.
More skills from neondatabase/agent-skills
- Neon Branches: Picks and creates the right Neon branch type for tests, previews and migration trials.
Related backend & databases skills
- Optimize EF Core Queries · Microsoft (.NET)
- Durable Objects · Cloudflare
- Supabase · Supabase
- Postgres Best Practices (Supabase) · Supabase
- Firebase Basics · Firebase (Google)
- Cloud Firestore · Firebase (Google)
- Sanity Best Practices · Sanity
- MongoDB Schema Design · MongoDB
FAQ
What does the neon-postgres skill do?+
Connection, pooling, migration, branching and scaling advice for Postgres on Neon. In its own SKILL.md, Neon describes it as: "Guides and best practices for working with Lakebase Postgres on Neon: connections, pooled vs direct, schema migrations, branching (including schema-only, reset-from-parent, and branch-per-PR workflows), autoscaling, scale-to-zero, instant restore, read replicas, IP allow lists, logical replication,..."
How do I install the neon-postgres skill?+
Run npx skills add neondatabase/agent-skills --skill neon-postgres and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/neon-postgres/SKILL.md; in Codex and Cursor in .agents/skills/neon-postgres/.
Does Neon Postgres work in Codex, Cursor and Copilot, or only Claude?+
It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.
Who maintains Neon Postgres?+
Neon, the company or project behind it, in the neondatabase/agent-skills repo on GitHub, last pushed 2026-10-23. License: Apache-2.0.
Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers