CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

postgres-migration

Safe EF Core Migrations workflow for FinanceHub PostgreSQL databases, covering migration creation, SQL script generation and validation, zero-downtime schema updates, lock timeout safety, and rollback procedures.

Quality

82%

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

81%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 strong, safety-first workflow guide: fully sequenced steps, executable commands, and genuine validation checkpoints and checklists appropriate for destructive database operations. The main gaps are directional (non-executable) guidance in the multi-phase column-add and rename patterns and mild redundancy around lock_timeout handling.

Suggestions

Add concrete SQL for Patterns B and C (e.g., ALTER TABLE ... ADD COLUMN, adding NOT NULL via NOT VALID + VALIDATE CONSTRAINT, and a backfill UPDATE template) so all patterns are executable, not just described.

Consolidate the lock_timeout guidance that currently appears in both Section 3's checklist and Section 6's emergency checklist to trim a little redundancy.

Consider moving the extended zero-downtime patterns and rollback procedures into a references/ file to keep SKILL.md a leaner overview.

DimensionReasoningScore

Conciseness

The body is dominated by lean, purposeful commands, checklists, and code blocks with no padding explaining concepts Claude already knows. Minor tightening is possible — lock_timeout guidance appears in both the Section 3 checklist and the Section 6 emergency checklist, and the Core Principles prose restates points made later — so it fits 'efficient; minor instances that could be trimmed' rather than the every-token-earns-its-place anchor at 5.

4 / 5

Actionability

Mostly executable guidance: copy-paste-ready dotnet ef commands with real project paths and flags, concrete SQL (SET lock_timeout, CREATE INDEX CONCURRENTLY, the pg_index validity query), and a C# builder annotation. It falls short of 5 because Patterns B and C ('Deploy app code writing to both old and new schema. Backfill existing records in background batch', 'Dual write to both columns') describe phases directionally without concrete SQL or command examples.

4 / 5

Workflow Clarity

A clearly sequenced 5-step workflow (create migration → generate/inspect SQL → apply zero-downtime patterns → deploy across environments → rollback) with explicit validation checkpoints: the SQL Safety Inspection Checklist before deployment, PITR/WAL backup verification before production, and a post-rollback index-validity query. Error-recovery feedback is present (lock_timeout expiry → check pg_stat_activity before forcing), so the destructive-operation cap at 3 does not apply — this matches the 'explicit validation steps; feedback loops; checklists' anchor.

5 / 5

Progressive Disclosure

Well-organized single-file guide with clearly signaled sections and no nested or buried references (no bundle files exist). It fits 'good structure; most content appropriately placed' rather than 5, because at ~150 lines the zero-downtime patterns and rollback detail could plausibly live in separate reference files, and the under-50-lines exception does not apply.

4 / 5

Total

17

/

20

Passed

Description

75%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 specific, well-scoped description with comprehensive capability coverage and low conflict risk, written in third person. Its main weakness is the complete absence of 'when to use' trigger guidance, which leaves the reader to infer applicability.

Suggestions

Append an explicit trigger clause, e.g. 'Use when modifying FinanceHub database schemas, running dotnet ef migrations, or deploying PostgreSQL schema changes to staging/production.'

Add natural synonyms users might phrase the request with, such as 'dotnet ef', 'database migration', 'Entity Framework', or 'update database', to broaden trigger matching.

Keep the action list as-is — it already covers the full lifecycle comprehensively.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — 'migration creation, SQL script generation and validation, zero-downtime schema updates, lock timeout safety, and rollback procedures' — anchored to a named domain (EF Core Migrations, PostgreSQL), giving comprehensive coverage of the create→deploy→rollback lifecycle. It clearly matches the 'multiple specific concrete actions; comprehensive coverage' anchor rather than the score-4 anchor, which expects minor gaps in coverage.

5 / 5

Completeness

It clearly answers 'what' (a safe migrations workflow covering creation, SQL validation, zero-downtime updates, and rollbacks) but contains no 'Use when...' clause or any equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4, because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Good keyword coverage including natural terms users would say: 'EF Core Migrations', 'PostgreSQL', 'schema updates', 'rollback'. A few natural terms are missing (e.g., 'dotnet ef', 'database migration', 'Entity Framework', 'update database'), so it fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive synonyms-and-extensions anchor at 5.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — EF Core Migrations specifically for FinanceHub PostgreSQL databases — with distinct trigger terms and minimal overlap risk with generic database or document skills. It matches the 'clear niche with distinct triggers' anchor.

5 / 5

Total

17

/

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

JoseMD12/finance-hub

Path

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