{ "schemaVersion": "1.0", "item": { "slug": "neon-postgres", "name": "Neon Postgres", "source": "tencent", "type": "skill", "category": "数据分析", "sourceUrl": "https://clawhub.ai/andrelandgraf/neon-postgres", "canonicalUrl": "https://clawhub.ai/andrelandgraf/neon-postgres", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/neon-postgres", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=neon-postgres", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/neon-postgres" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/neon-postgres", "agentPageUrl": "https://openagent3.xyz/skills/neon-postgres/agent", "manifestUrl": "https://openagent3.xyz/skills/neon-postgres/agent.json", "briefUrl": "https://openagent3.xyz/skills/neon-postgres/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Neon Serverless Postgres", "body": "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." }, { "title": "Neon Documentation", "body": "The Neon documentation is the source of truth for all Neon-related information. Always verify claims against the official docs before responding. Neon features and APIs evolve, so prefer fetching current docs over relying on training data." }, { "title": "Fetching Docs as Markdown", "body": "Any Neon doc page can be fetched as markdown in two ways:\n\nAppend .md to the URL (simplest): https://neon.com/docs/introduction/branching.md\nRequest text/markdown on the standard URL: curl -H \"Accept: text/markdown\" https://neon.com/docs/introduction/branching\n\nBoth return the same markdown content. Use whichever method your tools support." }, { "title": "Finding the Right Page", "body": "The docs index lists every available page with its URL and a short description:\n\nhttps://neon.com/docs/llms.txt\n\nCommon doc URLs are organized in the topic links below. If you need a page not listed here, search the docs index: https://neon.com/docs/llms.txt — don't guess URLs." }, { "title": "What Is Neon", "body": "Use this for architecture explanations and terminology (organizations, projects, branches, endpoints) before giving implementation advice.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/what-is-neon.md" }, { "title": "Getting Started", "body": "Use this for first-time setup: org/project selection, connection strings, driver installation, optional auth, and initial schema setup.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/getting-started.md" }, { "title": "Connection Methods & Drivers", "body": "Use this when you need to pick the correct transport and driver based on runtime constraints (TCP, HTTP, WebSocket, edge, serverless, long-running).\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/connection-methods.md" }, { "title": "Serverless Driver", "body": "Use this for @neondatabase/serverless patterns, including HTTP queries, WebSocket transactions, and runtime-specific optimizations.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-serverless.md" }, { "title": "Neon JS SDK", "body": "Use this for combined Neon Auth + Data API workflows with PostgREST-style querying and typed client setup.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-js.md" }, { "title": "Developer Tools", "body": "Use this for local development enablement with npx neonctl@latest init, VSCode extension setup, and Neon MCP server configuration.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/devtools.md" }, { "title": "Neon CLI", "body": "Use this for terminal-first workflows, scripts, and CI/CD automation with neonctl.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-cli.md" }, { "title": "Neon Admin API", "body": "The Neon Admin API can be used to manage Neon resources programmatically. It is used behind the scenes by the Neon CLI and MCP server, but can also be used directly for more complex automation workflows or when embedding Neon in other applications." }, { "title": "Neon REST API", "body": "Use this for direct HTTP automation, endpoint-level control, API key auth, rate-limit handling, and operation polling.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-rest-api.md" }, { "title": "Neon TypeScript SDK", "body": "Use this when implementing typed programmatic control of Neon resources in TypeScript via @neondatabase/api-client.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-typescript-sdk.md" }, { "title": "Neon Python SDK", "body": "Use this when implementing programmatic Neon management in Python with the neon-api package.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-python-sdk.md" }, { "title": "Neon Auth", "body": "Use this for managed user authentication setup, UI components, auth methods, and Neon Auth integration pitfalls in Next.js and React apps.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-auth.md\n\nNeon Auth is also embedded in the Neon JS SDK - so depending on your use case, you may want to use the Neon JS SDK instead of Neon Auth. See https://neon.com/docs/ai/skills/neon-postgres/references/connection-methods.md for more details." }, { "title": "Branching", "body": "Use this when the user is planning isolated environments, schema migration testing, preview deployments, or branch lifecycle automation.\n\nKey points:\n\nBranches are instant, copy-on-write clones (no full data copy).\nEach branch has its own compute endpoint.\nUse the neonctl CLI or MCP server to create, inspect, and compare branches.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/branching.md" }, { "title": "Autoscaling", "body": "Use this when the user needs compute to scale automatically with workload and wants guidance on CU sizing and runtime behavior.\n\nLink: https://neon.com/docs/introduction/autoscaling.md" }, { "title": "Scale to Zero", "body": "Use this when optimizing idle costs and discussing suspend/resume behavior, including cold-start trade-offs.\n\nKey points:\n\nIdle computes suspend automatically (default 5 minutes, configurable) (unless disabled - launch & scale plan only)\nFirst query after suspend typically has a cold-start penalty (around hundreds of ms)\nStorage remains active while compute is suspended.\n\nLink: https://neon.com/docs/introduction/scale-to-zero.md" }, { "title": "Instant Restore", "body": "Use this when the user needs point-in-time recovery or wants to restore data state without traditional backup restore workflows.\n\nKey points:\n\nRestore windows depend on plan limits.\nUsers can create branches from historical points-in-time.\nTime Travel queries can be used for historical inspection workflows.\n\nLink: https://neon.com/docs/introduction/branch-restore.md" }, { "title": "Read Replicas", "body": "Use this for read-heavy workloads where the user needs dedicated read-only compute without duplicating storage.\n\nKey points:\n\nReplicas are read-only compute endpoints sharing the same storage.\nCreation is fast and scaling is independent from primary compute.\nTypical use cases: analytics, reporting, and read-heavy APIs.\n\nLink: https://neon.com/docs/introduction/read-replicas.md" }, { "title": "Connection Pooling", "body": "Use this when the user is in serverless or high-concurrency environments and needs safe, scalable Postgres connection management.\n\nKey points:\n\nNeon pooling uses PgBouncer.\nAdd -pooler to endpoint hostnames to use pooled connections.\nPooling is especially important in serverless runtimes with bursty concurrency.\n\nLink: https://neon.com/docs/connect/connection-pooling.md" }, { "title": "IP Allow Lists", "body": "Use this when the user needs to restrict database access by trusted networks, IPs, or CIDR ranges.\n\nLink: https://neon.com/docs/introduction/ip-allow.md" }, { "title": "Logical Replication", "body": "Use this when integrating CDC pipelines, external Postgres sync, or replication-based data movement.\n\nKey points:\n\nNeon supports native logical replication workflows.\nUseful for replicating to/from external Postgres systems.\n\nLink: https://neon.com/docs/guides/logical-replication-guide.md" } ], "body": "Neon Serverless Postgres\n\nNeon 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.\n\nNeon Documentation\n\nThe Neon documentation is the source of truth for all Neon-related information. Always verify claims against the official docs before responding. Neon features and APIs evolve, so prefer fetching current docs over relying on training data.\n\nFetching Docs as Markdown\n\nAny Neon doc page can be fetched as markdown in two ways:\n\nAppend .md to the URL (simplest): https://neon.com/docs/introduction/branching.md\nRequest text/markdown on the standard URL: curl -H \"Accept: text/markdown\" https://neon.com/docs/introduction/branching\n\nBoth return the same markdown content. Use whichever method your tools support.\n\nFinding the Right Page\n\nThe docs index lists every available page with its URL and a short description:\n\nhttps://neon.com/docs/llms.txt\n\n\nCommon doc URLs are organized in the topic links below. If you need a page not listed here, search the docs index: https://neon.com/docs/llms.txt — don't guess URLs.\n\nWhat Is Neon\n\nUse this for architecture explanations and terminology (organizations, projects, branches, endpoints) before giving implementation advice.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/what-is-neon.md\n\nGetting Started\n\nUse this for first-time setup: org/project selection, connection strings, driver installation, optional auth, and initial schema setup.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/getting-started.md\n\nConnection Methods & Drivers\n\nUse this when you need to pick the correct transport and driver based on runtime constraints (TCP, HTTP, WebSocket, edge, serverless, long-running).\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/connection-methods.md\n\nServerless Driver\n\nUse this for @neondatabase/serverless patterns, including HTTP queries, WebSocket transactions, and runtime-specific optimizations.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-serverless.md\n\nNeon JS SDK\n\nUse this for combined Neon Auth + Data API workflows with PostgREST-style querying and typed client setup.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-js.md\n\nDeveloper Tools\n\nUse this for local development enablement with npx neonctl@latest init, VSCode extension setup, and Neon MCP server configuration.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/devtools.md\n\nNeon CLI\n\nUse this for terminal-first workflows, scripts, and CI/CD automation with neonctl.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-cli.md\n\nNeon Admin API\n\nThe Neon Admin API can be used to manage Neon resources programmatically. It is used behind the scenes by the Neon CLI and MCP server, but can also be used directly for more complex automation workflows or when embedding Neon in other applications.\n\nNeon REST API\n\nUse this for direct HTTP automation, endpoint-level control, API key auth, rate-limit handling, and operation polling.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-rest-api.md\n\nNeon TypeScript SDK\n\nUse this when implementing typed programmatic control of Neon resources in TypeScript via @neondatabase/api-client.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-typescript-sdk.md\n\nNeon Python SDK\n\nUse this when implementing programmatic Neon management in Python with the neon-api package.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-python-sdk.md\n\nNeon Auth\n\nUse this for managed user authentication setup, UI components, auth methods, and Neon Auth integration pitfalls in Next.js and React apps.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/neon-auth.md\n\nNeon Auth is also embedded in the Neon JS SDK - so depending on your use case, you may want to use the Neon JS SDK instead of Neon Auth. See https://neon.com/docs/ai/skills/neon-postgres/references/connection-methods.md for more details.\n\nBranching\n\nUse this when the user is planning isolated environments, schema migration testing, preview deployments, or branch lifecycle automation.\n\nKey points:\n\nBranches are instant, copy-on-write clones (no full data copy).\nEach branch has its own compute endpoint.\nUse the neonctl CLI or MCP server to create, inspect, and compare branches.\n\nLink: https://neon.com/docs/ai/skills/neon-postgres/references/branching.md\n\nAutoscaling\n\nUse this when the user needs compute to scale automatically with workload and wants guidance on CU sizing and runtime behavior.\n\nLink: https://neon.com/docs/introduction/autoscaling.md\n\nScale to Zero\n\nUse this when optimizing idle costs and discussing suspend/resume behavior, including cold-start trade-offs.\n\nKey points:\n\nIdle computes suspend automatically (default 5 minutes, configurable) (unless disabled - launch & scale plan only)\nFirst query after suspend typically has a cold-start penalty (around hundreds of ms)\nStorage remains active while compute is suspended.\n\nLink: https://neon.com/docs/introduction/scale-to-zero.md\n\nInstant Restore\n\nUse this when the user needs point-in-time recovery or wants to restore data state without traditional backup restore workflows.\n\nKey points:\n\nRestore windows depend on plan limits.\nUsers can create branches from historical points-in-time.\nTime Travel queries can be used for historical inspection workflows.\n\nLink: https://neon.com/docs/introduction/branch-restore.md\n\nRead Replicas\n\nUse this for read-heavy workloads where the user needs dedicated read-only compute without duplicating storage.\n\nKey points:\n\nReplicas are read-only compute endpoints sharing the same storage.\nCreation is fast and scaling is independent from primary compute.\nTypical use cases: analytics, reporting, and read-heavy APIs.\n\nLink: https://neon.com/docs/introduction/read-replicas.md\n\nConnection Pooling\n\nUse this when the user is in serverless or high-concurrency environments and needs safe, scalable Postgres connection management.\n\nKey points:\n\nNeon pooling uses PgBouncer.\nAdd -pooler to endpoint hostnames to use pooled connections.\nPooling is especially important in serverless runtimes with bursty concurrency.\n\nLink: https://neon.com/docs/connect/connection-pooling.md\n\nIP Allow Lists\n\nUse this when the user needs to restrict database access by trusted networks, IPs, or CIDR ranges.\n\nLink: https://neon.com/docs/introduction/ip-allow.md\n\nLogical Replication\n\nUse this when integrating CDC pipelines, external Postgres sync, or replication-based data movement.\n\nKey points:\n\nNeon supports native logical replication workflows.\nUseful for replicating to/from external Postgres systems.\n\nLink: https://neon.com/docs/guides/logical-replication-guide.md" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/andrelandgraf/neon-postgres", "publisherUrl": "https://clawhub.ai/andrelandgraf/neon-postgres", "owner": "andrelandgraf", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/neon-postgres", "downloadUrl": "https://openagent3.xyz/downloads/neon-postgres", "agentUrl": "https://openagent3.xyz/skills/neon-postgres/agent", "manifestUrl": "https://openagent3.xyz/skills/neon-postgres/agent.json", "briefUrl": "https://openagent3.xyz/skills/neon-postgres/agent.md" } }