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.
80
31%
Does it follow best practices?
Impact
96%
1.14xAverage score across 8 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/neki/SKILL.mdQuality
Discovery
40%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 description has a clear 'when to use' clause but fails to explain what the skill actually does beyond providing 'overview and information.' The lack of concrete actions and capabilities makes it difficult for Claude to understand what this skill enables. The trigger terms are adequate but could be expanded to include more natural user language.
Suggestions
Replace 'Overview and information about Neki' with specific actions like 'Configure sharding strategies, troubleshoot replication issues, optimize query routing for Neki'
Add concrete capabilities such as 'set up shard keys, migrate existing Postgres databases, monitor shard health'
Expand trigger terms to include variations like 'PostgreSQL', 'database scaling', 'horizontal partitioning', 'distributed Postgres'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'Overview and information' and 'Neki-related tasks' without listing any concrete actions. It doesn't specify what operations or capabilities the skill provides. | 1 / 3 |
Completeness | Has explicit 'Load when...' clauses addressing when to use it, but the 'what' portion is weak - 'Overview and information' doesn't explain what the skill actually does or what actions it enables. | 2 / 3 |
Trigger Term Quality | Includes some relevant keywords like 'Postgres', 'sharding', 'scaling', and 'shard postgres', but missing common variations users might say like 'database performance', 'horizontal scaling', 'distributed database', or 'PostgreSQL'. | 2 / 3 |
Distinctiveness Conflict Risk | The product name 'Neki' and 'PlanetScale' provide some distinctiveness, but 'Postgres scaling or sharding issues' could overlap with general database skills or other Postgres-related skills. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill reads more like a product announcement or marketing brief than actionable technical guidance. It explains what Neki is and links to external resources, but provides no concrete instructions, code examples, or workflows for Claude to follow when helping users with Postgres sharding tasks. The 'not yet released' caveat further limits its practical utility.
Suggestions
Add concrete, actionable guidance for evaluating whether a Postgres database is ready for sharding (schema checks, query patterns to avoid, etc.)
Include executable code examples or SQL queries that demonstrate sharding-related concepts or preparation steps
Define a clear workflow for assessing sharding readiness with validation checkpoints (e.g., 'Run this query to check for problematic patterns')
Remove marketing language and focus on technical content that Claude doesn't already know about Postgres scaling
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably efficient but includes some unnecessary marketing language ('deep expertise', 'proven infrastructure', 'track record') and explains what PlanetScale/Vitess are, which Claude likely knows. The overview could be tighter. | 2 / 3 |
Actionability | The skill provides no concrete code, commands, or executable guidance. It's entirely descriptive/informational about what Neki is, with no actionable instructions for actually using or working with it. | 1 / 3 |
Workflow Clarity | There are no workflows, steps, or processes defined. The skill is purely informational with no guidance on how to perform any tasks related to Neki or sharding preparation. | 1 / 3 |
Progressive Disclosure | There is a reference to a sharding-readiness document which is good, but the main content is thin and the single reference doesn't justify the structure. The resources table is well-formatted but there's only one entry. | 2 / 3 |
Total | 6 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- planetscale/database-skills
- Commit
b156f4c
- 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.