CtrlK
BlogDocsLog inGet started
Tessl Logo

platform-database

SQL database design, query optimization, and migration safety. Use when writing queries, designing schemas, or planning database migrations.

70

1.06x
Quality

56%

Does it follow best practices?

Impact

95%

1.06x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/platform/platform-database/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

This is a solid skill description that clearly communicates its purpose and when to use it. The explicit 'Use when...' clause with relevant trigger terms makes it easy for Claude to select appropriately. The main weakness is that the capability list could be more specific about concrete actions beyond high-level categories.

Suggestions

Expand specificity by listing concrete actions like 'write efficient JOINs, create indexes, normalize tables, generate migration scripts with rollbacks'

DimensionReasoningScore

Specificity

Names the domain (SQL database) and lists some actions (design, query optimization, migration safety), but doesn't provide comprehensive concrete actions like specific techniques or operations (e.g., 'create indexes', 'normalize tables', 'write rollback scripts').

2 / 3

Completeness

Clearly answers both what ('SQL database design, query optimization, and migration safety') and when ('Use when writing queries, designing schemas, or planning database migrations') with explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes natural keywords users would say: 'queries', 'schemas', 'database migrations', 'SQL'. These are terms users naturally use when seeking database help.

3 / 3

Distinctiveness Conflict Risk

Clear niche focused on SQL databases with distinct triggers (schemas, migrations, query optimization). Unlikely to conflict with general coding skills or document processing skills.

3 / 3

Total

11

/

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 is essentially a shell with minimal actual database guidance. It promises SQL design, query optimization, and migration safety but delivers only one tip about UNION ALL and generic troubleshooting boilerplate. The content fails to provide the actionable, concrete guidance needed for database work.

Suggestions

Add concrete SQL examples for common patterns: index design, query optimization techniques, and safe migration scripts with rollback procedures

Replace the generic workflow with database-specific steps including validation queries, migration dry-runs, and rollback checkpoints

Remove or condense the generic troubleshooting section and replace with database-specific issues (deadlocks, slow queries, migration failures)

Either inline key rules from the referenced rules index or provide a meaningful overview of what patterns are covered there

DimensionReasoningScore

Conciseness

The skill is relatively brief but includes boilerplate sections (Troubleshooting, Examples) that are generic and don't add database-specific value. The actual database guidance is minimal - just one principle about UNION ALL.

2 / 3

Actionability

Extremely vague - provides only one concrete tip (UNION ALL over UNION) with no executable SQL examples, no schema patterns, no migration commands, and no query optimization techniques despite the description promising all of these.

1 / 3

Workflow Clarity

The workflow section is generic meta-instructions about skill usage, not actual database workflow steps. No validation checkpoints for migrations, no rollback procedures, no zero-downtime deployment sequence despite the example mentioning this use case.

1 / 3

Progressive Disclosure

References a rules index file which is appropriate structure, but the main file contains almost no substantive content to serve as an overview. The balance is inverted - too little here, presumably everything in the referenced file.

2 / 3

Total

6

/

12

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

metadata_field

'metadata' should map string keys to string values

Warning

Total

10

/

11

Passed

Repository
ravnhq/ai-toolkit
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.