CtrlK
BlogDocsLog inGet started
Tessl Logo

optimizing-sql-queries

Execute use when you need to work with query optimization. This skill provides query performance analysis with comprehensive guidance and automation. Trigger with phrases like "optimize queries", "analyze performance", or "improve query speed".

43

Quality

45%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/database/sql-query-optimizer/skills/optimizing-sql-queries/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

40%

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 description is padded with vague buzzwords ('comprehensive guidance and automation') while lacking concrete actions or specific capabilities. The trigger terms are reasonable but incomplete, and the description fails to specify what kind of queries or what concrete optimization actions are performed. It reads more like a template than a useful skill description.

Suggestions

Replace vague phrases like 'comprehensive guidance and automation' with specific concrete actions, e.g., 'Analyzes SQL query execution plans, identifies missing indexes, rewrites slow joins, and suggests schema improvements.'

Specify the domain clearly—is this for SQL databases, NoSQL, search engines? Add terms like 'SQL', 'database', 'execution plan', 'slow query', 'index optimization' to improve trigger term coverage and distinctiveness.

Restructure to clearly separate 'what' from 'when': list capabilities first, then provide an explicit 'Use when...' clause with natural user phrases.

DimensionReasoningScore

Specificity

The description uses vague language like 'query performance analysis with comprehensive guidance and automation' without listing any concrete actions. It doesn't specify what types of queries, what optimization techniques, or what outputs are produced.

1 / 3

Completeness

It attempts to answer both 'what' and 'when', but the 'what' is extremely vague ('query performance analysis with comprehensive guidance and automation') and the 'when' trigger phrases are present but the overall guidance is weak. The 'Use when' equivalent exists but the 'what' is too thin to score a 3.

2 / 3

Trigger Term Quality

It includes some relevant trigger phrases like 'optimize queries', 'analyze performance', and 'improve query speed', which are natural terms users might say. However, it misses common variations like 'slow query', 'SQL optimization', 'execution plan', 'index', or 'database performance'.

2 / 3

Distinctiveness Conflict Risk

The term 'query optimization' provides some specificity, but 'queries' is broad—it could overlap with database administration skills, SQL writing skills, or general performance tuning skills. It doesn't specify the type of queries (SQL, NoSQL, API) or the context (database, search engine, etc.).

2 / 3

Total

7

/

12

Passed

Implementation

50%

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

This is a competent SQL optimization skill with good coverage of anti-patterns, clear examples, and a useful error handling table. Its main weaknesses are moderate verbosity (explaining concepts Claude already knows about SQL), lack of explicit validation/feedback loops in the main workflow for verifying result correctness, and a monolithic structure that could benefit from splitting detailed reference material into separate files.

Suggestions

Add an explicit result-verification step in the main workflow (e.g., 'Compare row counts and spot-check results with EXCEPT before accepting the rewrite') to create a proper feedback loop for correctness.

Trim explanatory parentheticals that Claude already knows (e.g., 'forces unnecessary I/O', 'produces wrong results and poor plans') to improve token efficiency.

Split the error handling table, detailed examples, and resources into separate referenced files (e.g., ERROR_HANDLING.md, EXAMPLES.md) to improve progressive disclosure.

Make examples more executable by including complete test setups with CREATE TABLE and sample data, or provide a diagnostic query template that can be copy-pasted to begin analysis.

DimensionReasoningScore

Conciseness

The skill is reasonably well-written but includes some unnecessary verbosity. Explanations like 'forces unnecessary I/O', 'produces wrong results and poor plans', and general SQL optimization concepts that Claude already knows add bulk. The prerequisites section explains things Claude can infer. However, it's not egregiously padded—most content is instructional rather than explanatory.

2 / 3

Actionability

The skill provides concrete SQL examples and specific anti-patterns to look for, which is good. However, the instructions are more of a knowledge guide than executable steps—there are no copy-paste-ready scripts or commands for the analysis workflow itself. The examples section shows before/after SQL but lacks complete, executable test setups. The guidance is specific but stops short of being fully actionable with ready-to-run diagnostic queries.

2 / 3

Workflow Clarity

The 10-step sequence is clearly numbered and logically ordered, culminating in testing with EXPLAIN ANALYZE (step 9) and documentation (step 10). However, there's no explicit validation checkpoint or feedback loop—step 9 says to compare but doesn't specify what to do if the rewrite is slower (that's buried in the error handling table). For a skill involving query rewrites that could produce incorrect results, the lack of an explicit result-verification step in the main workflow is a gap.

2 / 3

Progressive Disclosure

The content is well-structured with clear sections (Overview, Prerequisites, Instructions, Output, Error Handling, Examples, Resources), but it's a monolithic document at ~100+ lines. The detailed error handling table, extensive examples, and resources could be split into separate files. With no bundle files provided, there's no progressive disclosure structure—everything is inline in one file.

2 / 3

Total

8

/

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

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.