framework-migration-assistant

Automatically migrate Python web applications between frameworks (Flask → FastAPI, Django → FastAPI). Use when you need to migrate an existing web application to a modern framework while preserving functionality. The skill analyzes the codebase, updates routes, handlers, configuration, dependency injection patterns, and tests. Creates git commits for each migration phase and generates a comprehensive summary of all changes. Supports automatic dependency updates, code transformations, and test adaptations.

1.24x

Quality

86%

Does it follow best practices?

Impact

93%

1.24x

Average score across 3 eval scenarios

Securityby

Passed

No findings from the security scan

Quality

Content

80%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 highly actionable and well-structured with real, correctly-referenced bundle files. Its main weakness is workflow clarity: a destructive, batch code-modification process is documented without explicit validation/verification checkpoints between phases.

Suggestions

Insert an explicit validation step after each migration phase (e.g., run the test suite or a syntax/import check) and document a validate→fix→retry feedback loop before committing, since this is a destructive batch operation that currently caps workflow_clarity at 3.

Remove overlap between the Quick Start 'migration process will' list and the Migration Process phases so the same sequence isn't described twice.

Trim the Tips and Troubleshooting sections to the genuinely non-obvious items to reduce token weight without losing clarity.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with concrete commands and code examples throughout, though the Quick Start process list and Migration Process phases overlap, and the Tips/Troubleshooting/Post-Migration sections carry some padding that could be trimmed.	4 / 5
Actionability	Provides copy-paste-ready commands ('python scripts/migrate.py . --from flask --to fastapi'), executable before/after code transformations, and concrete importable module usage covering the common cases.	5 / 5
Workflow Clarity	The migration is a destructive/batch operation that mutates a codebase and creates git commits per phase, yet the documented workflow has no explicit per-phase validation checkpoint or validate→fix→retry feedback loop before committing; the rubric caps such workflows at 3.	3 / 5
Progressive Disclosure	Clear overview with well-signaled, one-level-deep references to real bundle files (references/framework_comparison.md, migration_guide.md, migration_patterns.md) and assets/, all of which exist, with bulk detail appropriately split out.	5 / 5
	Total	17 / 20 Passed

Description

92%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.

A strong, specific description that concretely enumerates the skill's capabilities and includes an explicit 'Use when' trigger. The only minor gap is trigger-term synonym/extension coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'analyzes the codebase, updates routes, handlers, configuration, dependency injection patterns, and tests', 'Creates git commits for each migration phase', 'generates a comprehensive summary' — giving comprehensive coverage of what the skill does.	5 / 5
Completeness	Clearly answers 'what' (migrates web apps between frameworks, updating routes/config/tests/dependencies) and 'when' with an explicit 'Use when you need to migrate an existing web application to a modern framework while preserving functionality' trigger clause.	5 / 5
Trigger Term Quality	Includes natural phrases like 'migrate an existing web application to a modern framework' and named frameworks (Flask, FastAPI, Django), but lacks common synonyms or file/extension markers that would push it to comprehensive coverage.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche — Python web framework migration between specifically named frameworks — with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: ArabelaTso/Skills-4-SE
Path: skills/framework-migration-assistant/SKILL.md
Commit: 4f38503

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.