model-migrate-flagos

Migrates a model from latest vLLM upstream into vllm-plugin-FL via 13-step copy-and-patch workflow with validation scripts.

18|12|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/flagos-ai/skills --skill model-migrate-flagos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: model-migrate-flagos
Source: https://github.com/flagos-ai/skills/tree/main/skills/model-migrate-flagos
Command: npx skills add https://github.com/flagos-ai/skills --skill model-migrate-flagos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Migrates a model from the latest vLLM upstream into the vllm-plugin-FL project pinned to v0.13.0, preserving upstream implementations while applying compatibility patches and validating end-to-end.

Core Features & Use Cases

  • End-to-end migration pipeline (13 steps) combining copy-then-patch with patch catalog
  • Automatic registration and validation of migrated models in the plugin
  • E2E accuracy verification against upstream GT with token-level comparison
  • Config-bridge approach to avoid upgrading transformers
  • Reusable scripts for migration, benchmarking, serving, and evaluation
  • Use case: migrate a new vLLM model like qwen3_5 or kimi_k25 into the FL plugin

Quick Start

Invoke the skill with a model name to start the 13-step migration workflow.

Frequently Asked Questions about model-migrate-flagos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a vLLM model into the vllm-plugin-FL project?

To migrate a vLLM model into the vllm-plugin-FL project, invoke this skill with the model name to trigger a 13-step copy-then-patch workflow that applies compatibility patches, registers the model, and runs end-to-end verification against upstream ground truth.

What is the process for backporting upstream vLLM models to an older plugin version?

Backporting upstream vLLM models to an older plugin version involves a copy-then-patch workflow utilizing a config-bridge approach to avoid upgrading transformers, ensuring compatibility while preserving the original upstream implementations during migration.

How does end-to-end verification work for migrated vLLM models?

End-to-end verification for migrated vLLM models works by running provided scripts like e2e_eval.py to perform token-level comparison against upstream ground truth, ensuring the migrated model in the FL plugin produces repeatable and accurate results.

Can I use a config-bridge approach to avoid upgrading transformers when migrating vLLM models?

Yes, you can use a config-bridge approach to avoid upgrading transformers when migrating vLLM models into the vllm-plugin-FL project pinned to v0.13.0, allowing you to apply necessary compatibility patches without forcing a full dependency upgrade.

What scripts are needed for vLLM model migration, benchmarking, and serving?

The scripts needed for vLLM model migration, benchmarking, and serving include validate_migration.py, benchmark.sh, serve.sh, request.sh, and e2e_eval.py, which collectively orchestrate the migration pipeline and validate the end-to-end results.

Does the vllm-plugin-FL migration workflow support automatic model registration?

Yes, the vllm-plugin-FL migration workflow supports automatic model registration, automatically registering and validating the migrated models within the plugin as part of its comprehensive 13-step migration pipeline.