CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mysql-patterns

MySQL and MariaDB schema, query, indexing, transaction, replication, and connection-pool patterns for production backends. Use when designing MySQL or MariaDB schemas and indexes, or when a query, transaction, or replica lags.

Quality

85%

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

78%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 high-quality pattern reference: executable, engine-aware SQL and code throughout, disciplined tables instead of prose, and explicit validation expectations for review work. Its main structural weakness is that it is a ~400-line monolith — material like the configuration, security, and connection-pool sections would be better split into referenced files so SKILL.md stays an overview.

Suggestions

Split stable reference material (Configuration, Security, Connection Pools, Full-Text Search) into one-level-deep files under references/ and link them from short SKILL.md sections, moving progressive_disclosure from an all-inline monolith to a proper overview.

Remove duplicate guidance — the SKIP LOCKED caveat appears in both Version Check and Transactions — and trim reminders Claude already knows (e.g. why deep OFFSET is slow, that indexes add write cost) to tighten conciseness toward a 5.

Consolidate the scattered validation guidance (EXPLAIN-first indexing, deadlock capture with SHOW ENGINE INNODB STATUS, migration dry run, rollback criteria) into one explicit step-numbered review workflow with a validate-then-fix-then-retry loop.

DimensionReasoningScore

Conciseness

The body is dense — tables of defaults, anti-patterns, and EXPLAIN signals plus short code blocks, with almost no conceptual padding. It loses a point for a handful of statements Claude already knows ("Read replicas can lag", "Each index increases write cost…", "Do not use deep OFFSET pagination… it makes the server scan and discard rows") and for repeating the SKIP LOCKED caveat in both the Version Check and Transactions sections. Not 5, but far from the verbosity of anchor 3.

4 / 5

Actionability

Nearly every section delivers copy-paste-ready material: complete CREATE TABLE/INDEX statements, the upsert in both engine-compatible forms, a keyset-pagination query with its backing index, SQLAlchemy and mysql2 pool configs, a ready ini configuration block, and diagnostic SQL. This matches anchor 5 — fully executable guidance covering the common cases — and exceeds anchor 4, where only minor gaps would be tolerated.

5 / 5

Workflow Clarity

A coherent flow exists — 'Start by identifying the engine and version' leads in, and the Output Expectations section requires a validation plan (EXPLAIN, migration dry run, lock/deadlock check, rollback criteria) with per-issue guidance like 'Use EXPLAIN before adding or changing an index' and a bounded deadlock retry loop. It falls short of anchor 5 because validation checkpoints are distributed across sections rather than forming one explicit validate-then-fix-then-retry sequence for the risky migration path. Since database operations demand feedback loops, this is not capped at 3 — the loops are present, just not consolidated.

4 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/), so ~413 lines of reference material — schema defaults, full-text search, security, connection pools, and a full server configuration block — are all inlined in SKILL.md. Sections are well-headed and navigable, but content that clearly belongs in separate reference files is inline, which is exactly anchor 3; anchor 4 would require most content to be appropriately placed in separate files with clear references.

3 / 5

Total

16

/

20

Passed

Description

87%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: it explicitly states what the skill covers (six production-backend pattern areas across both MySQL and MariaDB) and gives concrete use-when triggers including the naturally-phrased 'when a query, transaction, or replica lags'. The only weaknesses are topic-noun rather than action-verb phrasing and a few missing common trigger variations such as 'slow query' and 'migrations'.

DimensionReasoningScore

Specificity

The description enumerates six concrete areas — "schema, query, indexing, transaction, replication, and connection-pool patterns" — but presents them as topic nouns rather than the action verbs of the top anchor ("Extract… fill… merge"), leaving minor gaps in coverage. It is clearly above anchor 3 because multiple specific capabilities are listed, not just 1-2.

4 / 5

Completeness

Both halves are explicit: the what is the six named pattern areas "for production backends" and the when is a concrete "Use when designing MySQL or MariaDB schemas and indexes, or when a query, transaction, or replica lags" clause. This matches the anchor-5 example's structure of explicit what plus concrete trigger phrases, so it cannot be capped at 4.

5 / 5

Trigger Term Quality

Natural phrases users would say are present — "designing MySQL or MariaDB schemas and indexes", "when a query, transaction, or replica lags" — but common variations like "database", "slow query", "deadlock", and "migrations" are missing. Good coverage rather than comprehensive synonym coverage, so it sits between the 3 and 5 anchors, noticeably above the midpoint.

4 / 5

Distinctiveness Conflict Risk

MySQL and MariaDB are named explicitly with engine-specific triggers (replica lag, MariaDB syntax divergence implied), carving a clear niche separate from adjacent skills like a generic postgres-patterns or backend-patterns skill. Overlap risk is minimal, matching the anchor-5 'clear niche with distinct triggers'.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/mysql-patterns/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.