CtrlK
BlogDocsLog inGet started
Tessl Logo

claimable-postgres

Provision instant temporary Postgres databases via Claimable Postgres by Neon (pg.new). No login or credit card required. Use for quick Postgres environments and throwaway DATABASE_URL for prototyping.

63

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/claimable-postgres/SKILL.md

The canonical home for this skill is claimable-postgres in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

77%Scale 1-5

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

This is a well-crafted skill with excellent actionability and workflow clarity. The two agent workflow paths (API and CLI) are thoroughly documented with concrete commands, validation steps, and clear output expectations. The main weakness is that the content is somewhat verbose for a single file—it could benefit from splitting reference material (CLI options, SDK details, limits tables) into separate bundle files to improve progressive disclosure and reduce token cost for simpler use cases.

Suggestions

Extract the CLI options table, SDK usage, and Vite plugin details into separate bundle files (e.g., CLI.md, SDK.md) and reference them from the main SKILL.md to improve progressive disclosure and reduce token load.

Trim explanatory phrases that Claude can infer, such as 'Claiming is optional. The database works immediately without it.' and the detailed descriptions in the 'Which Method?' section, to improve conciseness.

DimensionReasoningScore

Conciseness

The skill is fairly comprehensive but includes some unnecessary verbosity. The 'Which Method?' section explains when to use each method in ways Claude could infer. The detailed CLI options table, full API response example, and defaults/limits tables add bulk. Some sections like 'Claiming' over-explain (e.g., 'Claiming is optional. The database works immediately without it.'). However, most content is genuinely useful reference material rather than explaining concepts Claude already knows.

3 / 5

Actionability

Excellent actionability throughout. The skill provides copy-paste ready curl commands, CLI invocations with exact flags, SDK code examples, and specific psql commands for seeding. Error responses are documented with HTTP codes. The agent workflow sections give precise step-by-step instructions with concrete commands at each step.

5 / 5

Workflow Clarity

Both the API and CLI workflow paths are clearly sequenced with numbered steps, validation checkpoints (check .env before running, confirm intent, verify output), and an output checklist. The CLI path includes a pre-run check with three explicit resolution options. The safety notes section adds additional guardrails for destructive operations (ask before destructive SQL, check .gitignore). Feedback loops are present (check existing key → offer alternatives → get confirmation).

5 / 5

Progressive Disclosure

The content is entirely self-contained in a single file with no bundle files. At ~200+ lines, some content (like the full CLI options table, SDK details, Vite plugin details, defaults/limits tables) could be split into separate reference files. The document does have good section headers and internal linking (#which-method), but the monolithic structure means Claude loads everything even when only the API path is needed. The Vite plugin section appropriately links to external docs, but overall the file is heavier than ideal for a single SKILL.md.

3 / 5

Total

16

/

20

Passed

Description

73%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.

This is a solid description that clearly identifies a specific niche (instant temporary Postgres provisioning via pg.new/Neon) with good trigger terms and reasonable completeness. Its main weaknesses are slightly limited specificity about what actions are supported beyond provisioning, and the 'when' guidance could be more explicitly structured with additional trigger scenarios like 'PostgreSQL' or 'test database'.

Suggestions

Add common synonyms like 'PostgreSQL', 'test database', 'sandbox', or 'ephemeral database' to improve trigger term coverage.

Expand the 'Use for...' clause into a more explicit 'Use when...' format listing specific trigger scenarios, e.g., 'Use when the user needs a quick PostgreSQL database, asks for a throwaway DB for prototyping, or mentions pg.new'.

DimensionReasoningScore

Specificity

Names the domain (temporary Postgres databases) and a couple of concrete actions (provision databases, get throwaway DATABASE_URL), but doesn't comprehensively list what can be done beyond provisioning — e.g., no mention of managing, querying, or tearing down databases.

3 / 5

Completeness

The 'what' is clear (provision instant temporary Postgres databases via Neon's pg.new). The 'when' is present ('Use for quick Postgres environments and throwaway DATABASE_URL for prototyping') but could be more explicit with a formal 'Use when...' clause listing specific trigger scenarios.

4 / 5

Trigger Term Quality

Includes good natural keywords like 'Postgres', 'databases', 'DATABASE_URL', 'prototyping', 'pg.new', and 'temporary'. Missing some common synonyms or variations users might say like 'PostgreSQL', 'test database', 'sandbox database', 'ephemeral', or 'disposable database'.

4 / 5

Distinctiveness Conflict Risk

Highly distinctive — the combination of 'Claimable Postgres by Neon', 'pg.new', temporary/throwaway databases, and no-login provisioning creates a very clear niche with minimal risk of conflicting with other skills.

5 / 5

Total

16

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.