CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

db-migration

Create or update database schema and generate migrations. Use when modifying ent schema, adding database fields/tables, or generating migration files.

Quality

81%

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

88%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, deeply actionable skill body: concrete commands, a complete mixin reference, a sequenced workflow with validation checkpoints and error-recovery guidance, and no concept padding. The only refinements are deduplicating the 'never edit manually' reminders and considering a reference file for the pattern/mixin detail.

DimensionReasoningScore

Conciseness

The body is lean: command blocks, a compact mixin table, and bullet lists with no explanations of concepts Claude already knows. Minor trimming is possible — the 'never edit manually' rule appears three times (Context, Migration format, Important Reminders), and 'Schemas supporting soft delete always have a deleted_at field' restates the TimeMixin row — which fits anchor 4 rather than the perfectly lean anchor 5.

4 / 5

Actionability

Commands are copy-paste ready ('make generate', 'atlas migrate --env local diff <migration-name>' with naming examples like 'add_customer_email', 'atlas migrate --env local hash'), plus an executable Mixin() snippet, a field-by-field mixin table, and pointers to specific pattern files (openmeter/ent/schema/llmcostprice.go). This matches the fully executable anchor with examples covering the common cases.

5 / 5

Workflow Clarity

Five explicitly ordered steps with checkpoints: Step 2 says 'Check that it completes without errors', Step 5 is a review checklist ('The SQL matches the intended schema change', 'No unintended changes are included'), and troubleshooting supplies feedback loops ('If compilation errors occur after schema changes, fix the schema first, then re-run make generate'; rehash command for out-of-sync atlas.sum). Despite being database operations, validation is present, so the destructive/batch cap does not apply — this matches the anchor with explicit validation steps, error-recovery loops, and a checklist.

5 / 5

Progressive Disclosure

No bundle files exist, so structure alone is scored: sections are clear and well ordered (Context, Workflow, Mixins, Patterns, Troubleshooting, Reminders) and inline content (mixin table, pattern notes) is compact and central to the task. At ~135 lines the pattern/mixin detail is a plausible candidate for a separate reference file — a minor organization gap matching anchor 4 rather than the cleanly split anchor 5.

4 / 5

Total

18

/

20

Passed

Description

66%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 solid description with a clear what, an explicit 'Use when' clause, and a distinct niche. Its main weakness is trigger phrasing that relies on project-specific jargon ('ent') and omits natural user phrasings like 'add a field' or 'new table'.

Suggestions

Add natural trigger phrasings users would actually say, e.g. 'Use when adding fields/columns to a table, creating new tables, or changing the database schema' — this would lift both trigger_term_quality and completeness.

Broaden the 'what' slightly to cover the full capability set (e.g., regenerate ent client code and produce up/down SQL migrations), which currently only appears in the body.

Consider mentioning soft-delete conventions or view handling in the description if those are common asks, to distinguish the skill further from generic migration helpers.

DimensionReasoningScore

Specificity

Names the domain (database schema/migrations) and two concrete actions ('Create or update database schema and generate migrations'), but coverage is not comprehensive — regenerating client code, view definitions, and review of migrations are unmentioned. It is above anchor 2 because the actions are concrete rather than generic, but below anchor 4, which expects several specific actions.

3 / 5

Completeness

Both parts are present: a clear 'what' ('Create or update database schema and generate migrations') and an explicit 'Use when...' clause with three triggers. Falls short of anchor 5 because the trigger phrases are jargon-dependent rather than the fully natural, synonym-rich set the top anchor describes.

4 / 5

Trigger Term Quality

Relevant keywords exist ('ent schema', 'adding database fields/tables', 'generating migration files') but they lean on project jargon and miss natural variations a user would say, such as 'add a column', 'new table', or 'schema change'. Matches anchor 3 rather than 4, which requires good coverage with only a few natural terms missing.

3 / 5

Distinctiveness Conflict Risk

'ent schema' and 'migration files' carve a clear niche (ent-based database migrations in this repo) with minimal risk of triggering for unrelated skills, matching the 'clear niche with distinct triggers' anchor.

5 / 5

Total

15

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

openmeterio/openmeter

Path

.agents/skills/db-migration/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.