CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

database-optimizer

Optimizes database queries and improves performance across PostgreSQL and MySQL systems. 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.

77

Quality

97%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 specialist skill: executable examples for both PostgreSQL and MySQL, a validated workflow with baseline-capture and revert safeguards, and clean one-level progressive disclosure to five topical reference files. The only weakness is minor redundancy between the frontmatter description and the body's role/when-to-use sections.

DimensionReasoningScore

Conciseness

The body is mostly lean — SQL snippets, a symptom/remedy table, and checklists — but the 'Senior database optimizer with expertise...' role preamble and the 'When to Use This Skill' bullet list substantially duplicate the description's content, tokens that could be trimmed. Not 3: there is no re-teaching of concepts Claude already knows and no padded explanation.

4 / 5

Actionability

Fully executable, copy-paste-ready SQL covering the common cases: pg_stat_statements top-query listing, EXPLAIN (ANALYZE, BUFFERS) plan capture, CREATE INDEX CONCURRENTLY ... INCLUDE covering index, pg_stat_user_indexes usage verification, and MySQL performance_schema digests. The <query>/<table> placeholders in the validate-improvement template are appropriate parameterization, not pseudocode.

5 / 5

Workflow Clarity

The 5-step Core Workflow has explicit validation checkpoints ('run EXPLAIN ANALYZE before any changes', 'validate each change before proceeding', step 5 re-run and compare) plus a feedback loop — 'Revert immediately if write performance degrades or replication lag increases'. This satisfies the database-operations feedback-loop requirement that would otherwise cap the score at 3.

5 / 5

Progressive Disclosure

A Reference Guide table maps five topics to five real files in references/ (all verified present), each with a 'Load When' condition; the references are one level deep with no nested pointers, and the SKILL.md overview stays appropriately high-level while keeping the most common operations inline.

5 / 5

Total

19

/

20

Passed

Description

100%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.

An exemplary description: concrete capability list, explicit 'Use when' triggers with natural phrasing, named target systems, and third-person voice. It closely matches the rubric's good-overall examples in structure and quality.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'index design, query rewrites, configuration tuning, partitioning strategies, lock contention resolution' — with comprehensive coverage of the database-optimization domain, matching the anchor-5 example rather than the minor-gaps anchor 4.

5 / 5

Completeness

Explicitly answers both questions: the 'what' ('Optimizes database queries and improves performance across PostgreSQL and MySQL systems') and the 'when' via a concrete 'Use when investigating slow queries...' clause with additional 'Invoke for...' triggers, mirroring the anchor-5 example structure.

5 / 5

Trigger Term Quality

Natural phrases users would actually say — 'investigating slow queries', 'analyzing execution plans', 'optimizing database performance' — plus explicit system names 'PostgreSQL and MySQL' give comprehensive coverage including synonyms, matching anchor 5 rather than the few-missing-terms anchor 4.

5 / 5

Distinctiveness Conflict Risk

Clear niche — query performance tuning for PostgreSQL/MySQL — with distinct triggers (execution plans, index design, lock contention) that would not fire for unrelated skills; minimal conflict risk per anchor 5. Third-person voice ('Optimizes', 'Improves') means the voice penalty does not apply.

5 / 5

Total

20

/

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

Jeffallan/claude-skills

Path

skills/database-optimizer/SKILL.md

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.