CtrlK
BlogDocsLog inGet started
Tessl Logo

managing-database-sharding

Process use when you need to work with database sharding. This skill provides horizontal sharding strategies with comprehensive guidance and automation. Trigger with phrases like "implement sharding", "shard database", or "distribute data".

Install with Tessl CLI

npx tessl i github:jeremylongshore/claude-code-plugins-plus-skills --skill managing-database-sharding
What are skills?

62

Quality

55%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/database/database-sharding-manager/skills/managing-database-sharding/SKILL.md
SKILL.md
Review
Evals

Discovery

89%

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 effectively communicates when to use the skill with explicit trigger phrases and establishes a clear niche around database sharding. However, it lacks specificity in describing concrete actions - 'comprehensive guidance and automation' is vague compared to listing specific capabilities like configuring shard keys, rebalancing data, or setting up routing.

Suggestions

Replace 'comprehensive guidance and automation' with specific actions like 'configure shard keys, partition tables, set up routing logic, rebalance data across shards'

Add more trigger term variations such as 'partition data', 'horizontal scaling', 'distributed database'

DimensionReasoningScore

Specificity

Names the domain (database sharding) and mentions 'horizontal sharding strategies' and 'automation', but lacks concrete specific actions like 'partition tables', 'configure shard keys', or 'migrate data between shards'.

2 / 3

Completeness

Clearly answers both what ('horizontal sharding strategies with comprehensive guidance and automation') and when ('Trigger with phrases like...'). Has explicit trigger guidance.

3 / 3

Trigger Term Quality

Explicitly lists natural trigger phrases users would say: 'implement sharding', 'shard database', 'distribute data'. These are realistic terms a user would use when needing this skill.

3 / 3

Distinctiveness Conflict Risk

Database sharding is a clear niche with distinct triggers. Unlikely to conflict with general database skills due to specific focus on sharding/distribution.

3 / 3

Total

11

/

12

Passed

Implementation

20%

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

This skill is a generic template with no actual database sharding content. It describes abstract project management steps that could apply to any technical task, completely failing to provide sharding-specific strategies, code examples, or concrete guidance. The skill wastes tokens on boilerplate Claude already knows while omitting everything Claude would actually need to implement sharding.

Suggestions

Replace generic steps with concrete sharding strategies (hash-based, range-based, directory-based) with executable code examples for at least one database system

Add specific guidance on partition key selection, including examples of good vs bad partition keys and their trade-offs

Include actual SQL/code for creating sharded tables, routing queries, and handling cross-shard operations

Remove all generic project management boilerplate (prerequisites, error handling sections) and focus only on sharding-specific knowledge Claude doesn't already have

DimensionReasoningScore

Conciseness

Extremely verbose with generic boilerplate that applies to any task. Contains no sharding-specific content - just template text like 'Review current configuration' and 'Define optimal approach based on best practices' that Claude already knows.

1 / 3

Actionability

No concrete code, commands, or sharding-specific guidance. Steps like 'Execute implementation in non-production environment first' are completely abstract. No actual sharding strategies, partition key selection, or implementation examples provided.

1 / 3

Workflow Clarity

Steps are numbered and sequenced, but they're generic project management steps, not sharding-specific workflows. No validation checkpoints specific to sharding (e.g., verifying data distribution, testing cross-shard queries).

2 / 3

Progressive Disclosure

References external files in Resources section, but the main content is a wall of generic text. The referenced files use placeholder paths and likely don't exist. No clear navigation between quick-start and advanced content.

2 / 3

Total

6

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

9

/

11

Passed

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.