CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

framework-migration-deps-upgrade

Plan incremental dependency upgrades with breaking-change analysis, migration guidance, and regression testing. Use when updating packages while controlling compatibility risk.

Quality

61%

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 ./skills/framework-migration-deps-upgrade/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a generic template with little domain-specific substance: no concrete commands, tools, or sequenced workflow for actually executing dependency upgrades, and a substantial share of boilerplate padding. Its single external reference is broken — `resources/implementation-playbook.md` does not exist in the bundle. The Output Format section is the strongest element, giving concrete deliverable structure.

Suggestions

Replace the generic Instructions with a concrete ordered workflow and specific commands (inventory outdated dependencies, group by semver impact, upgrade patch then minor then major, run the test suite between each step) with explicit validation checkpoints.

Delete the template filler — the 'Use this skill when'/'Do not use this skill when' tautologies, 'Requirements', the persona paragraph, and the closing repetition — since the frontmatter description already covers triggers.

Fix the broken progressive-disclosure pointer: `resources/implementation-playbook.md` does not exist in the bundle; either ship the playbook with migration patterns and examples or remove the reference.

DimensionReasoningScore

Conciseness

Several sections are pure template padding that adds nothing Claude doesn't know: "The task is unrelated to dependency upgrade strategy", "You need a different domain or tool outside this scope", "Take the requirements, target, and scope from the user's request", and the closing "Focus on safe, incremental upgrades..." restating the opening. This matches score 2's 'several unnecessary explanations or padded sections' rather than 3's 'mostly efficient', since filler is a large share of the body; it avoids 1 because no basic concepts are explained.

2 / 5

Actionability

The instructions are high-level hints — "Clarify goals, constraints, and required inputs", "Apply relevant best practices and validate outcomes" — with no commands, tools, or concrete steps (no lockfiles, semver ranges, or package-manager commands anywhere). The 8-item Output Format is the only concrete guidance, so this sits at 2 ('minimal concrete guidance; high-level hints but missing the specific steps') rather than 1, and below 3 because the deliverable names are structure, not executable detail.

2 / 5

Workflow Clarity

There is no ordered workflow: the instructions are unordered generic bullets, validation appears only abstractly ("validate outcomes"), and Output Format items 1-8 imply only a deliverable order, matching score 2's 'rough sequence present but many gaps; steps poorly defined; validation absent'. Since dependency upgrades are batch/risky operations with no concrete feedback loops, the rubric caps this at 3; the near-total absence of a real sequence keeps it at 2 rather than 3, while an implied clarify-then-apply-then-verify progression keeps it off 1.

2 / 5

Progressive Disclosure

The body twice points to `resources/implementation-playbook.md` ("If detailed examples are required, open `resources/implementation-playbook.md`" and the Resources section), but no such file exists in the bundle — there are no references/, scripts/, assets/, or resources/ directories — so the clearly-signaled one-level reference is a dead end. The section structure itself is clean, putting this at 3 ('could be better organized / references present but not usable') rather than 4, where a resolvable reference path is a prerequisite; not 2 because nothing is inlined or buried.

3 / 5

Total

9

/

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.

The description cleanly states both what the skill does and when to use it, with several concrete capability areas and natural trigger language, in third-person imperative style. It falls just short of top marks only for lacking trigger synonyms (tool names, file types) and having a single, somewhat broad trigger condition. Conflict risk with other skills is low.

Suggestions

Add natural trigger synonyms and concrete artifacts users mention, e.g. 'bump versions', 'outdated dependencies', 'npm/pip update', 'package.json or requirements.txt'.

Sharpen the when-clause with additional concrete trigger conditions (e.g., 'major version bumps' or 'failing builds after an update') to achieve explicit multi-phrase trigger coverage.

DimensionReasoningScore

Specificity

"Plan incremental dependency upgrades with breaking-change analysis, migration guidance, and regression testing" lists several concrete capability areas, matching the score-4 anchor ('Extracts text from PDF files, fills forms, converts pages to images'). It is not 5 because the actions are abstract categories with no tools, commands, or file types, and not 3 because it names more than 1-2 concrete actions.

4 / 5

Completeness

It has a clear what ("Plan incremental dependency upgrades with breaking-change analysis, migration guidance, and regression testing") and an explicit when ("Use when updating packages while controlling compatibility risk"), matching the score-4 anchor. It is not 5 because the when-clause is a single condition rather than multiple concrete trigger phrases, and well above 3 since the trigger is explicit, not implied.

4 / 5

Trigger Term Quality

"updating packages", "breaking changes", and "compatibility risk" are natural phrases users would say, giving good keyword coverage per the score-4 anchor. It falls short of 5 because there are no synonyms, ecosystem/tool names, or file extensions (e.g., 'bump versions', 'outdated dependencies', 'npm', 'package.json'), and exceeds 3's 'some relevant keywords but missing common variations'.

4 / 5

Distinctiveness Conflict Risk

"breaking-change analysis", "migration guidance", and "regression testing" carve a niche distinct from generic package-management skills, matching 'mostly distinct; minor overlap risk'. It is not 5 because the trigger "updating packages" is broad enough to fire on routine install/update tasks handled by other skills.

4 / 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

rmyndharis/antigravity-skills

Path

skills/framework-migration-deps-upgrade/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.