CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

migration-migrate-module

Use when a complete module needs migration to the target architecture - runs 6 phases with approval gates.

Quality

69%

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 ./packs/svelte/skills/migration-migrate-module/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 an exemplar of token efficiency: a tight phase-by-phase migration plan with concrete file targets, technology mappings, and per-phase validation gates. Its few gaps are the unexplained @migrator delegation, a conversion-table reference with no backing file, and the phase-count mismatch with the description.

DimensionReasoningScore

Conciseness

The ~20-line body is pure directive with zero padding: technologies (Svelte 4 vs 5, SvelteKit load functions, runes) are referenced without tutorial explanation, matching the lean-and-efficient anchor where every token earns its place.

5 / 5

Actionability

Guidance is mostly concrete — specific paths (src/lib/modules/[name]/, .types.ts + .contracts.ts), specific conversions (runes, native fetch), and named checks (svelte-check) — but actual validation commands are not spelled out, "(see conversion table)" points to no file in the bundle, and @migrator is undefined.

4 / 5

Workflow Clarity

A clear 7-phase sequence with explicit per-phase validation ("Validate build/svelte-check/tests after each phase") and approval gates; held below 5 by the missing fix-and-revalidate error-recovery loop, a "6 phases" claim that conflicts with the 7 phases listed (0-6), and the dangling conversion-table reference.

4 / 5

Progressive Disclosure

As a short, well-organized skill (<50 lines, clear sections) it qualifies for full marks on structure, but the body references a "conversion table" and @migrator with no corresponding bundle files present, leaving a minor navigation gap.

4 / 5

Total

17

/

20

Passed

Description

45%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 has a clear, explicit trigger clause but describes the skill only at a process level. It fails to enumerate any concrete migration actions, weakens the "what" side of completeness, and relies on an undefined "target architecture" for distinctiveness.

Suggestions

Enumerate 2-3 concrete actions in the description, e.g., "Creates module structure under src/lib/modules/, converts Svelte 4 components to 5 runes, and extracts typed services and contracts" — this would lift both specificity and completeness.

Add natural trigger synonyms users would actually say, such as "migrate", "port", or "modernize a module", to improve trigger-term coverage.

Name the target architecture concretely (e.g., the SvelteKit 2 / Svelte 5 module architecture from docs/ARCHITECTURE.md) so the skill is distinguishable from other migration-related skills.

DimensionReasoningScore

Specificity

"runs 6 phases with approval gates" names the process but lists no concrete capabilities (e.g., converting components, creating type contracts, moving files), matching the anchor for domain-named-but-generic actions rather than the 1-2 concrete actions of score 3.

2 / 5

Completeness

The "when" is explicit ("Use when a complete module needs migration to the target architecture") but the "what" is vague — "runs 6 phases" never states what is actually done to the module — placing it between the when-only anchor and the both-present anchor.

3 / 5

Trigger Term Quality

"module" and "migration" are natural trigger terms, but common synonyms users would say ("migrate", "port", "refactor", "modernize") are absent, matching the anchor for some relevant keywords with missing variations.

3 / 5

Distinctiveness Conflict Risk

"complete module" and "target architecture" carve a niche, but "migration" is an overloaded term (database, cloud migrations) and "target architecture" is undefined, so overlap with sibling migration skills remains plausible.

3 / 5

Total

11

/

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

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/specialist-agent

Path

packs/svelte/skills/migration-migrate-module/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.