CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

database-design

Design, review, or evolve a database schema and its data-integrity, tenancy, migration, indexing, and operational model. Use when the primary deliverable is a datastore or schema decision. Do not use for general system planning, query debugging, or generic dependency/security review.

Quality

81%

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

71%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 well-structured, highly actionable instruction-only skill with a clear 7-step workflow, explicit validation checkpoints, a completion checklist, and well-signaled one-level references. Its main weaknesses are dead links to nonexistent shared/base policy files, an unreferenced bundled validation script, and some redundancy across activation/routing sections.

Suggestions

Remove or fix the links to shared/base/*.md policy modules and shared/workflow-contract.md, which do not exist in the bundle — either ship those files or drop the framework boilerplate section.

Reference scripts/validate_scenarios.py from the body (e.g., in the Output contract or Completion checklist) so the bundled validator is discoverable and the output contract is actually checked.

Consolidate the overlapping trigger and routing content in "Purpose and activation" and "Routing Boundary" into a single section to save tokens.

DimensionReasoningScore

Conciseness

The body is dense and directive ("Use `timestamptz` for instants; store money as integer minor units plus currency"; "expand -> migrate/backfill -> verify -> switch -> contract") and assumes Claude's competence without teaching basics, but the Base Framework boilerplate, the duplication between "Purpose and activation" and "Routing Boundary", and the lengthy workflow-integration/state.json mechanics are trimmable, matching the 4-anchor's minor over-explanation rather than the 3-anchor's unnecessary explanation.

4 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: an exact output-contract heading list, a per-table mini-specification template, specific commands like `EXPLAIN (ANALYZE, BUFFERS)`, and named tooling. It falls short of the 5-anchor because the Examples section points to references rather than demonstrating a worked case, and the bundled validate_scenarios.py script is never invoked.

4 / 5

Workflow Clarity

A clearly sequenced 7-step workflow with explicit validation checkpoints ("Validate candidates using representative `EXPLAIN (ANALYZE, BUFFERS)` after data exists", migration "verify" step, "abort criteria, and tested rollback or forward-repair") and a completion checklist, so the destructive/batch cap does not apply. It sits between the 4- and 5-anchors because error recovery is stated as an output requirement rather than an explicit validate-fix-retry step in the workflow, and the shipped validation script is orphaned.

4 / 5

Progressive Disclosure

The four references/*.md files are real, one level deep, and clearly signaled ("Read [architecture-and-modeling.md](references/architecture-and-modeling.md)"), but scored against the actual bundle: roughly ten links to shared/base/*.md policies and shared/workflow-contract.md point to files that do not exist in the bundle, and scripts/validate_scenarios.py is never referenced from the body. These dead links and the orphaned script exceed the 4-anchor's "minor organization gaps".

3 / 5

Total

15

/

20

Passed

Description

83%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 with concrete, comprehensive capability statements, an explicit use-when clause, and explicit negative boundaries that sharply reduce conflict risk. The main improvement opportunity is adding concrete trigger phrases (e.g., ERD, SQL, tables, PostgreSQL) to the when-clause and trigger coverage.

DimensionReasoningScore

Specificity

"Design, review, or evolve a database schema and its data-integrity, tenancy, migration, indexing, and operational model" lists multiple concrete actions (design, review, evolve) across five named capability areas, giving comprehensive coverage comparable to the top anchor; it is not the 4-anchor because no capability area of the domain is visibly missing.

5 / 5

Completeness

Both "what" ("Design, review, or evolve a database schema and its data-integrity, tenancy, migration, indexing, and operational model") and "when" ("Use when the primary deliverable is a datastore or schema decision") are explicit, but the when-clause states a condition rather than concrete trigger phrases, fitting the 4-anchor where the when could be more specific rather than the 5-anchor.

4 / 5

Trigger Term Quality

Natural keywords are present ("database schema", "migration", "indexing", "tenancy", "datastore"), but common user phrasings such as "ERD", "SQL", "tables", or "PostgreSQL" are absent, matching the 4-anchor (good coverage, a few natural terms missing) rather than the 5-anchor's synonym-level comprehensiveness.

4 / 5

Distinctiveness Conflict Risk

"Do not use for general system planning, query debugging, or generic dependency/security review" explicitly disambiguates against the nearest competing skills, giving a clear niche with minimal conflict risk, which matches the 5-anchor; the 4-anchor's "minor overlap risk" would require missing these exclusions.

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

relative_links

Relative link issues: 10 missing, 9 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

Noorkhalel/saas-ai-skills

Path

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