CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-migration

Analyze Mattermost schema migrations against best practices and generate a review report. Pass a migration number/name as argument or omit to auto-detect new migrations.

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/review-migration/skills/review-migration/SKILL.md
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, actionable, and concise workflow skill whose steps, commands, and output template are concrete and executable. Its main weaknesses are the missing reference.md bundle file it depends on and the absence of fallback/validation guidance for the runtime guide fetch.

Suggestions

Add reference.md to the bundle (or inline its key facts, or remove the pointer) — the body leans on it for morph driver behavior, large-table guidance, and empty-table rules, but the file does not exist.

Add a fallback for Step 1 in case the WebFetch of the official migration guide fails (e.g. proceed with reference.md rules only, noting the gap in the report).

De-duplicate Step 3's attention list against the Safety Analysis table in the template, keeping the rationale in only one place.

DimensionReasoningScore

Conciseness

The body is lean and directive with no padding or explanations of known concepts; the only trimmable redundancy is that Step 3's bullet list ('Whether CONCURRENTLY is used...') repeats checks already encoded in the report template table.

4 / 5

Actionability

Gives exact glob patterns, concrete git diff commands, a complete fill-in report template with exact status values, and a save path. Minor gaps: the referenced reference.md does not exist in the bundle, and Step 1 depends entirely on a live WebFetch with no fallback.

4 / 5

Workflow Clarity

A clear 5-step sequence with error-recovery branches ('If nothing is found, ask the user', 'If the down migration is missing, flag it') and a checklist-style report template; the gap is no guidance for what to do if the official guide fetch fails.

4 / 5

Progressive Disclosure

The single-file body is well-sectioned per step and the external guide link is clearly signaled, but the one bundle reference, reference.md, is dangling — the file is absent from the bundle, so navigation breaks at the exact point detailed knowledge is needed.

3 / 5

Total

15

/

20

Passed

Description

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

The description is domain-specific and conflict-free, with a clear statement of what the skill does, but it lacks any 'when to use' trigger guidance and misses common synonym terms. It sits at the midpoint of the rubric.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to review a migration, schema change, or database migration in a Mattermost repo.'

Include natural synonym terms users might say, such as 'database migration', 'SQL migration', 'schema change', or '.up.sql/.down.sql files'.

Enumerate one or two more concrete capabilities (e.g. 'check CONCURRENTLY usage, lock types, and ESR backwards compatibility') to raise specificity.

DimensionReasoningScore

Specificity

Names the domain ('Mattermost schema migrations') and 1-2 concrete actions ('Analyze... against best practices', 'generate a review report'), but the second sentence is invocation syntax rather than an additional capability, so coverage is not comprehensive.

3 / 5

Completeness

The 'what' is clear (analyze migrations, generate a report), but there is no 'Use when...' clause or equivalent trigger guidance; the argument/auto-detect sentence describes invocation mechanics, not when to reach for the skill, which caps completeness at 3.

3 / 5

Trigger Term Quality

'Mattermost', 'schema migrations', and 'review report' are natural terms for the target user, but common variations such as 'database migration', 'SQL migration', or 'schema change' are missing.

3 / 5

Distinctiveness Conflict Risk

'Analyze Mattermost schema migrations' occupies a clear niche with distinct triggers; it is unlikely to fire for any unrelated skill.

5 / 5

Total

14

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

mattermost/mattermost-ai-marketplace

Path

plugins/review-migration/skills/review-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.