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

78%

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

Quality

Content

86%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 lean, well-sequenced migration runbook with concrete directory structures, naming conventions, and technology mappings. Its main gaps are the absence of executable validation commands and an explicit error-recovery loop between phases.

DimensionReasoningScore

Conciseness

The ~25-line body is entirely instructional with zero padding — phrases like "Map the module (files, patterns, dependencies, Pages Router usage)" and "getServerSideProps -> async Server Component" convey dense specifics telegraphically without explaining any concept Claude already knows. It assumes competence throughout; every token earns its place.

5 / 5

Actionability

Guidance is mostly executable: exact directory layouts ("Create `src/modules/[name]/` (components/, hooks/, services/, adapters/, stores/, actions/, types/, __tests__/)"), exact file conventions ("Create `.types.ts` + `.contracts.ts` + adapter"), and specific tech mappings (React Query, Zustand, Server Actions). Minor gaps: no copy-paste validation commands ("Validate build/tsc/tests" names the checks but not the commands), and "Use `@migrator`" presumes the agent is already known. Not a 5 because nothing is copy-paste ready; not a 3 because the guidance is concrete and specific, not pseudocode or high-level hints.

4 / 5

Workflow Clarity

Seven phases are clearly numbered and sequenced, with an explicit repeated checkpoint ("Validate build/tsc/tests after each phase. Ask for approval before each phase.") — so the destructive/batch cap at 3 does not apply since validation is present. It falls short of the 5 anchor because there is no explicit error-recovery feedback loop (what to do when build/tsc/tests fail) and no checklist for the complex 7-phase process.

4 / 5

Progressive Disclosure

Per the rubric's simple-skill guidance, an under-50-line skill with no need for external references can score 5 with well-organized sections. The body is ~25 lines, cleanly sectioned, and its one external pointer (`docs/ARCHITECTURE.md`) is a clearly signaled, one-level-deep project reference rather than a nested skill reference.

5 / 5

Total

18

/

20

Passed

Description

62%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 correctly uses the 'Use when...' pattern with third-person phrasing and identifies a clear niche, but it describes the process shape rather than the actual migration capabilities and omits common trigger synonyms and the architecture's technology names.

Suggestions

State 2-3 concrete migration actions, e.g. 'Restructures the module into src/modules/[name]/, converts getServerSideProps to async Server Components, and migrates state to Zustand and mutations to Server Actions'.

Add natural trigger synonyms users would say — 'refactor', 'port', 'rewrite', 'convert' — and name the architecture (e.g. Next.js App Router) so the description fires on those phrasings.

Replace the vague 'target architecture' with the concrete architecture name to sharpen both the 'what' and the 'when' halves.

DimensionReasoningScore

Specificity

It names the domain ("a complete module needs migration to the target architecture") and one process-level detail ("runs 6 phases with approval gates"), but never states what the migration actually does — no mention of restructuring into modules/, converting Pages Router to App Router, or migrating state/data layers. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive); it exceeds anchor 2 because the phase/gate detail is more than a generic one-liner, and falls short of anchor 4's 'several specific actions'.

3 / 5

Completeness

It has an explicit trigger clause ("Use when a complete module needs migration to the target architecture") and a 'what' ("runs 6 phases with approval gates"), so both halves are present — matching anchor 4. It is not a 5 because the 'what' is a process characterization rather than concrete capability statements, and the 'when' leans on the vague phrase 'target architecture' instead of concrete trigger phrases.

4 / 5

Trigger Term Quality

Relevant natural keywords are present ("module", "migration", "target architecture" — a user asking to 'migrate this module' would trigger it), but common variations are missing: no 'refactor', 'port', 'rewrite', 'convert', or the technology names (Next.js, App Router, Pages Router) users would naturally mention. This fits anchor 3 (some relevant keywords, missing common variations/synonyms) rather than anchor 4's 'good coverage with only a few missing'.

3 / 5

Distinctiveness Conflict Risk

The scope qualifier "a complete module" plus the phase/gate structure distinguishes it from smaller-scope migration or refactoring skills, giving it a fairly clear niche with only minor overlap risk against closely related migration skills. It is not a 5 because 'migration to the target architecture' is generic enough to overlap with any refactor/rewrite skill since the target architecture is never named.

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

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/nextjs/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.