CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sql-pro

Optimizes SQL queries, designs database schemas, and troubleshoots performance issues. Use when a user asks why their query is slow, needs help writing complex joins or aggregations, mentions database performance issues, or wants to design or migrate a schema. Invoke for complex queries, window functions, CTEs, indexing strategies, query plan analysis, covering index creation, recursive queries, EXPLAIN/ANALYZE interpretation, before/after query benchmarking, or migrating queries between database dialects (PostgreSQL, MySQL, SQL Server, Oracle).

80

Quality

100%

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

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

An exemplary skill body: a concise workflow with an explicit verify-and-iterate checkpoint, copy-paste-ready executable examples with concrete EXPLAIN-output interpretation rules, hard MUST DO/MUST NOT DO constraints, and a well-signaled one-level-deep reference table whose files all exist. Nothing scored below the top anchor on any dimension.

DimensionReasoningScore

Conciseness

The body is lean with zero padding: no explanation of what SQL, CTEs, or execution plans are — inline code comments carry the rationale instead ('filter early, before the join', 'no self-join required', 'always use ANALYZE to see actual row counts vs. estimates'). Every section (workflow, reference table, examples, constraints, output templates) earns its place.

5 / 5

Actionability

Four complete, executable SQL blocks (CTE with ROW_NUMBER, running-total/rank window functions, 'EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)', and a before/after correlated-subquery fix with a covering-index CREATE INDEX statement), plus concrete interpretation rules ('Seq Scan on large table → add or fix an index', 'high read count signals missing cache / index') and actionable MUST DO / MUST NOT DO and output-template lists.

5 / 5

Workflow Clarity

The five-step workflow (Schema Analysis → Design → Optimize → Verify → Document) has an explicit validation step with a feedback loop: 'Run EXPLAIN ANALYZE and confirm no sequential scans on large tables; if query does not meet sub-100ms target, iterate on index selection or query rewrite before proceeding' — exactly the verify→fix→retry loop the rubric demands for database operations, so no cap applies.

5 / 5

Progressive Disclosure

Reference Guide table maps Topic → Reference → 'Load When' with all five listed files (query-patterns.md, window-functions.md, optimization.md, database-design.md, dialect-differences.md) present in references/ and containing no further nested references (one level deep). Only brief quick-reference examples are inlined; the bulk of detail lives in the bundle.

5 / 5

Total

20

/

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.

The description matches the rubric's exemplar pattern precisely: third-person concrete capabilities followed by an explicit 'Use when...' clause with concrete natural-language triggers, closing with a detailed invoke list including dialect names. It scores at the top anchor on all four dimensions with no vagueness, fluff, or missing trigger guidance.

DimensionReasoningScore

Specificity

Multiple specific concrete actions with comprehensive coverage: 'Optimizes SQL queries, designs database schemas, and troubleshoots performance issues' plus 'covering index creation, recursive queries, EXPLAIN/ANALYZE interpretation, before/after query benchmarking, or migrating queries between database dialects'. No gaps across writing, optimizing, and schema design for the SQL domain, so it fits the top anchor rather than 'minor gaps in coverage'.

5 / 5

Completeness

Explicitly answers both questions: what — 'Optimizes SQL queries, designs database schemas, and troubleshoots performance issues'; when — 'Use when a user asks why their query is slow, needs help writing complex joins or aggregations, mentions database performance issues, or wants to design or migrate a schema.' This mirrors the rubric's anchor-5 example structure exactly, so not the 'when could be more explicit' anchor.

5 / 5

Trigger Term Quality

Natural user phrasing is present ('asks why their query is slow', 'needs help writing complex joins or aggregations', 'mentions database performance issues') alongside technical terms users actually say ('window functions', 'CTEs', 'indexing strategies', 'query plan analysis', 'EXPLAIN/ANALYZE') and product names ('PostgreSQL, MySQL, SQL Server, Oracle') — comprehensive coverage including synonyms ('query plan analysis' / 'EXPLAIN/ANALYZE interpretation'), so not the 'a few natural terms missing' anchor.

5 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: window functions, CTEs, covering indexes, EXPLAIN/ANALYZE interpretation, and named dialects (PostgreSQL, MySQL, SQL Server, Oracle) are unambiguously SQL-tuning territory with minimal conflict risk against adjacent data-analysis or general-programming skills.

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/sql-pro/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.