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

84%

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

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.

Highly actionable and reasonably concise CLI documentation with an orphaned bundle reference as the main structural flaw: references/mysql_guide.md is never linked from SKILL.md, hiding troubleshooting and optimization guidance. Additionally, as a database batch operation with no verification or error-recovery steps in the body, workflow clarity is capped at 3 by the rubric.

Suggestions

Add a signal to the reference file, e.g. a '## Troubleshooting' section stating 'See [references/mysql_guide.md](references/mysql_guide.md) for connection errors, charset issues, and token optimization tips', so the bundle file is discoverable.

Add a verification step to the workflow (e.g., 'After extraction, check the output directory and review _schema.md to confirm table coverage before including files in LLM context') to provide the feedback loop the rubric expects for database batch operations.

Trim duplication between 'Quick Start' and 'Connection String Format' (the full-format example appears in both) and drop the redundant opening line that restates the frontmatter description.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence (no MySQL tutorials, no library explanations), but has trimmable redundancy: connection-string examples appear in both "Quick Start" and "Connection String Format", and the opening line restates the frontmatter description. Anchor 5 would require every token to earn its place.

4 / 5

Actionability

Every example is copy-paste executable against the real scripts/db_extract.py, the Quick Start covers the common cases (default CSV, JSON, markdown, all+schema), and the CLI reference lists every flag with defaults. Specific workflows cover selective extraction and large-database handling.

5 / 5

Workflow Clarity

The single-command sequence is unambiguous, but this is a database batch operation and the body contains no validation or verification steps (no output check, no error-recovery guidance — troubleshooting lives only in the unreferenced guide). Per the rubric cap, database/batch workflows without feedback loops cannot score above 3; it is not lower because the sequence itself is clear.

3 / 5

Progressive Disclosure

Inline structure is good (clear sections, appropriately sized), and scripts/db_extract.py is consistently referenced. However references/mysql_guide.md — which contains troubleshooting, token optimization, and password special-character handling that complements the body — is never mentioned, so it is undiscoverable and its connection-format content is partially duplicated inline. Anchor 4 requires references to be mostly clearly signaled, which this misses.

3 / 5

Total

15

/

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: third-person voice, explicit what-and-when, concrete formats and trigger contexts, and a clearly staked-out MySQL niche. The only weaknesses are mild — slightly thin action variety and a few missing natural synonyms like "export" or "dump".

DimensionReasoningScore

Specificity

"Extract MySQL database content to text-readable formats (CSV, JSON, Markdown) for LLM processing and content synthesis" names the domain and concrete actions with three explicit output formats and purposes. It stops short of anchor 5 because the action set is essentially one extract-and-convert operation rather than multiple distinct capabilities.

4 / 5

Completeness

Both parts are explicit: what — "Extract MySQL database content to text-readable formats (CSV, JSON, Markdown) for LLM processing and content synthesis"; when — "Use when working with MySQL databases that need to be converted to text formats for analysis, synthesis, or inclusion in LLM context windows", with three concrete trigger contexts. Anchor 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural terms present: "MySQL", "database", "CSV", "JSON", "Markdown", "LLM", "converted to text formats", "analysis, synthesis". A few common synonyms users would say are missing ("export", "dump", "SQL"), so it does not reach anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

"MySQL database" is a clear niche with distinct triggers, and "Routed from db-router skill" clarifies its place in a router family without introducing overlap. Minimal conflict risk with non-MySQL or non-database skills.

5 / 5

Total

18

/

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_sdk_knowledge_extractor

Path

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