list-plans Skill

Source

• Creator: microsoft
• Repository: microsoft/github-copilot-modernization
• Skill file: plugins/github-copilot-modernization/skills/list-plans/SKILL.md

What it does

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 prompts the user when a choice is needed.

Skill instructions

List and Select Plan Step 1 — Discover valid plans You MUST run this in a terminal — do NOT use file tools (listdir, filesearch, grepsearch) to discover plans. Detect the OS and run the matching script in the terminal. Replace <workspace-root with the absolute path to the workspace root before running. Windows (PowerShell) — run in terminal: powershell Set-Location "<workspace-root" $modernizeDir = ".github/modernize" $plans = @() if (Test-Path $modernizeDir) { Get-ChildItem -Path $modernizeDir -Directory | ForEach-Object { $hasPlan = Test-Path (Join-Path $.FullName "plan.md") $hasTasks = (Test-Path (Join-Path $.FullName "tasks.json")) -or (Test-Path (Join-Path $.FullName ".metadata/tasks.json")) if ($hasPlan -and $hasTasks) { $plans += @{ folder = $.Name; planPath = "$modernizeDir/$($.Name)/plan.md" } } } } $plans | ConvertTo-Json -Depth 2 macOS / Linux (bash) — run in terminal: bash cd "<workspace-root" modernizedir=".github/modernize" entries="[]" if [ -d "$modernizedir" ]; then for