SWSkillsWay.ai
View Repo ↗
Skillset · / neondatabase / agent-skills

neondatabaseneondatabase/agent-skills

PurposeA collection of Agent Skills for Neon Serverless Postgres and its ecosystem (Auth, Storage, AI Gateway, Functions). Each skill is a folder with SKILL.md that agents auto-discover and invoke on relevant tasks. Covers platform overview, Postgres docs, branch workflows, instant DB provisioning, egress cost optimization, and more. Installable via CLI or as Claude/Cursor plugins with MCP. Ideal for agents and devs building on Neon using natural-language prompts.
Skill Count
9
Required CLI
curlneonneon-newpsql
Domains
BusinessCodingOthers
Forms
Cli ManualWorkflow
Skillset Analysis

Installation

One command to install the entire Skillset.

Copy and run in your terminal to add neondatabase/agent-skills to your Agent environment.

$npx skills add neondatabase/agent-skills
SkillsWay.ai · Heads-Up Agent Skills InspectorUnderstand Agent Skills before you install.

Core Idea

Principles & Methodology

The author's design philosophy, what sets this apart from peer projects, and quick notes on the key workflows. Skill names mentioned in the text auto-link to their detail pages.

Core Idea

This skillset provides Agent Skills for Neon Serverless Postgres and related services, enabling agents to operate Neon more accurately via auto-discovered SKILL.md instructions.

Design Principles

  • Auto-invoked: Skills are loaded automatically by the agent upon detecting relevant tasks (no manual trigger required).
  • Modular: Each skill covers one Neon capability (Postgres, Branches, Storage, AI Gateway, etc.).
  • Platform-integrated: Ships as Claude/Cursor plugins bundling skills + Neon MCP Server.

Key Skills

  • neon: Platform overview; neon-postgres: Docs index; neon-postgres-branches: Branch workflows; claimable-postgres: Instant DBs; neon-postgres-egress-optimizer: Cost diagnosis.

Best Practice

Install via npx skills add or plugin; use natural-language prompts like "Why is my Neon bill so high?" to let the agent auto-load the right skill.

Skill Relationships

Usage Relationships Between Skills

Skill → Skill usage relationships, with cross-layer references. Same color blocks indicate the same skill form.

Relationship Count
15
Standalone Skills
1
Most Referencing
  • neon7 downstream skills
  • neon-ai-gateway2 downstream skills
Most Referenced
  • neon7 upstream skills
  • neon-functions2 upstream skills

Note: Each dependency line reads as "the current Skill depends on" the Skill it points to.

Skill Composition

How skills in this set are triggered

Each skill is designed for a specific kind of caller — some only fire when you name them, others load automatically when the model judges them relevant. The split below summarises both modes at a glance.

User-Invoked0

These skills only fire when you call them by name. The agent will not load them on its own — they stay inert until invoked.

No skill in this set is recommended for manual invocation.

Model-Invoked9

These skills are loaded automatically by the agent when it judges the context relevant. You usually don't need to call them yourself.

claimable-postgresneonneon-ai-gatewayneon-functionsneon-object-storageneon-postgresneon-postgres-agent-platformsneon-postgres-branchesneon-postgres-egress-optimizer

Skill List

9 Skills · Filter by name or domain

claimable-postgres

Instantly provisions temporary Postgres databases for dev, demos, and tests with no account needed via REST API, CLI, SDK, or Vite plugin. Parses connection string and writes to .env. Delivers zero-setup DBs expiring in 72h unless claimed, boosting prototyping speed.

→
Domain
Coding
Form
Cli ManualWorkflow
Location
skills/claimable-postgres/SKILL.md

neon

Neon skill is the entry point for Neon's serverless backend suite (Postgres, Auth, Functions, Object Storage, AI Gateway). It routes to peer skills, fetches docs, and guides branch-first setup via CLI. Value: fast onboarding, correct skill use, isolated dev branches.

→
Domain
CodingBusiness
Form
Workflow
Location
skills/neon/SKILL.md

neon-ai-gateway

The Neon AI Gateway skill helps users route LLM calls through Neon's built-in inference gateway using one credential across multiple providers. It configures neon.ts, deploys via CLI, and wires AI SDK or Mastra. Value: unified API, branch-scoped isolation, no provider key management, and easy model switching.

→
Domain
CodingBusiness
Form
Workflow
Location
skills/neon-ai-gateway/SKILL.md

neon-functions

Helps users define, run locally, deploy, and manage Neon Functions — long-running Node.js HTTP handlers next to Neon Postgres. Uses neon CLI and neon.ts to deliver deployed functions with invocation URLs and local dev loops. Value: stateful, branch-isolated, low-latency backend primitives beyond serverless limits.

→
Domain
Coding
Form
Cli ManualWorkflow
Location
skills/neon-functions/SKILL.md

neon-object-storage

Helps users store and serve files that branch with Neon Postgres via S3-compatible object storage. Uses neon CLI and IaC config to provision buckets, injects AWS env vars, and provides Files SDK or AWS S3 client flows. Value: branch-synced files and DB rows, safe throwaway environments, no extra provider.

→
Domain
Coding
Form
Workflow
Location
skills/neon-object-storage/SKILL.md

neon-postgres

Guides users through any Neon serverless Postgres task: setup, connection, branching, auth, and SDK/API usage. Fetches official docs as markdown to verify, inspects env, runs Neon CLI/MCP init, and configures drivers/ORM. Delivers a working connection, feature config, or accurate doc answer, boosting dev efficiency on serverless Postgres.

→
Domain
CodingBusiness
Form
Cli ManualWorkflow
Location
skills/neon-postgres/SKILL.md

neon-postgres-branches

Guides creation and management of Neon Postgres branches via CLI or MCP. Decides normal vs schema-only type, executes branch creation, reset, and lifecycle hygiene. Delivers isolated, compliant DB branches for migration testing and dev workflows.

→
Domain
Coding
Form
Cli ManualWorkflow
Location
skills/neon-postgres-branches/SKILL.md

neon-postgres-egress-optimizer

Guides diagnosis and fixing of app-side query patterns causing excessive Postgres egress. Uses pg_stat_statements to find heavy queries, analyzes code, applies fixes (column selection, pagination, caching, SQL aggregation, JOIN split), and codifies Neon compute savings via neon.ts. Reduces data transfer cost and bill.

→
Domain
BusinessCoding
Form
Workflow
Location
skills/neon-postgres-egress-optimizer/SKILL.md

score-eval

Scores an eval diff against a rubric by reading the diff, rubric, and fixture app, answering P1-P5 detection/fix questions, and appending a row to results.csv. Produces structured eval scoring for change validation.

→
Domain
Others
Form
Workflow
Location
evals/neon-postgres-egress-optimizer/.claude/skills/score-eval/SKILL.md

Showing 9 / 9