SQL database design, query optimization, and migration safety. Use when writing queries, designing schemas, or planning database migrations.
70
56%
Does it follow best practices?
Impact
95%
1.06xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/platform/platform-database/SKILL.mdQuality
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'
| Dimension | Reasoning | Score |
|---|---|---|
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 10 / 11 Passed | |
7b466be
Table of Contents
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.