CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

migrate-architecture

Use when transforming a project's architecture pattern - e.g., Flat to Modular, MVC to Clean Architecture, Monolith to Modular Monolith.

Quality

77%

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/migrate-architecture/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 delivers a clear, well-sequenced four-phase workflow with explicit validation commands, feedback loops, and checklists — the strongest part of the skill. Its weaknesses are moderate token inefficiency (redundant planning/execution steps, re-explanations of well-known architecture patterns) and a monolithic single-file layout where per-pattern migration strategies could live in one-level-deep reference files.

Suggestions

Trim the pattern tables' description columns to bare pattern names (Claude already knows what MVC, Clean Architecture, DDD, and Atomic Design are) and collapse the Phase 2a–2e sub-steps that are restated verbatim in Phase 3 to cut roughly a third of the token load.

Move the 'Migration Strategies by Pattern' detail into one-level-deep reference files (e.g., references/strategies/modular-to-clean.md) with a short index in SKILL.md, so only the relevant strategy is loaded per migration.

Add one concrete copy-paste example each for a barrel export (index.ts) and an import-path rewrite to close the gap between directional guidance and fully executable instruction.

DimensionReasoningScore

Conciseness

The body is mostly efficient but contains trimmable material: the pattern tables' Description columns restate concepts Claude already knows (e.g., 'Hexagonal (Ports & Adapters) | Core with ports, infrastructure in adapters', 'Atomic Design | Components by granularity: atoms > molecules > organisms'), Phase 2's sub-steps 2a–2e are repeated nearly verbatim in Phase 3, and the Anti-Patterns table overlaps the Rules ('Migrating everything at once' vs 'ONE module at a time - never parallel moves'). This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') — above anchor 2 because there is no heavy padding or tutorial-style prose, but below anchor 4 because the redundant planning/execution steps and known-concept descriptions are more than minor.

3 / 5

Actionability

Provides mostly executable guidance: copy-paste-ready validation commands ('npx tsc --noEmit 2>&1 | head -50', 'npm test 2>&1 | tail -20'), concrete file conventions ('.types.ts + .contracts.ts', co-located '__tests__/', 'index.ts' barrels), explicit file-mapping rules, and exact report templates. This matches anchor 4; it falls short of anchor 5 because the core migration operations (file moves, import rewrites, barrel-export contents) are described directionally rather than given as concrete copy-paste examples.

4 / 5

Workflow Clarity

The four-phase workflow (Assessment → Planning → Execution → Validation) has a clear sequence, an explicit user-confirmation checkpoint ('Ask for confirmation before proceeding'), explicit validation with commands (TypeScript noEmit check, import-rule validation, tests), a per-module validation rule ('VALIDATE after each module migration'), and an explicit error-recovery feedback loop ('If TypeScript errors appear, FIX them before continuing'), with the Rules and Anti-Patterns tables acting as checklists. This matches anchor 5; anchor 4 would apply only if validation or the fix-before-continuing loop were implicit rather than stated as enforced steps.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the ~235-line body is well structured with clear headers, tables, and easy navigation. Most content is appropriately placed in the single file, matching anchor 4, but the ~80-line pattern-specific 'Migration Strategies by Pattern' section is detail that could be split into one-level-deep reference files, which keeps it below anchor 5's 'content appropriately split' standard; it stays above anchor 3 because nothing is buried and the structure is consistently well organized.

4 / 5

Total

16

/

20

Passed

Description

73%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 is a well-formed trigger statement with a clear 'Use when' clause and highly distinctive, concrete pattern-conversion examples that minimize conflict risk with other skills. Its main weaknesses are a thin 'what' (only the generic verb 'transforming') and missing natural trigger verbs like 'migrate' or 'refactor' that users would commonly say.

Suggestions

State what the skill actually does, not just when to use it — e.g., 'Moves files to the target structure, updates import paths, creates barrel exports, and validates with TypeScript' — to raise specificity and give the 'what' independent substance.

Add natural trigger verbs users would say, such as 'migrate', 'refactor', or 'restructure' (e.g., 'Use when the user asks to migrate or restructure a project's architecture...') to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('transforming a project's architecture pattern') with concrete example conversions ('Flat to Modular, MVC to Clean Architecture, Monolith to Modular Monolith'), but describes only one generic action — 'transforming' — without listing what the migration involves (file moves, import updates, validation). It names the domain with concrete examples but is not comprehensive, matching anchor 3; it is above anchor 2 because the pattern-pair examples are specific rather than generic, but below anchor 4 because no specific migration actions are enumerated.

3 / 5

Completeness

Has an explicit 'when' ('Use when transforming a project's architecture pattern') and a 'what' (architecture pattern transformation, illustrated with concrete examples), so both are present as at anchor 4. It is not score 3 because the 'when' is explicit rather than weakly implied, and not 5 because the 'what' is minimal — the what and when are the same clause, with no concrete statement of what the skill actually does during a migration.

4 / 5

Trigger Term Quality

Includes natural, specific terms users would say: 'Flat to Modular', 'MVC to Clean Architecture', 'Monolith to Modular Monolith', 'architecture pattern', 'transforming'. This is good keyword coverage matching anchor 4, but common verb variations users would naturally say — 'migrate', 'refactor', 'restructure', 'convert' — are missing, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche — architecture-pattern migration — with distinct triggers (named pattern conversions like 'MVC to Clean Architecture') that no generic refactoring or code-review skill would claim, matching anchor 5's 'clear niche with distinct triggers; minimal conflict risk'. It is above anchor 4 because the named pattern pairs are highly specific rather than merely 'mostly distinct'.

5 / 5

Total

16

/

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

skills/migrate-architecture/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.