CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

db-ops

Use when reviewing a PR that touches the Prisma schema or migrations, running migrations in staging or production, or auditing schema changes for safety.

Quality

87%

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

90%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.

An exemplary operational checklist: dense with executable commands, explicit safety conditions, and verification steps for destructive operations. The only gaps are a missing failure-recovery branch in the deploy flow and no progressive-disclosure layering despite exceeding a single screen of content.

Suggestions

Add an explicit error-recovery branch to the deploy procedure: what to do when `npx prisma migrate status` does not report all migrations applied (e.g., re-run, inspect the failed migration, or invoke the rollback section).

Consider moving environment credential details (dev/test/vault paths) into a short reference section or file so the core migration checklist stays even tighter.

DimensionReasoningScore

Conciseness

Lean throughout: every line is a rule, an executable command, or a project-specific rationale (e.g., "Zero-downtime deploys require that existing rows satisfy the new schema immediately"), with no padding and no explanation of concepts Claude already knows.

5 / 5

Actionability

Fully executable guidance throughout: copy-paste commands (`npx prisma migrate deploy`, `npx prisma migrate status`, grep checks), safe/unsafe Prisma snippets, a red-flags list for generated SQL, and an expected output string ("All migrations have been applied.") covering the common cases.

5 / 5

Workflow Clarity

Deploy, rollback, and deprecation-removal flows are clearly sequenced with validation checkpoints (status confirmation with expected output, SQL inspection before commit, grep reference checks before DROP), but there is no explicit error-recovery branch when `migrate status` shows an unapplied or failed migration, keeping it just below the top anchor.

4 / 5

Progressive Disclosure

A single well-sectioned file with clear headers and no buried or nested references, and all content is genuinely needed during a migration review; however, at ~95 lines with no disclosure layering or split of secondary detail (e.g., credentials), it does not fully meet the top anchor.

4 / 5

Total

18

/

20

Passed

Description

78%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-crafted trigger-focused description with specific, natural language and a clear niche. Its main weakness is that the skill's capabilities are only implied through the "Use when" clauses rather than stated explicitly.

DimensionReasoningScore

Specificity

Lists several concrete actions — "reviewing a PR that touches the Prisma schema or migrations", "running migrations in staging or production", "auditing schema changes for safety" — but omits capabilities the body covers (rollback, incident response), so coverage has minor gaps rather than being comprehensive.

4 / 5

Completeness

The "when" is explicit with three concrete trigger clauses, but the "what" is conveyed only through the gerund actions inside the trigger list — there is no separate capability statement, so it falls just below the anchor requiring both clearly and explicitly.

4 / 5

Trigger Term Quality

Natural phrases users would say are present ("reviewing a PR", "Prisma schema", "migrations", "staging or production"), but common variations like "database", "deploy", or file-level terms such as "schema.prisma" are missing.

4 / 5

Distinctiveness Conflict Risk

"Prisma schema", "migrations", and "staging or production" carve out a clear niche with distinct triggers and minimal risk of firing for unrelated skills.

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

tessl-fe/backend-api

Path

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