1. Habit
  2. Skills
  3. Neon Functions skill
neondatabase · 26K installs

Neon Functions skill
Runs by itself, function code changed.

Functions deploy locked down.

Install the Neon Functions skill and make it a habit: follow https://gethabit.dev/skills/neondatabase/neon-functions.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

26K installs103 starsApache-2.0 licenceSource on GitHub ↗

Neon Functions

by neondatabase · 26K installs

The skill

The neon functions skill helps developers deploy long-running Node.js HTTP functions on a Neon branch, for APIs, agents, WebSocket and SSE servers, webhooks and MCP servers.

Only when you ask.

The habit

Functions deploy locked down.

↻ Runs by itselffunction code changed

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

function code changed. Runs in GitHub Actions or Claude Code routine.

  • ↻ function code changed
  • push touching neon.ts or src/**

02

It checks its work

auth holds after deploy. If a check fails, it stops.

  • ✓neon config plan shows no pending change after deploy
  • ✓a request without a bearer token gets 401 from the invocation URL
  • ✓one test user cannot read another user's rows
  • ✓every new Pool is followed by attachDatabasePool(pool)

03

It remembers

deploy check log. The next run reads it first: slugs, URLs and failed checks from last run.

loops/neon-function-deploy-check-loop/run-log.md

One run, step by step.
Then it stops.

Stop ruleStops after one branch deploy per run, with at most one retry.

  1. 01

    Load neon skill

    The agent first uses the parent neon skill for the branch-first workflow, as this skill asks.

  2. 02

    Check region

    It confirms the project is in a region where Neon Functions is available.

  3. 03

    Check the code

    It looks for a module-scope pg pool with a small max, attachDatabasePool, and env keys present in the --env file.

  4. 04

    Plan and deploy

    It runs neon config plan, then neon deploy --env <file>.

  5. 05

    Get the URL

    It reads the invocation_url with neon functions get <slug>.

  6. 06

    Test auth

    It calls the URL without a token and as two users to confirm access stays scoped.

  7. 07

    Read logs and record

    It checks neon logs query with source function, then writes results to the run log.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the Neon Functions skill helps.

Use it when

  • ✓ Your agent stream outlasts lambda timeouts
  • ✓ You need a WebSocket or SSE server
  • ✓ You want a backend that branches with your data

Skip it when

  • – You host a static site
  • – Your region is not supported

Questions

Neon Functions skill, answered.

Why test auth on every deploy?

The skill warns that each function has a public HTTPS URL that anyone can reach, so the function must check callers itself.

Do trigger routes need a user token?

No. The skill says Function Trigger routes use parseTriggerDelivery instead of a user JWT.

How do I install the Neon Functions skill?

Copy the prompt at the top into your agent. It installs the skill from neondatabase/agent-skills and sets up the habit. Or run npx skills add neondatabase/agent-skills --skill neon-functions.

Is the Neon Functions skill free?

Yes. It is published under Apache-2.0. Habit is free too.

Neon Functions. Now as a habit.

Install the Neon Functions skill and make it a habit: follow https://gethabit.dev/skills/neondatabase/neon-functions.md

  • Free
  • No account
  • Undo in one line

All neondatabase skills →More ops skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by neondatabase, published under Apache-2.0. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.