CtrlK
BlogDocsLog inGet started
Tessl Logo

framework-migration-deps-upgrade

You are a dependency management expert specializing in safe, incremental upgrades of project dependencies. Plan and execute dependency updates with minimal risk, proper testing, and clear migration pa

32

Quality

26%

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

The canonical home for this skill is framework-migration-deps-upgrade in rmyndharis/antigravity-skills

SKILL.md
Quality
Evals
Security

Quality

Content

11%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is essentially a template with no substantive content. It provides no concrete commands, tools, code examples, or specific workflows for dependency upgrades—just generic meta-instructions and a list of desired output sections. The referenced implementation playbook is not provided, so the skill offers almost no actionable guidance on its own.

Suggestions

Add concrete, executable examples: specific package manager commands (e.g., `npm outdated`, `pip list --outdated`), actual upgrade commands, and version pinning syntax for at least one ecosystem.

Define a clear step-by-step workflow with validation checkpoints, e.g.: 1) Audit current deps → 2) Categorize by risk (patch/minor/major) → 3) Upgrade patch versions → 4) Run test suite → 5) If tests fail, revert and investigate → 6) Proceed to minor versions, etc.

Remove generic filler sections ('Use this skill when', 'Do not use this skill when', 'Context') that restate obvious information, and replace with specific tool usage patterns and concrete examples of handling breaking changes.

Either provide the referenced `resources/implementation-playbook.md` bundle file or inline the essential patterns and examples directly in the SKILL.md.

DimensionReasoningScore

Conciseness

The skill explains concepts Claude already knows (what dependency management is, what safe upgrades mean), includes redundant 'Use this skill when' / 'Do not use this skill when' sections that add little value, and the Context section restates the description. The instructions are generic platitudes ('Clarify goals, constraints, and required inputs') rather than domain-specific guidance.

2 / 5

Actionability

The skill provides no concrete commands, code examples, or specific tools. Instructions like 'Apply relevant best practices and validate outcomes' and 'Provide actionable steps and verification' are entirely vague meta-instructions. There is no executable guidance whatsoever—no package manager commands, no specific upgrade workflows, no concrete examples of handling breaking changes.

1 / 5

Workflow Clarity

There is no sequenced workflow with defined steps. The Output Format section lists deliverables but not a process to follow. There are no validation checkpoints, no feedback loops, and no error recovery steps. For a skill involving potentially destructive batch operations (dependency upgrades), the complete absence of validation steps is a critical gap.

1 / 5

Progressive Disclosure

The skill references `resources/implementation-playbook.md` but no bundle files are provided, making the reference unverifiable and potentially broken. The main content is thin enough that it doesn't need splitting, but the referenced file appears to be where all the actual substance would live, making the SKILL.md itself an empty shell rather than a useful overview.

2 / 5

Total

6

/

20

Passed

Description

41%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 truncated mid-sentence, which significantly undermines its effectiveness. While it identifies the domain (dependency management) and hints at concrete actions, it lacks a 'Use when...' clause, comprehensive trigger terms, and uses second-person framing ('You are') which is inappropriate for a skill description that should use third person voice.

Suggestions

Complete the truncated description and add an explicit 'Use when...' clause with trigger phrases like 'update dependencies', 'outdated packages', 'upgrade library', 'npm update', 'version bump'.

Rewrite in third person voice (e.g., 'Plans and executes dependency updates...') instead of the current second person 'You are...' framing.

Add specific capability details such as analyzing changelogs, detecting breaking changes, handling peer dependency conflicts, and supporting specific package managers (npm, pip, cargo, etc.).

DimensionReasoningScore

Specificity

Names the domain (dependency management) and mentions a couple of concrete actions ('plan and execute dependency updates'), but the description is truncated and lacks comprehensive coverage of specific capabilities like version pinning, changelog review, or conflict resolution.

3 / 5

Completeness

The description provides a partial 'what' (plan and execute dependency updates with minimal risk, testing, and migration paths) but has no explicit 'when' clause or trigger guidance. Additionally, the description appears truncated, cutting off mid-sentence, which further reduces completeness.

2 / 5

Trigger Term Quality

Includes relevant terms like 'dependency management', 'upgrades', 'dependency updates', 'migration', and 'testing', but misses common natural phrases users would say such as 'update packages', 'npm update', 'outdated dependencies', 'package.json', 'breaking changes', or specific package manager names.

3 / 5

Distinctiveness Conflict Risk

The focus on dependency management and upgrades is somewhat specific, but terms like 'testing' and 'migration' could overlap with general testing or migration skills. The truncated description makes it harder to establish a clear niche.

3 / 5

Total

11

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.