CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

db-extractor-mysql

Extract MySQL database content to text-readable formats (CSV, JSON, Markdown) for LLM processing and content synthesis. Use when working with MySQL databases that need to be converted to text formats for analysis, synthesis, or inclusion in LLM context windows. Routed from db-router skill.

Quality

82%

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

The canonical home for this skill is db-extractor-mysql in KennethJefferson/cc_sdk_knowledge_extractor

SKILL.md
Quality
Evals
Security

Quality

Content

72%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 highly actionable, accurate CLI skill whose documented options match the real script, held back by missing validation for a batch database operation and by an entirely unreferenced bundle file. The body is efficient but duplicates content that already exists in references/mysql_guide.md.

Suggestions

Add a validation step to the extraction workflow (e.g., check that expected output files exist and spot-check row counts, and retry or surface errors on connection failures), since batch database extraction currently has no verification or error-recovery guidance.

Link references/mysql_guide.md from the body (e.g., a '## Troubleshooting' or '## Advanced usage' section pointing to it) so its troubleshooting, format-selection, and token-optimization content is actually discoverable.

Remove the duplicated Connection String Format section from the body in favor of a one-line pointer to the reference guide, trimming the body's token footprint.

DimensionReasoningScore

Conciseness

The body is a mostly lean CLI reference with concrete commands and no explanation of concepts Claude already knows, but includes minor trimmable content such as the restated opening sentence, the pip-install dependency section, and the 'Single format outputs files directly...' note. It fits anchor 4 (efficient with minor over-explanation) rather than 5, since a few tokens do not earn their place, and rather than 3, since there is no genuinely padded or unnecessary explanation.

4 / 5

Actionability

All examples are fully executable copy-paste commands ('python scripts/db_extract.py mysql://user:password@localhost:3306/mydb', '--tables users,posts,comments', '--max-rows 50') covering the common cases, and the documented CLI Reference matches the actual script's argparse options exactly. This matches anchor 5; it is above anchor 4 because there are no gaps in the concrete guidance.

5 / 5

Workflow Clarity

The single action (run the extractor with options) is unambiguous and sections are organized by workflow, but this is a batch database operation (default extracts every table) with no validation or verification step in the body — no output check, row-count sanity check, or error-recovery loop. Per the rubric's cap, batch/database operations without validation cannot score above 3, which overrides the simple-skill exception.

3 / 5

Progressive Disclosure

The body is well structured (Quick Start, workflows, CLI Reference) and references a real script, but the bundle's references/mysql_guide.md is never mentioned anywhere in the body, leaving its troubleshooting, format-selection, and token-optimization content orphaned and undiscoverable. It also duplicates the guide's Connection String Format section inline; this matches anchor 3 (references present but not clearly signaled, content that should be separate is inline) rather than 4, because a provided reference file is completely invisible rather than just imperfectly signaled.

3 / 5

Total

15

/

20

Passed

Description

82%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 that clearly and explicitly states both what the skill does and when to use it, with good natural trigger terms and a distinct MySQL-extraction niche. Its only weakness is that it describes a single core action rather than enumerating several specific capabilities, and it misses a few common synonyms like 'export' or 'dump'.

DimensionReasoningScore

Specificity

'Extract MySQL database content to text-readable formats (CSV, JSON, Markdown)' names the domain and one core action with enumerated output formats; the listed purposes ('analysis, synthesis, or inclusion in LLM context windows') are use cases, not additional actions. This matches anchor 3 (domain plus 1-2 concrete actions) rather than 4, whose example lists several distinct operations such as extracting, filling forms, and converting pages.

3 / 5

Completeness

It explicitly answers both questions: the 'what' is 'Extract MySQL database content to text-readable formats (CSV, JSON, Markdown) for LLM processing and content synthesis' and the 'when' is 'Use when working with MySQL databases that need to be converted to text formats for analysis, synthesis, or inclusion in LLM context windows'. The trigger guidance is explicit and specific with concrete contexts, matching anchor 5 rather than 4, where the 'when' would be less explicit.

5 / 5

Trigger Term Quality

Natural terms users would say are well covered: 'MySQL', 'database', 'extract', 'CSV', 'JSON', 'Markdown', 'LLM context windows'. It falls short of anchor 5 because common synonyms and variations like 'export', 'dump', or 'SQL' are missing, fitting anchor 4 (good keyword coverage, a few natural terms missing).

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (MySQL-to-text extraction) and even notes 'Routed from db-router skill' to disambiguate routing; it would not naturally trigger for non-MySQL or non-extraction tasks. This matches anchor 5 (clear niche with distinct triggers, minimal conflict risk) rather than 4, which allows overlap with closely related skills.

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

KennethJefferson/cc_skill_monorepo_db_tools

Path

db-extractor-mysql/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.