plugins/github-copilot-modernization/skills/project-recon/SKILL.md
Zero-dependency shell recon for any code repository — detect languages, count LOC, and report project scale. Pure POSIX find/wc or PowerShell, no Python or third-party tools required. Triggers: "how big is this project", "what languages", "project sizing", "repo recon", "LOC count", "scope check".
npx skillsauth add microsoft/github-copilot-modernization project-reconInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Quickly answers: how big is this repo and what's in it. Shell-only (POSIX find + wc or PowerShell), runs anywhere, no install needed.
Emit exactly this JSON structure — no additional fields:
{
"total_loc": <int>,
"languages": { "<lang>": <loc>, ... },
"top_level_dirs": <int>,
"primary_language": "<lang with highest LOC>",
"git": <bool>
}
total_loc: sum of non-blank lines across all detected source fileslanguages: per-language LOC breakdown (only languages actually found)top_level_dirs: count of immediate subdirectories under repo root (excluding hidden dirs)primary_language: the language key with the highest LOCgit: whether the project root is a git repository (git rev-parse --git-dir succeeds)Do NOT add fields beyond this schema. No descriptions, no module lists, no domain analysis.
| File | Purpose |
|------|---------|
| references/language-extensions.yaml | Language → file extension mapping + generated-file suffixes to skip |
| references/exclude-patterns.yaml | Directory exclude rules (global + per-language) |
| references/loc-shell.md | bash + PowerShell counting templates |
language-extensions.yaml for the canonical extension list.exclude-patterns.yaml::global.dirs with per_language.<lang>.dirs for each detected language.references/loc-shell.md. Run once per detected language, sum for total.wc -l), comment-inclusive. This is intentional — speed and simplicity over precision.development
Evaluates whether a user's modernization/rewrite request provides enough scenario context to proceed (e.g., target component library, screenshots, design system for frontend; API contract policy, data migration strategy for backend). Produces a deterministic clarity score, asks the user for missing required fields via a structured form, and writes a canonical `clarification.md` artifact consumed by all downstream agents. Triggers: "clarification gate", "scenario clarification", "elicit missing context", "evaluate prompt completeness", "ask user for screenshots / target library / design system". NOT for: feature specification (use feature-inventory), planning (use creating-implementation-plan), implementation (use implementing-code), or resolving spec-time `[NEEDS CLARIFICATION]` markers (those remain owned by feature-inventory).
tools
Lifecycle hooks for the modernize-rearchitecture coordinator. Defines hook points, registered actions, and execution rules.
development
Provides role charters (mission, ownership, core principles, quality bar) for a multi-agent coding team. Each charter defines the role's mission, ownership scope, core principle (boundary constraints), and quality bar. Most roles also include communication rules. Consumed by the coordinator during task decomposition to assign work to the correct role. Triggers: "look up role charter", "what does the architect own", "check role boundaries", "find team roles", "which role handles X", "list agent charters", "role responsibilities". NOT for: task decomposition (use breaking-down-tasks), implementation (use implementing-code), architecture analysis (use analyzing-architecture).
data-ai
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. Triggers: "list plans", "find plans", "select plan", "list-and-select-plan", "discover plans".