Neon Database Complete Documentation

Complete Neon Serverless Postgres documentation. Covers serverless setup, branching, autoscaling, integrations (Vercel, Drizzle, Prisma), connection pooling, extensions, and best practices.

Security Scan

This package is an instruction-only documentation skill containing a large dump of Neon database docs — its declared metadata, files, and requirements are coherent with that purpose.

Purpose & Capability

Name/description describe Neon Serverless Postgres docs and the package contains ~546 markdown docs from Neon. There are no unexpected required binaries, env vars, or install steps; the single JS file is a small shared-content helper. The requested footprint matches a documentation-only skill.

Instruction Scope

SKILL.md and the included documentation are reference material. Many docs include example commands and examples that reference env vars (DATABASE_URL, NEON_API_KEY, OPENAI_API_KEY) and curl/neonctl usage — which is normal for documentation. The SKILL.md includes an explicit Security Notice warning agents not to auto-execute commands, which mitigates accidental autonomous execution. Still, if an agent were to run examples automatically, they could cause side effects — treat the examples as inert unless you explicitly run them.

Install Mechanism

No install spec; this is instruction-only with files bundled in the skill. Nothing is downloaded or extracted at install time, so install risk is low.

Credentials

The skill declares no required credentials or config paths (none listed). However, many documentation pages show sample commands that expect API keys or connection strings. Those examples are expected in docs but are not required by the skill itself — do not provide secrets to the skill just because the docs show them.

Persistence & Privilege

always is false and disable-model-invocation is false (normal). The skill does not request to persist credentials or edit other skills. Autonomous invocation is allowed by default; this is typical for skills but combine caution with the instruction-scope note above.

Scan Findings in Context

[unicode-control-chars] unexpected: A prompt-injection pattern detector flagged unicode control characters in SKILL.md. In documentation dumps this can be benign (formatting/artifacts from extraction), but control characters can also be used for hidden instructions. Manual inspection flagged nothing else malicious; review SKILL.md for unexpected invisible characters before trusting automated processing.

Assessment

This skill appears to be a straightforward copy of Neon’s public documentation and is internally consistent. Before installing or enabling autonomous use: 1) Do not allow the agent to auto-execute any example commands — the package itself warns against it. 2) Never paste production secrets (NEON_API_KEY, DATABASE_URL, OPENAI_API_KEY, etc.) into prompts or request the skill to 'use' them without explicit, deliberate action. 3) If you plan to let an agent act autonomously with this skill, restrict it from executing shell commands or network operations unless you explicitly approve each action. 4) Inspect SKILL.md for any invisible/control characters (scan finding) and confirm the source (the homepage/repository listed matches Neon’s public docs). If you need higher assurance, fetch docs directly from the official Neon repo/website and compare hashes.

⚠️ Security Notice

This skill contains Neon Database documentation with command examples. Commands are for reference only and should NEVER be auto-executed by agents without explicit user approval.

Neon Database Documentation

Complete Neon Serverless Postgres documentation extracted from the official Neon website repository.

Contents

This skill includes 546 markdown files (6.8MB) covering:

Core Concepts

• Introduction - What is Neon, architecture, and core concepts
• Get Started - Quick start guides and initial setup
• Serverless - Serverless PostgreSQL fundamentals

Features

• Branching - Database branching workflows (preview, development)
• Autoscaling - Compute autoscaling and scale-to-zero
• Connection Pooling - Connection pooling and serverless optimization
• Data API - HTTP-based data access

Integrations

• Vercel - Vercel integration (env vars, preview branches)
• Drizzle ORM - Drizzle setup and migrations
• Prisma - Prisma integration
• Next.js - Next.js + Neon patterns
• Auth - Authentication integrations (Better Auth, Auth.js, Clerk, etc.)

Database Management

• Manage - Projects, branches, databases, roles, compute
• Import - Data import strategies (PostgreSQL dump, CSV, etc.)
• Extensions - PostgreSQL extensions (pgvector, PostGIS, timescaledb, etc.)
• Functions - User-defined functions and stored procedures
• Data Types - PostgreSQL data types and Neon-specific types

Reference

• API Reference - Neon API endpoints and CLI (neonctl)
• Security - Security best practices, encryption, compliance
• PostgreSQL - PostgreSQL-specific documentation
• AI/ML - AI embeddings, RAG, pgvector

Developer Resources

• Guides - Step-by-step tutorials for common use cases
• Community - Community resources and support channels

Usage

This skill provides comprehensive documentation for:

1. Setting up Neon - Creating projects, connecting to databases
2. Integrations - Connecting Neon to frameworks and ORMs (Vercel, Drizzle, Prisma, Next.js, Better Auth)
3. Advanced Features - Branching, autoscaling, connection pooling
4. Best Practices - Serverless optimization, security, performance
5. API & CLI - Programmatic access via API and neonctl CLI

File Structure

docs/
├── introduction/        # Core concepts, architecture
├── get-started/         # Quick start guides
├── serverless/          # Serverless PostgreSQL
├── connect/             # Connection strings, pooling
├── data-api/            # HTTP data access
├── manage/              # Project and database management
├── import/              # Data import guides
├── extensions/          # PostgreSQL extensions
├── functions/           # User-defined functions
├── data-types/          # PostgreSQL data types
├── reference/           # API reference, CLI
├── security/            # Security best practices
├── auth/                # Authentication integrations
├── ai/                  # AI/ML features (pgvector)
├── guides/              # Step-by-step tutorials
├── community/           # Community resources
└── shared-content/      # Reusable documentation snippets

Documentation Source

Official Neon documentation extracted from:

• Repository: https://github.com/neondatabase/website
• Website: https://neon.tech/docs
• Last Updated: 2026-02-07

License

Documentation content © Neon Corporation. Used for educational purposes under fair use. Skill package © OpenClaw Community, MIT License.