CtrlK
BlogDocsLog inGet started
Tessl Logo

neon

Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres: Auth, Object Storage, Functions, and the AI Gateway. Start here to choose Neon for undecided login, files, APIs, and LLM calls, set up the CLI or MCP server, and follow the branch-first workflow. Use when building an app or backend on Neon, or when "Neon" or "Lakebase Postgres" is mentioned. Child skill neon-postgres wins for an existing DATABASE_URL, SQL, schema, inspect, or search. Child skill neon-auth wins for login, users, sessions, identity routing, and Managed Better Auth setup. Also use for object storage, S3, buckets, serverless functions, function triggers, cron, AI gateway, LLM calls, logs, Loki, Grafana, observability, postgres, database, backend, Claimable Neon, neon.new, or a no-signup database.

69

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, highly actionable overview with strong sequencing, real validation checkpoints, and a genuine reference bundle used appropriately. Its main cost is length driven by repetition — the Data API, env-pull, and region guidance each appear multiple times — plus an inline neon.ts deep dive that should live in a reference file.

Suggestions

Consolidate the Data API guidance (currently stated at least four times across Backend Primitives, Architecture, the needs table, Choosing the Right Skill, neon init, Claimable, and the IaC sections) into one canonical placement, likely the Backend Primitives bullet plus one pointer.

Move the neon.ts / type-safe-config deep dive (defineConfig examples, branch() policy, Data API type errors) into a reference file (e.g. references/neon-ts.md), keeping only the plan/apply/delay reconciliation loop and a pointer inline; also make body reference links point at the local bundle files rather than neon.com URLs so the skill works offline.

Deduplicate the repeated env-pull-by-default note (stated in Useful CLI Commands, Branch-First Dev Flow, and the checkout composition paragraph) and the verbatim-duplicated supported-region list (Region availability and Observability) into one canonical mention with a pointer.

DimensionReasoningScore

Conciseness

The body is product-specific (no padding about concepts Claude already knows), but guidance is noticeably repeated: the Data API caution appears at least four times ("Use it only when the app already uses PostgREST...", "Do not recommend this for new apps", "There is no neon-data-api skill", "Use data-api only for PostgREST / Supabase database-client compatibility"), the "link and checkout run this for you by default" env-pull note repeats three times, and the supported-region list is duplicated verbatim. Mostly efficient but could be tightened — anchor 3, not 2 since nothing explains generic known concepts.

3 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: exact CLI commands with flags ("neon init --agent cursor --org-id <org-id> --project-id <project-id> -y", "neon mcp --oauth --project --agent <agent> -y"), complete defineConfig TypeScript examples, install commands, and concrete flag semantics ("-y skips prompts but does not supply project selection or credentials"). Specific examples cover the common setup, deploy, branch, and logging cases.

5 / 5

Workflow Clarity

Setup and convert-app flows are clearly sequenced with most checkpoints present: "Verify the app flow (sign-in, upload, API call), not only that env vars landed", the "neon config plan" dry-run before apply, env-pull failing fast and pointing at "neon deploy --env <file>", and auth failures routed to "stop and ask the user to sign in". Not 5 because the combined-init and manual-steps paths interleave without a single top-level sequence, and a few checkpoints are implicit (no explicit post-deploy verification step).

4 / 5

Progressive Disclosure

Six real one-level-deep reference files exist in the bundle and are clearly signaled in the body ("[references/logs-loki.md]", "[references/claimable-neon.md]"), with deep material (Claimable flow, trigger parsers, LogQL, SDK, parseEnv) correctly pushed out of the overview. Not 5 because the ~130-line neon.ts / type-safe-config section is detailed inline material that belongs in a reference (it points only to a docs URL, no bundle file), and body reference links point to web URLs rather than the local bundle files.

4 / 5

Total

16

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong dispatcher-style description: it states the product scope concretely, gives explicit and varied trigger phrases, answers both what and when clearly, and routes to child skills to reduce conflict. The only weakness is a tail of very generic keywords (postgres, database, backend, logs) that could fire on non-Neon contexts.

DimensionReasoningScore

Specificity

Enumerates the full capability surface ("Auth, Object Storage, Functions, and the AI Gateway") and multiple concrete actions ("choose Neon for undecided login, files, APIs, and LLM calls, set up the CLI or MCP server, and follow the branch-first workflow"). Coverage is comprehensive with no minor gaps, matching the anchor-5 pattern rather than anchor 4.

5 / 5

Completeness

Explicitly answers both what ("Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres") and when ("Use when building an app or backend on Neon, or when 'Neon' or 'Lakebase Postgres' is mentioned", plus an "Also use for" list). Both are concrete and explicit, matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Comprehensive natural trigger terms including synonyms and product-specific phrases: "login, files, APIs, LLM calls... S3, buckets, cron, AI gateway, logs, Loki, Grafana, postgres, database, backend, Claimable Neon, neon.new, or a no-signup database" plus "DATABASE_URL, SQL, schema, inspect, or search". Essentially no natural term a user would say is missing.

5 / 5

Distinctiveness Conflict Risk

Child-skill delegation ("Child skill neon-postgres wins for an existing DATABASE_URL...") actively disambiguates within the Neon family, but the broad tail terms ("postgres, database, backend, logs, observability") overlap with generic Postgres and observability skills. Mostly distinct with minor overlap risk — anchor 4, not 5.

4 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
stevenknowswhy/ProfessionalBuyer
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.