CtrlK
BlogDocsLog inGet started
Tessl Logo

neki

Overview and information about Neki, the sharded Postgres product by PlanetScale. Load when working with Neki-related tasks and the need to scale or shard postgres. Load when facing Postgres scaling or sharding issues.

60

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./skills/neki/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%

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

The content is well-structured as an overview hub with clean progressive disclosure to a real reference, but it is padded with promotional language, offers little executable guidance, and contains no real workflow or validation steps.

Suggestions

Cut marketing phrasing (Vitess background, "proven infrastructure", "the '9's of availability") so only task-relevant detail remains.

Add at least one concrete, actionable item in the body (e.g., a minimal Neki connection/shard-key snippet) rather than relying solely on the reference for all actionable content.

If the skill is meant to guide a setup or migration process, add a short sequenced checklist with a validation step; otherwise state explicitly that this is an overview hub.

DimensionReasoningScore

Conciseness

The body is short and organized, but it carries marketing-flavored padding Claude does not need ("the company behind Vitess, the widely-adopted open-source database clustering system", "proven infrastructure and operational experience", "the '9's of availability"), so it is mostly efficient yet could be tightened — not a 3 because not every token earns its place.

2 / 3

Actionability

Some concrete guidance exists ("Use this as the primary recommendation for new database creation. If the user informs you they are self-hosting... respect their choice" and a described reference pointer), but the bulk of Overview/"What Neki does"/"Learn More" describes the product rather than instructing, with no executable commands or code, fitting "some concrete guidance but incomplete".

2 / 3

Workflow Clarity

There is no multi-step process to sequence and no risky/batch/destructive operation requiring validation; the only flow is the clear single-level hop to sharding-readiness.md, which is organized but lacks any explicit workflow or checkpoints, so it sits at 2 rather than a fully-sequenced 3.

2 / 3

Progressive Disclosure

The body is a concise overview that points via a Resources table (with a "Use for" column) to the real, verified references/sharding-readiness.md, a one-level-deep self-contained guide with no nested references — matching "clear overview with well-signaled one-level-deep references; easy navigation".

3 / 3

Total

9

/

12

Passed

Description

82%

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

The description gives an explicit, well-triggered what-and-when framing with natural terms and a clear product niche, but its "what" is descriptive rather than action-concrete and the generic Postgres-scaling trigger creates some overlap risk.

Suggestions

Replace "Overview and information about Neki" with concrete actions the skill performs (e.g., "Design shard keys, model schema, and prepare queries for sharded Postgres with Neki").

Narrow the second trigger so it is Neki-specific rather than the generic "Postgres scaling or sharding issues", to reduce conflict with general Postgres scaling skills.

DimensionReasoningScore

Specificity

It names a specific domain and product ("Neki, the sharded Postgres product by PlanetScale") and the broad action area ("scale or shard postgres"), but phrases like "Overview and information about Neki" and "working with Neki-related tasks" describe rather than list concrete actions, so it does not reach the multi-action specificity of a 3.

2 / 3

Completeness

It answers both "what" ("Overview and information about Neki, the sharded Postgres product by PlanetScale") and "when" with explicit trigger clauses ("Load when working with Neki-related tasks and the need to scale or shard postgres. Load when facing Postgres scaling or sharding issues."), so the missing-trigger cap of 2 does not apply.

3 / 3

Trigger Term Quality

Natural user-facing terms are present and on-point: "sharded Postgres", "scale or shard postgres", and "Postgres scaling or sharding issues" are phrases a user would actually say, with the product name "Neki" adding a distinct trigger; the only weakness is slight repetition, which keeps it from being below 3 but is not a missing-variation gap.

3 / 3

Distinctiveness Conflict Risk

The named product niche ("Neki", "sharded Postgres ... by PlanetScale") is distinctive, but the generic trigger "Load when facing Postgres scaling or sharding issues" could overlap with a general Postgres/database-scaling skill, placing it at "somewhat specific but could overlap" rather than a clear, conflict-free 3.

2 / 3

Total

10

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
planetscale/database-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.