CtrlK
BlogDocsLog inGet started
Tessl Logo

neon-object-storage

S3-compatible object storage that branches with your Neon project, so files and the database stay in sync across every branch. Use when a user wants object storage, a bucket, blob/file storage, or somewhere to put uploads, images, documents, avatars, or user-generated files for their app or agent — especially when they already use (or are setting up) Lakebase Postgres and don't want to add a separate storage provider like AWS S3, Cloudflare R2, or Supabase Storage. Triggers include "object storage", "bucket", "blob storage", "file storage", "store uploads/images/files", "S3-compatible storage", "presigned URL", "where do I put files", "storage logs", "bucket logs", "CDN in front of object storage", "Neon Object Storage", "Neon Storage", and "storage that branches with my database".

70

Quality

86%

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

82%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 well-structured, highly actionable body with executable code, commands, and a clear precondition-to-usage sequence, appropriate for a product skill whose details Claude cannot know. Its main costs are duplication (description restated in When to Use, region list twice) and a couple of long prose sections that could be tightened or moved to references.

Suggestions

Remove duplication: state the region list once (drop it from the intro since Availability covers it) and trim the 'When to Use' bullets that restate the frontmatter description.

Tighten the Architecture section's CDN/Cache-Control prose to the operative rules (new key per version, repoint the Postgres key) and move the extended reasoning to a reference file.

Add a quick post-deploy verification step (e.g., `neon bucket list` after `neon deploy`) so the setup workflow has an explicit checkpoint.

DimensionReasoningScore

Conciseness

Mostly efficient product-specific detail Claude cannot know (branch-scoped credentials, path-style requirement, env var names, CLI commands), but there is trimmable duplication: the region list appears twice (intro and Availability), and the 'When to Use' bullets restate the frontmatter description almost verbatim. Fits 'efficient; minor instances of over-explanation that could be trimmed', not 5 because of that duplication and the somewhat marketing-flavored prose.

4 / 5

Actionability

Fully executable throughout: a complete neon.ts bucket declaration, `neon deploy`/`config plan`/`config apply` commands, an env-var table, copy-paste Files SDK code (upload/download/presign), and raw AWS S3 client code with the critical `forcePathStyle: true` detail. Covers the common cases end-to-end; not below 5 since no key detail is missing from the primary flows.

5 / 5

Workflow Clarity

The sequence is coherent and well-ordered (region precondition check → declare buckets → deploy → env pull → client usage), with `neon config plan` as a dry-run checkpoint and explicit 'Confirm the user's Neon project is in one of these regions before proceeding'. It falls short of 5 because post-deploy verification (e.g., confirming buckets exist) and error-recovery loops for failed uploads are not addressed.

4 / 5

Progressive Disclosure

With no bundle files, the body is one level deep and well-sectioned, delegating shared Neon material to the parent `neon` skill and official doc URLs, which are clearly signaled (Further Reading list, doc-fetching convention). A 5 would require the bulky inline code examples (both full SDK walkthroughs) to be split out or the duplication between sections reduced.

4 / 5

Total

17

/

20

Passed

Description

91%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 description that explicitly covers what the skill provides and when to use it, with an unusually rich set of natural trigger phrases and clear product scoping. The only weaknesses are minor overlap risk on generic storage terms and a capability-oriented (rather than action-oriented) framing.

DimensionReasoningScore

Specificity

The description states several concrete capabilities — "S3-compatible object storage that branches with your Neon project", "files and the database stay in sync across every branch", presigned URLs — rather than vague language, matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because it describes the product's capabilities more than a comprehensive list of concrete actions Claude will perform.

4 / 5

Completeness

It clearly answers both questions: what ("S3-compatible object storage that branches with your Neon project, so files and the database stay in sync") and when ("Use when a user wants object storage, a bucket, blob/file storage, or somewhere to put uploads..."), with concrete trigger phrases — the exact 5-anchor example pattern. Not below 5 since neither half is missing or vague.

5 / 5

Trigger Term Quality

The trigger list is comprehensive and natural: "object storage", "bucket", "blob storage", "file storage", "store uploads/images/files", "presigned URL", "where do I put files", "storage logs", plus product names and synonyms (uploads, images, documents, avatars, user-generated files). These are exactly the phrases a user would say, matching the 'comprehensive coverage including synonyms' anchor; nothing above this anchor exists.

5 / 5

Distinctiveness Conflict Risk

The Neon/Lakebase scoping ("especially when they already use... Lakebase Postgres") carves a clear niche, but generic triggers like "bucket", "file storage", and "presigned URL" overlap with AWS S3 / Cloudflare R2 / Supabase Storage skills, so it fits 'mostly distinct; minor overlap risk with closely related skills'. A 5 would require minimal overlap even on the generic terms.

4 / 5

Total

18

/

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.