using-neon – Writing & Content skill for AI agents
Neon is a serverless Postgres platform that separates compute and storage to offer autoscaling, branching, instant restore, and scale-to-zero. It's fully compatible with Postgres and works with any language, framework, or ORM that supports Postgres.
Install the using-neon skill with one command
Pick the tool you use, copy the command and paste it in your terminal. The skill lands in that tool's skills folder and is ready in your next session.
Claude Code
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/using-neon-c8e38.tgz | tar xz -C ~/.claude/skills
Call it in Claude Code: /using-neon – then describe the task you want done.
Codex
mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/using-neon-c8e38.tgz | tar xz -C ~/.codex/skills
Call it in Codex: $using-neon – then describe the task you want done.
Hermes Agent
mkdir -p ~/.hermes/skills && curl -fsSL https://skill.dn1nguoi.com/z/using-neon-c8e38.tgz | tar xz -C ~/.hermes/skills
Call it in Hermes Agent: /using-neon – then describe the task you want done.
DeepSeek
mkdir -p ~/.deepcode/skills && curl -fsSL https://skill.dn1nguoi.com/z/using-neon-c8e38.tgz | tar xz -C ~/.deepcode/skills
Call it in DeepSeek: /using-neon – then describe the task you want done.
SKILL.md content
Supporting material availability
This catalog copy contains the inline guidance below, but does not include the following supporting paths. They are external prerequisites, not bundled files:
<support-root>/references/what-is-neon.md<support-root>/references/referencing-docs.md<support-root>/references/features.md<support-root>/references/getting-started.md<support-root>/references/connection-methods.md<support-root>/references/devtools.md<support-root>/references/neon-serverless.md<support-root>/references/neon-drizzle.md<support-root>/references/neon-auth.md<support-root>/references/neon-js.md<support-root>/references/neon-platform-api.md<support-root>/references/neon-cli.md<support-root>/references/neon-typescript-sdk.md<support-root>/references/neon-python-sdk.md
Obtain the required material from the [declared upstream source](https://github.com/neondatabase/agent-skills/tree/main/skills/neon-postgres), or from a user-provided installation of that source. Resolve each path relative to that installation, inspect its contents, and verify any applicable license and execution prerequisites. Do not run a command or claim a referenced procedure was followed until its required file exists. Do not fabricate the missing scripts or treat an unrelated file with the same name as equivalent. Independent steps fully documented here can proceed within the user’s authorized scope; report any dependent step as unavailable.
Neon Serverless Postgres
Neon is a serverless Postgres platform that separates compute and storage to offer autoscaling, branching, instant restore, and scale-to-zero. It's fully compatible with Postgres and works with any language, framework, or ORM that supports Postgres.
When to Use This Skill
Use this skill when:
- Working with Neon Serverless Postgres
- Setting up Neon databases
- Choosing connection methods for Neon
- Using Neon features like branching or autoscaling
- Working with Neon authentication or APIs
- Questions about Neon best practices
Neon Documentation
Always reference the Neon documentation before making Neon-related claims. The documentation is the source of truth for all Neon-related information.
Below you'll find a list of resources organized by area of concern. This is meant to support you find the right documentation pages to fetch and add a bit of additonal context.
You can use the curl commands to fetch the documentation page as markdown:
Documentation:
# Get list of all Neon docs
curl https://neon.com/llms.txt
# Fetch any doc page as markdown
curl -H "Accept: text/markdown" "https://neon.com/docs/REPLACE_WITH_DISCOVERED_PATH"Don't guess docs pages. Use the llms.txt index to find the relevant URL or follow the links in the resources below.
Overview of Resources
Reference the appropriate resource file based on the user's needs:
Core Guides
| Area | Resource | When to Use |
| ------------------ | ---------------------------------- | -------------------------------------------------------------- |
| What is Neon | references/what-is-neon.md | Understanding Neon concepts, architecture, core resources |
| Referencing Docs | references/referencing-docs.md | Looking up official documentation, verifying information |
| Features | references/features.md | Branching, autoscaling, scale-to-zero, instant restore |
| Getting Started | references/getting-started.md | Setting up a project, connection strings, dependencies, schema |
| Connection Methods | references/connection-methods.md | Choosing drivers based on platform and runtime |
| Developer Tools | references/devtools.md | VSCode extension, MCP server, Neon CLI (neon init) |
Database Drivers & ORMs
HTTP/WebSocket queries for serverless/edge functions.
| Area | Resource | When to Use |
| ----------------- | ------------------------------- | --------------------------------------------------- |
| Serverless Driver | references/neon-serverless.md | @neondatabase/serverless - HTTP/WebSocket queries |
| Drizzle ORM | references/neon-drizzle.md | Drizzle ORM integration with Neon |
Auth & Data API SDKs
Authentication and PostgREST-style data API for Neon.
| Area | Resource | When to Use |
| ----------- | ------------------------- | ------------------------------------------------------------------- |
| Neon Auth | references/neon-auth.md | @neondatabase/auth - Authentication only |
| Neon JS SDK | references/neon-js.md | @neondatabase/neon-js - Auth + Data API (PostgREST-style queries) |
Neon Platform API & CLI
Managing Neon resources programmatically via REST API, SDKs, or CLI.
| Area | Resource | When to Use |
| --------------------- | ----------------------------------- | -------------------------------------------- |
| Platform API Overview | references/neon-platform-api.md | Managing Neon resources via REST API |
| Neon CLI | references/neon-cli.md | Terminal workflows, scripts, CI/CD pipelines |
| TypeScript SDK | references/neon-typescript-sdk.md | @neondatabase/api-client |
| Python SDK | references/neon-python-sdk.md | neon-api package |
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
Related skills
- verify-citations – Verify citations and references in a document, report, or article against real sources…
- video-content-extractor – Extract key frames from MP4 videos at configurable intervals, run Tesseract OCR, and…
- wechat-cover-maker – Install and use the official WeChat Article Cover package, pinned by digest, for paid…
- wechat-official-account-strategist – Grow WeChat Official Accounts (微信公众号) with high-conversion content strategy, title…
- why-did-this-post-flop – Diagnose why one Twitter/X or LinkedIn post underperformed: not seen, seen and skipped…
- wiki-changelog – Generate structured changelogs from git history. Use when user asks \"what changed…
- wiki-page-writer – You are a senior documentation engineer that generates comprehensive technical…
- write-in-my-voice – Draft a Twitter/X or LinkedIn post that sounds like the person asking, from posts they…