CtrlK
BlogDocsLog inGet started
Tessl Logo

database-scout

Explore SQLite and PostgreSQL databases: list tables, inspect schemas (columns/types/constraints), preview data, generate Mermaid ER diagrams, and run safe read-only queries. Triggered by requests to explore a database, view table structures, describe tables, generate diagrams, or query data, and by keywords like database exploration, schema, ER diagram, or SQL query.

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

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

The body is well-structured, actionable, and concise: it provides executable commands, concrete output examples, and a real referenced script, with safety mechanisms documented. It avoids explaining basics Claude already knows and keeps references shallow.

DimensionReasoningScore

Conciseness

Lean and efficient — feature table, security bullets, copy-paste commands, and parameter tables with no explanations of concepts Claude already knows; every section earns its place rather than the 'mostly efficient but could be tightened' level.

3 / 3

Actionability

Fully executable copy-paste commands with real flags and subcommands, plus concrete JSON/Mermaid output examples; the referenced scripts/db_explorer.py exists and exposes matching argparse subcommands, making guidance copy-paste ready.

3 / 3

Workflow Clarity

A simple single-purpose CLI where each subcommand is one unambiguous read-only action; the tool itself enforces safety (read-only mode, keyword/multi-statement blocking), so no manual destructive-validation checkpoint is needed, satisfying the simple-skills allowance for a 3.

3 / 3

Progressive Disclosure

Well-organized into clear sections with one bundle file (scripts/db_explorer.py) referenced by real relative paths and verified present — references are one level deep and clearly signaled, with no nested reference chains.

3 / 3

Total

12

/

12

Passed

Description

100%

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 names concrete capabilities, gives natural trigger keywords, and clearly states both function and invocation conditions. Phrasing 'Triggered by requests to...' is slightly less idiomatic than 'Use when...', but content quality is high across all dimensions.

DimensionReasoningScore

Specificity

Lists five concrete actions — list tables, inspect schemas (columns/types/constraints), preview data, generate Mermaid ER diagrams, and run safe read-only queries — matching the 'multiple specific concrete actions' anchor rather than the partial-coverage anchor below.

3 / 3

Completeness

Explicitly answers both what it does (the five actions) and when to use it ('Triggered by requests to explore a database... and by keywords like...'), satisfying the both-what-and-when anchor with explicit triggers.

3 / 3

Trigger Term Quality

Provides varied natural keywords users would say — 'describe tables', 'view table structures', 'ER diagram', 'schema', 'SQL query' — giving good coverage of common phrasings rather than only jargon or a single keyword.

3 / 3

Distinctiveness Conflict Risk

Scoped narrowly to SQLite/PostgreSQL read-only database exploration with distinct triggers (ER diagram, schema inspection, safe queries), making it unlikely to fire for unrelated skills.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
zebbern/claude-code-guide
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.