claimable-postgres

Claimable Postgres is a skill for provisioning instant, temporary Postgres databases through Neon's neon.new service with no login, signup, or credit card. It solves the friction of needing a real database right now — for local development, demos, prototyping, or test environments — by returning a working connection string in seconds. Databases expire after 72 hours unless claimed to a Neon account, and the skill surfaces the claim URL so users can keep any database they want to persist. It is a child of the parent neon skill, which it directs the agent to consult first for platform context.

The skill documents four provisioning methods and helps choose between them: a REST API that returns structured JSON (preferred for predictable output), a CLI (npx neon-new) that provisions and writes .env in one command, an SDK for programmatic Node.js use, and a Vite plugin that auto-provisions when DATABASE_URL is missing. It provides step-by-step agent workflows for the API and CLI paths, an output checklist, and clear safety and UX guidance: never overwrite an existing env var without confirmation, ask before running destructive seed SQL such as DROP or TRUNCATE, recommend standard Neon provisioning for production workloads, tell users to open the claim URL promptly if they need persistence, and check that any .env holding credentials is covered by .gitignore. The REST reference documents the create and status endpoints, the response shape, the ref tracking tag, optional logical replication, and pooled versus direct connection strings.

It is aimed at developers and coding agents who need a throwaway DATABASE_URL for prototyping and tests without the overhead of account setup.