neon-postgres

Mechanism

When It Triggers · How It Works · What It Produces

Breaks down how the skill works and what it produces, so you can quickly judge whether it fits your scenario and value.

Trigger Timing

When a user needs to set up Neon serverless Postgres, connect to it, branch, or use advanced features (auth, SDK, admin API). Typical context: first-time Neon setup, picking drivers, or programmatic resource management.

Working Mechanism

Fetch official Neon docs as markdown to verify facts
Inspect user codebase/env, then run npx -y neon@latest init --agent or MCP steps
Guide through org/project selection, connection string, driver/ORM, auth, schema
Reference SDK/API docs for advanced automation

Outcome

A working Neon connection, completed feature config, or accurate doc-based answer delivered to the user.

Use Cases

Two Typical Use Cases

Scenario 01

First-time Neon setup for Next.js app

A developer building a Next.js app needs Postgres with user auth. They use this skill to run Neon CLI init, get a connection string into .env, provision Neon Auth via MCP, and set up Drizzle. The skill verifies docs and gives correct drivers, so they get a secure, working DB-backed app fast without manual trial-and-error.

Scenario 02

Automate Neon provisioning in CI/CD

A platform engineer must automate Neon project creation in CI/CD. Using this skill, they learn the Neon TypeScript SDK and REST API patterns, fetch reference docs, and script org/project/branch provisioning with polling. The result is reproducible infrastructure code and less reliance on manual console clicks.

Skill Relationships

Which Skills I Use · Which Skills Use Me

Dependency relationships read as "the upper tier points to the lower tier." The current Skill sits in the middle tier — above are Skills that depend on it, below are Skills it depends on.

Tier 1 · These Skills Use Me

neonWorkflow

Tier 2 · Current Skill

neon-postgresCli Manual · Workflow

Tier 3 · I Use These Skills

neonWorkflow

Full Relationship Graph

Browse this skill's relationships within its skillset. Click a node to switch the side panel; use the search box to jump to any skill.

Skill File

SKILL.md

Open in GitHub ↗

SKILL.mdLoading from GitHub…

Skill Composition

Open in GitHub ↗

SKILL.md50.0%
references50.0%

▸skills/neon-postgres/
▸root
- ·SKILL.md
- ▸references
  - ·neon-sdk.md

Per the Agent Skills spec, SKILL.md is the only required file. The colored bars classify the rest into the three spec-aligned optional directories (scripts / references / assets) and an 'other' bucket. The full directory tree is below.

Related in Skillset

You May Also Need These Skills

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.

Cli Manual · Workflow

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.

Workflow

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.

Workflow

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.

Cli Manual · Workflow

/neon-postgres

When It Triggers · How It Works · What It Produces

Trigger Timing

Working Mechanism

Outcome

Two Typical Use Cases

First-time Neon setup for Next.js app

Automate Neon provisioning in CI/CD

Which Skills I Use · Which Skills Use Me

Full Relationship Graph

SKILL.md

Skill Composition

You May Also Need These Skills

neon-postgres-branches

neon-postgres-egress-optimizer

neon-ai-gateway

neon-functions

When It Triggers · How It Works · What It Produces

Trigger Timing

Working Mechanism

Outcome

Two Typical Use Cases

First-time Neon setup for Next.js app

Automate Neon provisioning in CI/CD

Which Skills I Use · Which Skills Use Me

Full Relationship Graph

SKILL.md

Skill Composition

You May Also Need These Skills

neon-postgres-branches

neon-postgres-egress-optimizer

neon-ai-gateway

neon-functions