neon-toolkit
π―Skillfrom neondatabase/ai-rules
Provides comprehensive AI-powered development tools and context rules for managing Neon Postgres projects, automating database workflows, and streamlining resource management across different AI co...
Installation
npx skills add https://github.com/neondatabase/ai-rules --skill neon-toolkitSkill Details
Overview
> [!IMPORTANT]
> This repository has been archived. The content has moved to [neondatabase/agent-rules](https://github.com/neondatabase/agent-rules).
>
> [Agent Skills](https://neon.com/blog/agent-skills-in-2026) are now a specification supported by all major agents and coding editors, providing more capabilities than rule files. We created a new repository following the agent-skills pattern introduced by Vercel.
>
> ```bash
> npx skills add neondatabase/agent-rules
> ```
# Neon AI Development Toolkit
A comprehensive Claude Code plugin with AI context rules, guided skills, and resource management tools for building with Neon Postgres. Works with Claude Code, Cursor, and other AI-powered development tools.
What's Inside
For Claude Code Users
- Claude Code Plugin - The plugin itself, which includes 6 skills and MCP server integration
- Claude Code Skills - Interactive workflows with templates and automation scripts for Neon
- MCP Server Integration - Direct Neon resource management (projects, branches, databases)
For Cursor & Other AI Tools
- Portable .mdc Files - Standalone context rules that work anywhere
- Tool-Agnostic Format - Use with any AI assistant supporting custom rules
---
Quick Start
Claude Code
1. Add the Neon marketplace:
```bash
/plugin marketplace add neondatabase-labs/ai-rules
```
2. Install the plugin:
```bash
/plugin install neon-plugin@neon
```
3. Verify installation:
Ask Claude Code: "which skills do you have access to?"
You should see the Neon skills listed.
4. Start using:
Use natural language and skills activate automatically:
```bash
> Use the neon-drizzle skill to setup Drizzle ORM with Neon
```
Cursor
1. Create rules directory:
```bash
mkdir -p .cursor/rules
```
2. Copy desired .mdc files:
```bash
# Example: Copy Drizzle and Serverless rules
cp neon-drizzle.mdc .cursor/rules/
cp neon-serverless.mdc .cursor/rules/
```
3. Start coding:
Cursor automatically applies these rules when you reference Neon.
Other AI Tools
Copy .mdc files to your AI tool's custom rules directory. The format is tool-agnostic and works with any AI assistant supporting context rules.
---
Skills Reference
Complete workflow support for:
- New project setup
- Existing project integration
- Schema-only workflows
Includes:
- Schema generation utilities
- Migration scripts (
db:generate,db:migrate,db:push,db:studio) - HTTP and WebSocket adapter templates
- Technical references for adapters, migrations, and query patterns
Guides:
guides/new-project.md- Starting from scratchguides/existing-project.md- Adding to existing codebaseguides/schema-only.md- Schema-first developmentguides/troubleshooting.md- Common issues and solutions
Templates for:
- HTTP connections (single-query operations)
- WebSocket pooling (long-running processes)
- Connection validation utilities
Perfect for testing and CI/CD:
- Create temporary databases
- Run tests in isolation
- Clean up automatically
Includes:
create-ephemeral-db.ts- Database creationdestroy-ephemeral-db.ts- Cleanup automation- Workflow templates
Complete authentication setup with `@ne
More from this repository5
Provides Claude Code plugin skills and context rules for streamlining Neon Postgres development, enabling automated workflows, resource management, and code generation across AI development tools.
Adds documentation files and templates for Neon database projects, ensuring consistent and comprehensive documentation across Neon-related repositories and development workflows.
neon-drizzle skill from neondatabase/ai-rules
neon-js skill from neondatabase/ai-rules
Manages authentication workflows and credential handling for Neon Postgres database connections, providing secure and streamlined access configuration for development environments.