Skip to content
Back to search

neon

MarketplaceWorks with Claude CodeGitHub

> [!IMPORTANT] > This repository has been archived. The content has moved to neondatabase/agent-skills. > > Agent Skills are now a specification supported by all major agents and coding editors,…

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/neondatabase-ai-rules/badge.svg)](/listings/neondatabase-ai-rules)

HTML

<a href="/listings/neondatabase-ai-rules"><img src="/api/listings/neondatabase-ai-rules/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

**1. Add the Neon marketplace:**

/plugin marketplace add neondatabase-labs/ai-rules

**2. Install the plugin:**

/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:

> Use the neon-drizzle skill to setup Drizzle ORM with Neon

Cursor

**1. Create rules directory:**

mkdir -p .cursor/rules

**2. Copy desired `.mdc` files:**

# 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.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 36 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "neon",
  3. "owner": {
  4. "name": "Neon",
  5. "email": "support@neon.tech",
  6. "url": "https://neon.tech"
  7. },
  8. "metadata": {
  9. "description": "Official Neon database development tools for Claude Code"
  10. },
  11. "repository": "https://github.com/neondatabase-labs/ai-rules",
  12. "homepage": "https://github.com/neondatabase-labs/ai-rules",
  13. "plugins": [
  14. {
  15. "name": "neon-plugin",
  16. "source": "./neon-plugin",
  17. "description": "Neon database development skills including authentication, Drizzle ORM, serverless drivers, and toolkit utilities",
  18. "version": "1.1.0",
  19. "keywords": [
  20. "neon",
  21. "postgres",
  22. "database",
  23. "drizzle",
  24. "serverless",
  25. "auth",
  26. "mcp"
  27. ],
  28. "license": "MIT",
  29. "author": {
  30. "name": "Neon Team",
  31. "email": "support@neon.tech",
  32. "url": "https://neon.tech"
  33. }
  34. }
  35. ]
  36. }
README.md · README · 353 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <picture>
  2. <source media="(prefers-color-scheme: dark)" srcset="https://neon.com/brand/neon-logo-dark-color.svg?new">
  3. <source media="(prefers-color-scheme: light)" srcset="https://neon.com/brand/neon-logo-light-color.svg?new">
  4. <img width="250px" alt="Neon Logo fallback" src="https://neon.com/brand/neon-logo-dark-color.svg?new">
  5. </picture>
  6. > [!IMPORTANT]
  7. > **This repository has been archived.** The content has moved to [neondatabase/agent-skills](https://github.com/neondatabase/agent-skills).
  8. >
  9. > [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.
  10. >
  11. > ```bash
  12. > npx skills add neondatabase/agent-skills
  13. > ```
  14. # Neon AI Development Toolkit
  15. 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.
  16. ## What's Inside
  17. ### For Claude Code Users
  18. - **Claude Code Plugin** - The plugin itself, which includes 6 skills and MCP server integration
  19. - **Claude Code Skills** - Interactive workflows with templates and automation scripts for Neon
  20. - **MCP Server Integration** - Direct Neon resource management (projects, branches, databases)
  21. ### For Cursor & Other AI Tools
  22. - **Portable .mdc Files** - Standalone context rules that work anywhere
  23. - **Tool-Agnostic Format** - Use with any AI assistant supporting custom rules
  24. ---
  25. ## Quick Start
  26. ### Claude Code
  27. **1. Add the Neon marketplace:**
  28. ```bash
  29. /plugin marketplace add neondatabase-labs/ai-rules
  30. ```
  31. **2. Install the plugin:**
  32. ```bash
  33. /plugin install neon-plugin@neon
  34. ```
  35. **3. Verify installation:**
  36. Ask Claude Code: "which skills do you have access to?"
  37. You should see the Neon skills listed.
  38. **4. Start using:**
  39. Use natural language and skills activate automatically:
  40. ```bash
  41. > Use the neon-drizzle skill to setup Drizzle ORM with Neon
  42. ```
  43. ### Cursor
  44. **1. Create rules directory:**
  45. ```bash
  46. mkdir -p .cursor/rules
  47. ```
  48. **2. Copy desired `.mdc` files:**
  49. ```bash
  50. # Example: Copy Drizzle and Serverless rules
  51. cp neon-drizzle.mdc .cursor/rules/
  52. cp neon-serverless.mdc .cursor/rules/
  53. ```
  54. **3. Start coding:**
  55. Cursor automatically applies these rules when you reference Neon.
  56. ### Other AI Tools
  57. 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.
  58. ---
  59. ## Skills Reference
  60. <details>
  61. <summary><strong>Neon Drizzle</strong> - Setup Drizzle ORM with Neon</summary>
  62. Complete workflow support for:
  63. - New project setup
  64. - Existing project integration
  65. - Schema-only workflows
  66. **Includes:**
  67. - Schema generation utilities
  68. - Migration scripts (`db:generate`, `db:migrate`, `db:push`, `db:studio`)
  69. - HTTP and WebSocket adapter templates
  70. - Technical references for adapters, migrations, and query patterns
  71. **Guides:**
  72. - `guides/new-project.md` - Starting from scratch
  73. - `guides/existing-project.md` - Adding to existing codebase
  74. - `guides/schema-only.md` - Schema-first development
  75. - `guides/troubleshooting.md` - Common issues and solutions
  76. </details>
  77. <details>
  78. <summary><strong>Neon Serverless</strong> - Configure serverless database connections</summary>
  79. Templates for:
  80. - HTTP connections (single-query operations)
  81. - WebSocket pooling (long-running processes)
  82. - Connection validation utilities
  83. </details>
  84. <details>
  85. <summary><strong>Neon Toolkit</strong> - Manage ephemeral databases</summary>
  86. Perfect for testing and CI/CD:
  87. - Create temporary databases
  88. - Run tests in isolation
  89. - Clean up automatically
  90. **Includes:**
  91. - `create-ephemeral-db.ts` - Database creation
  92. - `destroy-ephemeral-db.ts` - Cleanup automation
  93. - Workflow templates
  94. </details>
  95. <details>
  96. <summary><strong>Neon Auth</strong> - Integrate Neon Auth authentication</summary>
  97. Complete authentication setup with `@neondatabase/auth`:
  98. - Next.js App Router integration
  99. - React SPA setup
  100. - Auth client configuration templates
  101. - API route handlers
  102. **Guides:**
  103. - `guides/nextjs-setup.md` - Next.js App Router workflow
  104. - `guides/react-spa-setup.md` - React SPA workflow
  105. </details>
  106. <details>
  107. <summary><strong>Neon JS</strong> - Full Neon JS SDK integration</summary>
  108. Unified SDK setup with `@neondatabase/neon-js`:
  109. - Combined auth + data API client
  110. - Type-safe database operations
  111. - Theming and customization
  112. **Guides:**
  113. - `guides/setup.md` - Complete setup workflow
  114. </details>
  115. <details>
  116. <summary><strong>Add Neon Docs</strong> - Install documentation references</summary>
  117. Adds Neon best practices to your project's AI configuration:
  118. - CLAUDE.md
  119. - AGENTS.md
  120. - Cursor rules files
  121. </details>
  122. ---
  123. ## Testing & Quality Assurance
  124. Our skills are tested with automated evaluations to ensure reliability and quality.
  125. ![Neon Drizzle Skill](https://img.shields.io/badge/neon--drizzle-95.0%25%20pass-brightgreen) ![Add Neon Docs Skill](https://img.shields.io/badge/add--neon--docs-91.7%25%20pass-green)
  126. | Skill | Pass Rate | Test Date | Details |
  127. |-------|-----------|-----------|---------|
  128. | neon-drizzle | 95.0% (19/20) | Oct 29, 2025 | [View Results](neon-plugin/evals/neon-drizzle-skill/eval-results/eval-neon-drizzle-skill-2025-10-29-164501/results.md) |
  129. | add-neon-docs | 91.7% (55/60) | Oct 28, 2025 | [View Results](neon-plugin/evals/add-neon-knowledge-skill/eval-results/eval-add-neon-docs-skills-2025-10-28-192850/results.md) |
  130. **Evaluation Methodology**: Each skill is tested with multiple prompts across 10+ iterations using real Claude Code environments with the plugin loaded. Scorers validate build success, skill activation, and output correctness.
  131. ---
  132. ## Context Rules (.mdc Files)
  133. <details>
  134. <summary><strong>Getting Started</strong> - 2 files</summary>
  135. **Neon Get Started** (`neon-get-started.mdc`)
  136. - Interactive onboarding guide for connecting projects to Neon
  137. - Step-by-step setup (projects, connection strings, dependencies, schema)
  138. - Works with new or existing codebases
  139. - Communication style guidelines for AI assistants
  140. **Neon Get Started (Kiro)** (`neon-get-started-kiro.mdc`)
  141. - Kiro-specific onboarding guide
  142. </details>
  143. <details>
  144. <summary><strong>Core Integration Rules</strong> - 5 files</summary>
  145. **Neon Auth** (`neon-auth.mdc`)
  146. - Stack Auth + Neon Auth integration
  147. - Authentication patterns for user data
  148. **Neon JS** (`neon-js.mdc`)
  149. - Full Neon JS SDK with `@neondatabase/neon-js`
  150. - Combined auth + data API client
  151. **Neon Serverless** (`neon-serverless.mdc`)
  152. - Serverless connection patterns
  153. - Pooling and environment configuration
  154. - Query optimization
  155. **Neon with Drizzle** (`neon-drizzle.mdc`)
  156. - Drizzle ORM integration
  157. - Schema definition patterns
  158. - Type-safe queries
  159. **Neon Toolkit** (`neon-toolkit.mdc`)
  160. - Ephemeral database management
  161. - Testing and prototyping patterns
  162. </details>
  163. <details>
  164. <summary><strong>SDK Rules</strong> - 2 files</summary>
  165. **TypeScript SDK** (`neon-typescript-sdk.mdc`)
  166. - Programmatic database management
  167. - TypeScript-specific patterns
  168. **Python SDK** (`neon-python-sdk.mdc`)
  169. - Server-side operations
  170. - Python integration patterns
  171. </details>
  172. <details>
  173. <summary><strong>Neon API Rules</strong> - 7 files</summary>
  174. **API Guidelines** (`neon-api-guidelines.mdc`)
  175. - REST API best practices
  176. - Security and authentication
  177. **API Projects** (`neon-api-projects.mdc`)
  178. - Project management operations
  179. **API Branches** (`neon-api-branches.mdc`)
  180. - Branch management and workflows
  181. **API Endpoints** (`neon-api-endpoints.mdc`)
  182. - Compute endpoint management
  183. **API Roles** (`neon-api-organizations.mdc`)
  184. - Organization and role management
  185. **API Keys** (`neon-api-keys.mdc`)
  186. - API key management
  187. - Authentication configuration
  188. **API Operations** (`neon-api-operations.mdc`)
  189. - Operation execution
  190. - Status monitoring
  191. </details>
  192. ---
  193. ## MCP Server Integration
  194. Available automatically when you activate the Claude Code plugin.
  195. **Features:**
  196. - Manage Neon resources: projects, branches, endpoints, roles
  197. - Execute SQL queries directly from Claude
  198. - Run migrations
  199. - Analyze query performance
  200. - Optimize database operations
  201. **Configuration:** `neon-plugin/.mcp.json` connects to Neon's remote MCP service (https://mcp.neon.tech/mcp)
  202. ---
  203. ## Repository Structure
  204. ```
  205. ai-rules/
  206. ├── .claude-plugin/
  207. │ └── marketplace.json # Marketplace metadata
  208. ├── neon-plugin/ # Claude Code plugin
  209. │ ├── .claude-plugin/
  210. │ │ └── plugin.json # Plugin configuration
  211. │ ├── .mcp.json # MCP server connection
  212. │ └── skills/ # Guided skills (6 total)
  213. │ ├── add-neon-docs/ # Docs installer skill
  214. │ ├── neon-auth/ # Neon Auth skill
  215. │ ├── neon-drizzle/ # Drizzle ORM skill
  216. │ │ ├── SKILL.md
  217. │ │ ├── guides/ # Workflow guides
  218. │ │ ├── references/ # Technical docs
  219. │ │ ├── scripts/ # Automation
  220. │ │ └── templates/ # Code examples
  221. │ ├── neon-js/ # Neon JS SDK skill
  222. │ ├── neon-serverless/ # Serverless skill
  223. │ └── neon-toolkit/ # Ephemeral DB skill
  224. ├── *.mdc # Context rules (16 files)
  225. ├── LICENSE
  226. └── README.md
  227. ```
  228. ---
  229. ## FAQ
  230. **What are .mdc files?**
  231. Markdown Context files that provide guidance to AI tools. They contain best practices and patterns that AI assistants automatically apply when generating code.
  232. **Can I use specific rules without the full plugin?**
  233. Yes! Copy individual `.mdc` files to your AI tool's rules directory. Each file is self-contained and doesn't require dependencies.
  234. **How do I add or update rules?**
  235. Create a new `.mdc` file or edit existing ones. AI tools will automatically use the updated content.
  236. **Do skills work with Cursor?**
  237. Skills are Claude Code-specific. For Cursor, use the `.mdc` context rules instead.
  238. **Can I use these rules in ChatGPT or other AI tools?**
  239. Yes! The `.mdc` files work with any AI assistant that supports custom context rules. Copy them to your tool's configuration directory.
  240. ---
  241. ## Contributing
  242. We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
  243. ---
  244. ## Support
  245. - **Documentation**: https://neon.com/docs/ai/ai-rules
  246. - **Issues**: https://github.com/neondatabase-labs/ai-rules/issues
  247. - **Discord**: https://discord.com/channels/1176467419317940276/@home
  248. ---
  249. ## License
  250. MIT License - see [LICENSE](LICENSE) file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.