Discovers valid migration plans in the workspace and returns the selected plan path. A valid plan is a subdirectory of .github/modernize/ that contains plan.md AND tasks.json (tasks.json may be in the plan folder or in a .metadata subfolder). Handles 0, 1, or multiple plans and returns structured NEEDS_INPUT when a choice is needed.
Install
npx skills add microsoft/github-copilot-modernization --skill list-plansnpx skills add microsoft/github-copilot-modernization --skill list-plans -a claude-code -gnpx skills add microsoft/github-copilot-modernization --skill list-plans -a codex -ggemini skills install https://github.com/microsoft/github-copilot-modernization.git --path plugins/github-copilot-modernization/skills/list-plansgh skill install microsoft/github-copilot-modernization list-plansgit clone --depth 1 https://github.com/microsoft/github-copilot-modernization /tmp/microsoft__github-copilot-modernization
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/microsoft__github-copilot-modernization/plugins/github-copilot-modernization/skills/list-plans ~/.claude/skills/list-plans # Claude Code
cp -R /tmp/microsoft__github-copilot-modernization/plugins/github-copilot-modernization/skills/list-plans ~/.agents/skills/list-plans # Codex, Cursor, Gemini CLI, Copilot, OpenCode