Neon Serverless

What it does

This skill, Neon Serverless, configures the Neon Serverless Driver to optimize performance in serverless and edge computing environments. It enables AI agents to generate code for connecting to Neon databases within these architectures, supporting both HTTP clients (recommended for edge/serverless) and WebSocket pools (for Node.js long-lived connections). The skill also incorporates rules for generating TypeScript/JavaScript code that respects project configuration, particularly regarding path aliases.

When to use it

• Setting up database connections for edge functions like Vercel Edge or Cloudflare Workers.
• Configuring serverless APIs using platforms such as AWS Lambda or Google Cloud Functions.
• Optimizing database access for low-latency applications.
• Implementing connection pooling strategies in high-throughput applications.

Key capabilities

• Generates code for connecting to Neon databases via HTTP Client and WebSocket Pool adapters.
• Handles TypeScript/JavaScript import statements, respecting project tsconfig.json path aliases.
• Defaults to relative imports when path aliases are unavailable or uncertain.
• Provides guidance on connection pooling strategies.

Example prompts

• "Generate code for connecting to my Neon database using an HTTP client in a Vercel Edge function."
• "Create a WebSocket Pool connection to my Neon database in a Node.js environment."
• “Write TypeScript code that imports from '@/lib/utils' if path aliases are defined, otherwise use relative imports.”

Tips & gotchas

• This skill is not recommended for complex multi-statement transactions (use the WebSocket Pool), persistent servers (use native PostgreSQL drivers), or offline-first applications.
• Refer to the neon-serverless.mdc file in the project root (https://raw.githubusercontent.com/neondatabase-labs/ai-rules/main/neon-serverless.mdc) for comprehensive guidelines and troubleshooting.
• Ensure the @neondatabase/serverless package is installed (npm install @neondatabase/serverless).