Migrate Workflows to Skills 是一个用于自动迁移遗留工作流的工具。其核心用途是将已被弃用的 workflow 文件迁移为现代 skill 文件。资料说明 workflows（位于 .agents/workflows/.md 或 _agents/workflows/.md）已弃用，而 skills（位于 .agents/skills/<name>/SKILL.md 或 _agents/skills/<name>/SKILL.md）不仅具备 workflow 的全部能力，还支持一级斜杠命令（在聊天输入框输入 /<name>）、语义化的智能体发现（相关时智能体可自动调用该 skill），以及多文件能力（支持辅助脚本、模板和引用）。
主要能力：第一步发现现有工作流，扫描全局与工作区的配置目录，查找遗留 .md 工作流文件与 workflows.json 清单。全局路径包括 ~/.gemini/config/global_workflows/.md、~/.gemini/config/workflows/.md 及清单 ~/.gemini/config/workflows.json；工作区路径包括 <workspace_root>/.agents/workflows/*.md、_agents、.agent、_agent 下的 workflows 目录及其 workflows.json 清单。对每个发现的工作流，检查目标目录下 <name>/SKILL.md 是否已存在，以判断是否已迁移，并以表格展示范围、名称、源路径、目标路径和状态。若未发现工作流或均已清理，则告知用户配置已干净；若全部已迁移，则直接进入归档清理，不覆盖现有 skill。
使用方式：调用该 skill 后自动执行迁移。第二步逐个转换工作流（幂等执行）：若目标 SKILL.md 已存在则不覆盖，跳过到清理步骤；否则读取源 .md 内容，检查 frontmatter 与正文，提取标题、描述或目的，生成包含 name 和 description 的标准 YAML frontmatter，保留原工作流的全部提示指令、参数与指南，创建目标目录并写入 SKILL.md。随后将旧 .md 文件重命名为 <name>.md.bak 作为备份而非永久删除，并从 workflows.json 清单中移除已迁移条目。第三步验证并确认所有目标 SKILL.md 存在、旧文件已重命名，向用户汇总新迁移的 skill、因已存在而跳过的 skill，以及归档为 .md.bak 的旧工作流。
其他说明：路径解析需适配宿主操作系统（Windows 用 %USERPROFILE%，macOS/Linux 用 $HOME），呈现表格、进度或摘要时使用宿主系统的路径分隔符。适用场景为将旧的 workflow 配置平滑升级为 skill 结构。限制方面，资料未提供收费、平台支持范围或效果保证等信息，暂未提供。