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

75%

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

Quality

Content

78%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 and clean phase sequencing with validation and approval checkpoints, but it stops short of executable guidance: validation steps lack concrete commands, conformance checking is undefined, and the central '@migrator' dependency is assumed rather than documented.

DimensionReasoningScore

Conciseness

The ~20-line body is lean and instructive throughout: it never explains concepts Claude already knows (signals, OnPush, inject()) and every line carries actionable content. This matches anchor 5 ('lean and efficient; assumes Claude's competence; every token earns its place').

5 / 5

Actionability

Per-phase specifics are concrete ('.types.ts + .contracts.ts', 'src/modules/[name]/', 'WritableSignal + asReadonly()', 'input()/output()'), but there are no executable commands: 'Validate build/tsc/tests after each phase' names no actual commands, 'Validate conformance' is undefined, and '@migrator' is an undocumented external dependency. This fits anchor 3 ('some concrete guidance but incomplete; missing key details') rather than 4, where the gaps would be minor.

3 / 5

Workflow Clarity

Seven phases are clearly sequenced with explicit checkpoints ('Validate build/tsc/tests after each phase', 'Ask for approval before each phase'), so the destructive/batch cap of 3 does not apply since validation is present. Not 5 because there is no error-recovery feedback loop (what to do when a phase's validation fails) and a minor inconsistency exists: the description says '6 phases' while the body lists Phase 0 through Phase 6.

4 / 5

Progressive Disclosure

The skill is under 50 lines, self-contained with no bundle files (references/, scripts/, assets/ are absent), and organized into a clear '## Steps' section. Per the rubric's simple-skill guideline, this earns anchor 5 with well-organized sections alone.

5 / 5

Total

17

/

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 has an explicit when-clause and a distinct niche, but the what is under-specified: it states a phase count and approval gates without naming any concrete capability (what the migration does to the code). Trigger coverage is domain-relevant but lacks synonyms and any framework-specific terms users would naturally say.

Suggestions

Name 2-3 concrete actions in the description, e.g. 'Migrates NgModule modules to standalone components, converts BehaviorSubject state to signals, and extracts typed service contracts in 6 gated phases.'

Add natural trigger terms and synonyms users would actually say, such as 'migrate', 'refactor', 'modernize', 'convert to standalone components', or 'migrate to signals'.

Mention the target stack (e.g., Angular) in the description so users phrasing the request around the framework naturally trigger this skill.

DimensionReasoningScore

Specificity

Names the domain ("complete module needs migration to the target architecture") and 1-2 process actions ("runs 6 phases with approval gates"), but never states what the migration actually does (no mention of services, signals, standalone components, or the framework involved). It matches anchor 3 rather than 4 because no specific capability actions are listed.

3 / 5

Completeness

Both parts are explicit: "runs 6 phases with approval gates" answers what, and "Use when a complete module needs migration to the target architecture" is an explicit when-clause. Not 5 because the what is thin — no concrete description of what the phases accomplish; not 3 because the when is explicit, not weakly implied.

4 / 5

Trigger Term Quality

Relevant keywords like "module", "migration", and "target architecture" are present, but common natural variations are missing ("migrate to signals", "convert to standalone", "refactor module") and no framework or file-extension terms appear. This fits anchor 3 (some relevant keywords, missing synonyms) better than 4, since synonym coverage is absent rather than merely incomplete.

3 / 5

Distinctiveness Conflict Risk

"complete module" and "target architecture" carve a mostly distinct niche with only minor overlap risk against hypothetical sibling skills (e.g., a component-level migration skill). Not 5 because "migration" and "module" are still broad words that lack highly distinct trigger phrases.

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