CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

migrations

Implementation details for EF Core migrations. Use when changing MigrationsSqlGenerator, model diffing, migration operations, HistoryRepository, the Migrator or related classes.

67

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

86%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 lean, dense, high-signal skill body that documents the migrations pipeline and a precise recipe for upgrade-only regression testing, with exact API names, parameters, and test locations. The only improvements are minor: a skeleton differ-test example and a failure-branch instruction for the regression workflow.

DimensionReasoningScore

Conciseness

Every line carries non-obvious, repo-specific knowledge — e.g. 'Model snapshots use typeof(Dictionary<string, object>) (property bag format), not the actual CLR type' and exact test file locations. No padding and no explanation of concepts Claude already knows; clear match to anchor 5.

5 / 5

Actionability

Guidance names concrete APIs with parameters ('process its model with SnapshotModelProcessor.Process(..., resetVersion: true)', 'MigrationsModelDiffer.GetDifferences()') and exact test paths. Minor gaps keep it below anchor 5: 'derive a concrete old ModelSnapshot' and 'use ModelBuilder calls without conventions' are high-level directions without a skeleton test example.

4 / 5

Workflow Clarity

The Pipeline section sequences both add and apply flows, and the regression recipe is ordered (derive old snapshot → process → compare → verify) with an explicit checkpoint: 'The regression succeeds only when the resulting operation list is empty.' Minor gap versus anchor 5: no error-recovery branch for when the operation list is non-empty.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files needed, and content is cleanly organized into Pipeline, Model Snapshot, and Testing sections. Per the simple-skill guideline, well-organized sections alone warrant anchor 5.

5 / 5

Total

18

/

20

Passed

Description

73%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 well-scoped, distinct description with an explicit and concrete 'Use when' trigger clause naming the relevant classes. Its main weakness is the 'what' half — 'Implementation details' is a topic label rather than a statement of concrete capabilities.

Suggestions

Replace or augment the generic phrase 'Implementation details for' with one or two concrete actions, e.g. 'Documents the EF Core migrations pipeline (scaffolding, model diffing, SQL generation, application) and how to test it'

Add the natural trigger phrases users would actually say when they need this skill, such as 'scaffolding a migration', 'model snapshot', or 'GetDifferences', alongside the class names

DimensionReasoningScore

Specificity

The only capability statement is the generic noun phrase 'Implementation details for EF Core migrations' — no concrete actions are described. The enumerated class names (MigrationsSqlGenerator, HistoryRepository, the Migrator) add concrete coverage areas but serve as triggers, not actions, so this falls between the 'names domain with minimal actions' and 'lists several specific actions' anchors.

3 / 5

Completeness

Both parts are explicitly present: 'Implementation details for EF Core migrations' answers what, and 'Use when changing MigrationsSqlGenerator, model diffing, migration operations, HistoryRepository, the Migrator or related classes' answers when with concrete trigger phrases. Not anchor 5 because the 'what' names a topic rather than describing concrete actions.

4 / 5

Trigger Term Quality

'MigrationsSqlGenerator, model diffing, migration operations, HistoryRepository, the Migrator' are natural phrases a developer working in this codebase would say. Common variations like 'scaffold a migration', 'model snapshot', or 'GetDifferences' are missing, keeping it below comprehensive coverage (anchor 5) but clearly above 'some relevant keywords' (anchor 3).

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — EF Core migrations internals with specific named classes — so it is highly distinguishable from other skills and unlikely to trigger for the wrong one. Clear match to anchor 5.

5 / 5

Total

16

/

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

dotnet/efcore

Path

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