Skip to content
Back to search

neon

SkillGitHubIncomplete

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--agent-skills/badge.svg)](/listings/neondatabase--agent-skills)

HTML

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

Install

i

Install instructions from the README

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

npx skills add neondatabase/agent-skills

Agent Plugin

The repository root is a portable [Agent Plugins v1](https://agent-plugins.org/specification) package, so any conforming client can install it straight from this repo. The root [`plugin.json`](plugin.json) declares the plugin, [`mcp.json`](mcp.json) declares the [Neon MCP Server](https://mcp.neon.tech), and the skills are the directories under `skills/`.

The Claude Code and Cursor packaging under `plugins/` remains available for clients that expect those formats.

Antigravity Plugin

Antigravity reads its Marketplace metadata from [`.antigravity-plugin/plugin.json`](.antigravity-plugin/plugin.json) and its native Neon MCP Server configuration from [`mcp_config.json`](mcp_config.json). Install the plugin from this repository:

agy plugin install https://github.com/neondatabase/agent-skills

Confirm that Antigravity discovered the plugin, its skills, and the MCP server:

agy plugin list

To authenticate, run `/mcp` in Antigravity, select the Neon MCP server, and complete the OAuth flow.

Claude Code Plugin

You can also install the skills as a Claude Code plugin, which bundles the Neon agent skills and the [Neon MCP Server](https://mcp.neon.tech) for natural language database management:

/plugin marketplace add neondatabase/agent-skills
/plugin install neon-postgres@neon

After installation, you'll be prompted to authenticate with Neon via OAuth when you first use MCP tools.

The top-level `skills/` directory remains the source of truth. Plugin folders ship real copies of the skill directories they expose, regenerated with `npm run sync:plugins` — see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

Cursor Plugin

This repository also includes Cursor plugin packaging with the same scope as the Claude plugin (the Neon agent skills and the Neon MCP Server).

Run this command in chat:

/add-plugin neon-postgres

Kimi Code Plugin

Kimi Code CLI reads its own manifest at [`kimi.plugin.json`](kimi.plugin.json), which points at the skills under `skills/` and declares the [Neon MCP Server](https://mcp.neon.tech). Install it from this repo in chat:

/plugins install https://github.com/neondatabase/agent-skills

Plugin changes apply to new sessions, so run `/new` afterward.

Pi

You can also install the skills in [Pi](https://pi.dev) from npm:

pi install npm:@neon/skills

Or straight from this repo:

pi install git:github.com/neondatabase/agent-skills

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 · 21 lines
  1. {
  2. "name": "neon",
  3. "owner": {
  4. "name": "Andre Landgraf",
  5. "email": "andre@neon.tech"
  6. },
  7. "metadata": {
  8. "description": "Official Neon plugins for Claude Code",
  9. "version": "3.0.10"
  10. },
  11. "plugins": [
  12. {
  13. "name": "neon-postgres",
  14. "source": "./plugins/neon-postgres",
  15. "description": "Manage your Neon backend with the Neon agent skills and the Neon MCP Server: Lakebase Postgres, Managed Better Auth, Realtime, Object Storage, Functions, the Data API, and AI Gateway",
  16. "version": "3.0.10",
  17. "category": "database",
  18. "tags": ["neon", "lakebase", "postgres", "serverless", "database", "mcp"]
  19. }
  20. ]
  21. }
README.md · README · 182 lines
  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. # Agent Skills
  7. A collection of [Agent Skills](https://agentskills.io/) and agent integrations for Neon — a complete set of cloud backend primitives built around Lakebase Postgres, for developers, startups, and agent platforms, from Databricks.
  8. ## What are Agent Skills?
  9. Skills are folders of instructions, scripts, and resources that agents can discover and use to do things more accurately and efficiently. Once installed, skills are automatically invoked by the agent upon detection of relevant tasks.
  10. It all starts with the `SKILL.md` file in the skill's directory. It's the entry point and allows agents to progressively discover information as needed.
  11. ## Available Skills
  12. ### Neon
  13. [![neon](https://shieldcn.dev/skills/installs/neondatabase/agent-skills/neon.svg?variant=branded&size=xs&label=neon)](https://skills.sh/neondatabase/agent-skills/neon)
  14. An overview of Neon for apps and agents — Lakebase Postgres, Managed Better Auth, Realtime, Object Storage, Functions, the Data API, and AI Gateway — and how to get started. Includes Claimable Neon for use with no Neon account.
  15. ### Neon Postgres
  16. [![neon-postgres](https://shieldcn.dev/skills/installs/neondatabase/agent-skills/neon-postgres.svg?variant=branded&size=xs&label=neon-postgres)](https://skills.sh/neondatabase/agent-skills/neon-postgres)
  17. A comprehensive index of documentation and best practices for Lakebase Postgres on Neon, including branching workflows and egress optimization.
  18. > **Migration:** Branching and egress optimization now live in `neon-postgres`. If you previously installed `neon-postgres-branches` or `neon-postgres-egress-optimizer`, update `neon-postgres` and remove those stale local skill directories.
  19. ### Neon Auth
  20. [![neon-auth](https://shieldcn.dev/skills/installs/neondatabase/agent-skills/neon-auth.svg?variant=branded&size=xs&label=neon-auth)](https://skills.sh/neondatabase/agent-skills/neon-auth)
  21. Neon Auth (Managed Better Auth) for login, users, and sessions that branch with the database, including which Better Auth plugins are supported and when to run self-managed Better Auth on Neon instead.
  22. ### Neon Postgres Agent Platforms
  23. [![neon-postgres-agent-platforms](https://shieldcn.dev/skills/installs/neondatabase/neon-for-agent-platforms/neon-postgres-agent-platforms.svg?variant=branded&size=xs&label=neon-postgres-agent-platforms)](https://skills.sh/neondatabase/neon-for-agent-platforms/neon-postgres-agent-platforms)
  24. For agent platforms, codegen tools, and multi-tenant SaaS products that provision and run Lakebase Postgres, Object Storage, Functions, Managed Better Auth, and/or AI Gateway access for their users. Includes a companion skill and samples in [neondatabase/neon-for-agent-platforms](https://github.com/neondatabase/neon-for-agent-platforms).
  25. ### Neon Object Storage
  26. [![neon-object-storage](https://shieldcn.dev/skills/installs/neondatabase/agent-skills/neon-object-storage.svg?variant=branded&size=xs&label=neon-object-storage)](https://skills.sh/neondatabase/agent-skills/neon-object-storage)
  27. S3-compatible object storage that branches with your Neon project, so files and database rows stay in sync across dev, preview, and production environments.
  28. ### Neon AI Gateway
  29. [![neon-ai-gateway](https://shieldcn.dev/skills/installs/neondatabase/agent-skills/neon-ai-gateway.svg?variant=branded&size=xs&label=neon-ai-gateway)](https://skills.sh/neondatabase/agent-skills/neon-ai-gateway)
  30. One API and one Neon credential for frontier and open-source LLMs from multiple providers, built into your branch and compatible with the OpenAI, Anthropic, and Vercel AI SDKs.
  31. ### Neon Functions
  32. [![neon-functions](https://shieldcn.dev/skills/installs/neondatabase/agent-skills/neon-functions.svg?variant=branded&size=xs&label=neon-functions)](https://skills.sh/neondatabase/agent-skills/neon-functions)
  33. Long-running, serverless Node.js HTTP functions deployed onto your Neon branch, with `DATABASE_URL` injected automatically and compute that runs next to your data.
  34. ### Neon Realtime
  35. [![neon-realtime](https://shieldcn.dev/skills/installs/neondatabase/agent-skills/neon-realtime.svg?variant=branded&size=xs&label=neon-realtime)](https://skills.sh/neondatabase/agent-skills/neon-realtime)
  36. Neon Realtime makes any SQL query live. Build realtime, reactive apps and agents on Lakebase Postgres, with type-safe live queries and optimistic mutations.
  37. ## Installation
  38. ```bash
  39. npx skills add neondatabase/agent-skills
  40. ```
  41. ### Agent Plugin
  42. The repository root is a portable [Agent Plugins v1](https://agent-plugins.org/specification) package, so any conforming client can install it straight from this repo. The root [`plugin.json`](plugin.json) declares the plugin, [`mcp.json`](mcp.json) declares the [Neon MCP Server](https://mcp.neon.tech), and the skills are the directories under `skills/`.
  43. The Claude Code and Cursor packaging under `plugins/` remains available for clients that expect those formats.
  44. ### Antigravity Plugin
  45. Antigravity reads its Marketplace metadata from [`.antigravity-plugin/plugin.json`](.antigravity-plugin/plugin.json) and its native Neon MCP Server configuration from [`mcp_config.json`](mcp_config.json). Install the plugin from this repository:
  46. ```bash
  47. agy plugin install https://github.com/neondatabase/agent-skills
  48. ```
  49. Confirm that Antigravity discovered the plugin, its skills, and the MCP server:
  50. ```bash
  51. agy plugin list
  52. ```
  53. To authenticate, run `/mcp` in Antigravity, select the Neon MCP server, and complete the OAuth flow.
  54. ### Claude Code Plugin
  55. You can also install the skills as a Claude Code plugin, which bundles the Neon agent skills and the [Neon MCP Server](https://mcp.neon.tech) for natural language database management:
  56. ```
  57. /plugin marketplace add neondatabase/agent-skills
  58. /plugin install neon-postgres@neon
  59. ```
  60. After installation, you'll be prompted to authenticate with Neon via OAuth when you first use MCP tools.
  61. The top-level `skills/` directory remains the source of truth. Plugin folders ship real copies of the skill directories they expose, regenerated with `npm run sync:plugins` — see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
  62. ### Cursor Plugin
  63. This repository also includes Cursor plugin packaging with the same scope as the Claude plugin (the Neon agent skills and the Neon MCP Server).
  64. Run this command in chat:
  65. ```text
  66. /add-plugin neon-postgres
  67. ```
  68. ### Kimi Code Plugin
  69. Kimi Code CLI reads its own manifest at [`kimi.plugin.json`](kimi.plugin.json), which points at the skills under `skills/` and declares the [Neon MCP Server](https://mcp.neon.tech). Install it from this repo in chat:
  70. ```text
  71. /plugins install https://github.com/neondatabase/agent-skills
  72. ```
  73. Plugin changes apply to new sessions, so run `/new` afterward.
  74. ### Pi
  75. You can also install the skills in [Pi](https://pi.dev) from npm:
  76. ```bash
  77. pi install npm:@neon/skills
  78. ```
  79. Or straight from this repo:
  80. ```bash
  81. pi install git:github.com/neondatabase/agent-skills
  82. ```
  83. ## Usage
  84. Example prompts:
  85. ```
  86. Get started with Neon
  87. ```
  88. ```
  89. Recommend a connection method for this project
  90. ```
  91. ```
  92. Set up Drizzle ORM with Neon
  93. ```
  94. ```
  95. Set up Neon Auth for my Next.js app
  96. ```
  97. ```
  98. Query the database using neon-js
  99. ```
  100. ```
  101. Create a new Neon branch using the API
  102. ```
  103. ```
  104. Use the serverless driver for edge functions
  105. ```
  106. ```
  107. Give me a quick temporary Postgres database
  108. ```
  109. ```
  110. Why is my Neon bill so high?
  111. ```

Ratings and comments

Sign in to rate this skill.

Sign in

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