CtrlK
BlogDocsLog inGet started
Tessl Logo

cursor-upgrade-migration

Upgrade Cursor versions, migrate from VS Code, and transfer settings between machines. Triggers on "upgrade cursor", "update cursor", "cursor migration", "cursor new version", "vs code to cursor", "cursor changelog".

67

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

65%

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

The body is highly actionable with concrete commands and validation checklists, but it duplicates content that already lives in the orphaned references/ bundle, keeps time-sensitive version specifics inline, and lacks feedback loops around batch extension-reinstall operations. Tightening inline prose into signaled reference links and adding verify/retry steps would lift the weaker dimensions.

Suggestions

Progressive disclosure: turn SKILL.md into an overview that links to the existing references/ files (e.g., replace the inline Pre-Upgrade Checklist with "See [pre-upgrade-checklist.md](references/pre-upgrade-checklist.md)"), so the bundle is actually navigated rather than duplicated inline.

Workflow clarity: add a validation/feedback step to the batch extension-reinstall loops (e.g., re-run `cursor --list-extensions` and `diff` against the backup file, retry failures) and add error-recovery guidance to the Post-Upgrade Verification checklist for failing checks.

Conciseness: move time-sensitive version specifics (Cursor 2.0 features, "up to 8 simultaneous agents") to the changelog link or a dedicated deprecated/old-patterns section, and trim obvious prose like the side-by-side "they use separate: Settings directories..." list.

DimensionReasoningScore

Conciseness

The body is mostly efficient commands and checklists, but it carries unnecessary explanatory prose ("Both can be installed simultaneously. They use separate: Settings directories, Extension directories"), a somewhat fluffy Enterprise section, and time-sensitive version specifics ("Cursor 2.0 introduced... Parallel agents (up to 8 simultaneous)") that the rubric says should penalize conciseness unless placed in a deprecated section.

2 / 3

Actionability

It provides concrete, copy-paste-ready commands throughout ("brew upgrade --cask cursor", "cp -r ~/Library/Application\ Support/Cursor/User ~/cursor-settings-backup", "while read ext; do cursor --install-extension \"$ext\"; done < extensions-backup.txt") plus specific UI paths ("Help > Check for Updates", "Cmd+Shift+P > Extensions: Install from VSIX..."), matching the fully-executable anchor.

3 / 3

Workflow Clarity

Sequences and validation checklists exist (the 8-item Post-Upgrade Verification section, and the .cursorrules migration's "Delete .cursorrules after confirming" gate), but the batch extension-reinstall `while read` loop (used in both VS Code migration and machine transfer) has no validation/feedback that installs succeeded, and the verification checklist gives no error-recovery guidance for failing checks — the rubric caps workflow_clarity at 2 for batch operations missing feedback loops.

2 / 3

Progressive Disclosure

A references/ bundle of 7 files exists (pre-upgrade-checklist.md, vs-code-to-cursor-migration.md, etc.) but the body links to none of them; instead it duplicates that content inline (the body's Pre-Upgrade Checklist and VS Code to Cursor Migration sections overlap the reference files), so references are present but not signaled and content that should be separate is inline — the anchor-2 pattern. Not 1 because the body is sectioned (not a monolithic wall) and references are one level deep, not nested.

2 / 3

Total

9

/

12

Passed

Description

100%

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 strong across the board: it names three concrete actions, supplies natural trigger phrases with good variation coverage, explicitly answers both what and when, and occupies a distinct Cursor-specific niche with low conflict risk. No changes needed.

DimensionReasoningScore

Specificity

"Upgrade Cursor versions, migrate from VS Code, and transfer settings between machines" lists three distinct concrete actions, matching the level-3 anchor ("Lists multiple specific concrete actions"); it is not level 2 because it enumerates specific actions rather than merely naming a domain with partial actions. Voice is imperative/third-person, so no specificity penalty applies.

3 / 3

Completeness

It states what the skill does (upgrade/migrate/transfer) and gives explicit when-guidance via "Triggers on ...", which is the equivalent of a "Use when..." clause the rubric requires to exceed level 2; it is not level 2 because the trigger guidance is explicit rather than missing or only implied.

3 / 3

Trigger Term Quality

Triggers "upgrade cursor", "update cursor", "cursor migration", "cursor new version", "vs code to cursor", and "cursor changelog" are natural phrases a user would actually say, with good coverage including the upgrade/update variation — matching the level-3 "good coverage of natural terms" anchor rather than the level-2 "some relevant keywords but missing common variations".

3 / 3

Distinctiveness Conflict Risk

The Cursor-specific triggers ("upgrade cursor", "cursor migration", "vs code to cursor", "cursor changelog") carve a clear niche unlikely to fire for unrelated skills, matching the level-3 "clear niche with distinct triggers; unlikely to conflict" anchor rather than the level-2 overlap case.

3 / 3

Total

12

/

12

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
jeremylongshore/claude-code-plugins-plus-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.