CtrlK
BlogDocsLog inGet started
Tessl Logo

database-optimizer

Use when investigating slow queries, analyzing execution plans, or optimizing database performance. Invoke for index design, query rewrites, configuration tuning, partitioning strategies, lock contention resolution.

58

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/database-optimizer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%Weight 40%Scale 1-5

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

A well-structured overview that uses progressive disclosure correctly, with a clear sequenced workflow and explicit validation guidance. Its weaknesses are the complete absence of executable detail in the body (everything concrete is deferred to references) and two padded sections (persona role definition, knowledge keyword list) that spend tokens on nothing Claude doesn't already know.

Suggestions

Add one small executable anchor to the body — e.g., a pg_stat_statements top-offenders query or an EXPLAIN (ANALYZE, BUFFERS) invocation — so the entry point isn't purely abstract.

Delete the 'Knowledge Reference' section and fold the 'Role Definition' persona into a single sentence; both restate things Claude already knows and add no actionable guidance.

Tie workflow steps to concrete starting points (e.g., step 1 'Analyze Performance' could name the monitoring-analysis.md diagnostics to run first) so the sequence has executable entry points.

DimensionReasoningScore

Conciseness

The structural sections (workflow, constraints, reference table) are lean and list-based, but two sections are pure padding: the 'Role Definition' persona paragraph ('a senior database performance engineer with 10+ years of experience') and the 'Knowledge Reference' keyword dump ('pg_stat_statements, EXPLAIN ANALYZE, indexes, VACUUM, partitioning...') that tells Claude nothing it doesn't already know. This matches anchor 3 — mostly efficient with some unnecessary explanation that could be trimmed — rather than 2, since no concept is actually explained at length.

3 / 5

Actionability

The body contains no executable code, SQL, or commands anywhere — even the highest-value moments stay abstract ('Analyze EXPLAIN plans before optimizing', 'Measure performance before and after changes'). This matches anchor 2: minimal concrete guidance with high-level hints but missing the specific steps to execute. Not 3 because there isn't even partial concrete material like a sample pg_stat_statements query or an EXPLAIN ANALYZE invocation in the body; the concrete detail is entirely deferred to reference files.

2 / 5

Workflow Clarity

The 5-step Core Workflow (Analyze → Identify → Design → Implement → Validate) is a clear sequence, and validation checkpoints are explicitly present ('Measure performance before and after changes', step 5 'Validate Results - Measure improvements, ensure stability'), which satisfies the database-operations feedback-loop expectation and avoids the cap at 3. Not 5 because the steps lack executable commands or explicit error-recovery loops (the anchor-5 pattern of 'if X fails, fix and re-check'), leaving minor validation gaps.

4 / 5

Progressive Disclosure

The Reference Guide table gives a clear overview with well-signaled, one-level-deep references, each paired with a 'Load When' condition, and all five referenced files (query-optimization.md, index-strategies.md, postgresql-tuning.md, mysql-tuning.md, monitoring-analysis.md) exist with substantive content. This matches the anchor-5 example of a clear overview pointing to well-signaled separate files with no nesting.

5 / 5

Total

14

/

20

Passed

Description

78%Weight 40%Scale 1-5

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

A strong description with a clear 'Use when...' trigger clause and multiple concrete, domain-specific capabilities. Its main weakness is that capabilities are framed entirely as invocation triggers rather than a declarative statement of what the skill does, and engine-specific terms (PostgreSQL/MySQL) that would sharpen triggering are relegated to metadata.

Suggestions

Open with a declarative third-person capability statement (e.g., 'Optimizes slow PostgreSQL and MySQL queries...') before the 'Use when' clause, so the 'what' is explicit rather than implied by 'Invoke for'.

Include engine names and common user phrasings (PostgreSQL, MySQL, 'database is slow', 'tune') in the description itself — they currently exist only in the metadata triggers field.

DimensionReasoningScore

Specificity

The description lists several specific actions — 'investigating slow queries, analyzing execution plans', 'index design, query rewrites, configuration tuning, partitioning strategies, lock contention resolution' — comparable to the anchor-4 example of several specific actions with minor gaps. Not 5 because coverage has gaps: schema design, monitoring, and engine-specific work (PostgreSQL/MySQL) named in the metadata are absent from the description itself; not 3 because far more than 1-2 concrete actions are named.

4 / 5

Completeness

Explicit trigger guidance is present ('Use when investigating slow queries...') so the completeness cap of 3 does not apply, and the 'what' is conveyed through the named capabilities ('index design, query rewrites, configuration tuning'), matching anchor 4: both what and when present, but the 'what' is phrased only via 'Invoke for...' rather than a declarative capability statement, so it could be more explicit — which keeps it below the anchor-5 example that cleanly separates both.

4 / 5

Trigger Term Quality

Good natural keyword coverage: 'slow queries', 'execution plans', 'database performance', 'index', 'query rewrites', 'lock contention' are phrases users would actually say. Not 5 because common synonyms and specifics are missing — engine names (Postgres/MySQL, which appear only in frontmatter metadata), 'database is slow', 'tune/tuning' as a user verb.

4 / 5

Distinctiveness Conflict Risk

Clear niche (database performance optimization) with distinct triggers — 'execution plans', 'partitioning strategies', 'lock contention resolution' would not plausibly route to a general coding or document skill, matching the anchor-5 'clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

17

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
zebbern/claude-code-guide
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.