dotnet/maui/agentic-labeler
Claude Code and agent skill by dotnet/maui
- community
Checking that the SKILL.md file is still in the repository.
Labels issues and pull requests in the dotnet/maui repository with `area-*` and `platform/*` labels ONLY, based on technical content and platform-file conventions. Used by the gh-aw agentic-labeler workflow and available for batch evaluation and interactive Copilot CLI usage.
Install
npx vskill@latest install dotnet/maui/agentic-labelerSKILL.md
The same SKILL.md was published earlier as dotnet/maui/agentic-labeler.
Agentic Labeler
Labeling rules for the dotnet/maui repository. These rules are the canonical source of truth for how issues and PRs should be labeled. They are consumed by the agentic-labeler gh-aw workflow and can also be used standalone for batch evaluation or interactive labeling.
π¨ Scope: area-* and platform/* ONLY
The labeler applies only two label families, and nothing else:
- Exactly one `area-*` β derived from the subject matter (control name, area like layout / navigation / xaml / infrastructure / etc.). Choose the single most specific match for the dominant subsystem; see the tie-breaking rules below.
- One or more `platform/*` β derived from changed-file platform conventions on PRs, or from explicit platform mentions on issues. Apply all that fit. Exception:
platform/tizenis never applied by this labeler under any circumstance, even when Tizen files are touched or Tizen is named in an issue (see the platform-label rules below).
The labeler must NOT apply any other label, ever. Specifically, do not apply:
t/*(kind:t/bug,t/enhancement βοΈ,t/docs π,t/breaking π₯,t/native-embedding,t/desktop,t/a11y, etc.) β the issue/PR author or other automation owns these.i/*(indicators:i/regression, etc.) β set during triage based on investigation, not initial content.s/*(status:s/needs-info,s/needs-repro,s/needs-verification,s/needs-attention,s/triaged,s/verified,s/no-repro,s/not-a-bug,s/duplicate 2οΈβ£,s/pr-needs-author-input, etc.) β managed bydotnet-policy-service[bot]and human triagers.p/*(priority:p/0,p/1,p/2,p/3) β set by maintainers.partner/*(e.g.,partner/syncfusion) β set by partner-tracking automation.perf/*(e.g.,perf/memory-leak π¦) β set during perf investigation.backport/*,regressed-in-*,version/*β set during triage / release management.untriaged,:watch: Not Triagedβ applied by repo automation on issue open.- Anything else that is not literally an
area-*orplatform/*label.
If the only labels that clearly apply are not area-* or platform/*, noop instead β see the noop section below.
If neither an area-* nor a platform/* label clearly applies, noop.
Label discovery
- Fetch the current list of labels using the
list_labelMCP tool (provided by thelabelstoolset). Note the singular name β it islist_label, notlist_labels. - Important pagination caveat: the
list_labeltool only returns the first ~100 labels (no pagination). This repo has ~440 labels, so manyarea-*andplatform/*labels will be missing from the listing. If you have a strong candidatearea-*orplatform/*label name in mind that isn't in the listing, verify it exists with theget_labeltool before adding it. - Do not create new labels β only labels that already exist in the repository will be accepted.
Labeling rules
area-* label (issues and PRs) β exactly one
Apply exactly one `area-*` label. Pick the single most specific match for the dominant subsystem:
- Specific control mentioned β matching
area-controls-<name>(e.g.,CollectionViewβarea-controls-collectionview,Entryβarea-controls-entry,Map/Mapsβarea-controls-map,Windowβarea-controls-window,WebViewβarea-controls-webview,HybridWebViewβarea-controls-hybridwebview). Always use thearea-controls-<name>prefix β never invent shorter aliases (e.g., the Maps area isarea-controls-map, notarea-maps). - Layout, measure/arrange, sizing issues β
area-layout. - Navigation, Shell routing, page navigation β
area-navigation(orarea-controls-shellwhen Shell-specific). - XAML parsing, markup extensions, XamlC, source generators β
area-xaml. - Installation, workload availability, target-framework recognition, requirements, and platform support β
area-setup. - Hot reload, debugging, editor experiences, build tasks, and MSBuild/tooling behavior β
area-tooling. - Project templates β
area-templates. - BlazorWebView / Blazor hybrid β
area-blazor. - Essentials APIs (non-UI: connectivity, sensors, preferences, etc.) β
area-essentials. - Drawing / Microsoft.Maui.Graphics β
area-drawing. - Gestures (tap, pan, swipe, pinch) β
area-gestures. - Lifecycle, hosting, app startup, DI β
area-core-lifecycle/area-core-hosting. - Dispatcher / main thread / threading β
area-core-dispatching. - Localization / RTL / culture β
area-localization. - Docs only β
area-docs. - Copilot CLI agents, agent skills, agentic workflows, and AI-assisted development β
area-ai-agents. This covers.github/agents/**,.github/skills/**, gh-aw workflow sources and generated locks, and supporting review/test/fix orchestration when the AI-agent behavior is the primary subject. - CI, build pipelines, Maestro / dependency flow, branch mirroring, and generic GitHub Actions infrastructure β
area-infrastructure. This covers: [dnceng-bot]codeflow/branch-mirroring issues (the standard "Branchβ¦can't be mirrored to Azdo" issues) βarea-infrastructure(do not noop these β they have a clear area).- PRs touching only generic
.github/workflows/*.yml,.github/scripts/,eng/pipelines/,eng/common/, or other CI infrastructure files βarea-infrastructure(prefer this overarea-tooling, which is for the dev-build/MSBuild/workload surface that ships to users). - AI-agent vs infrastructure tie-break: choose
area-ai-agentswhen the change primarily alters an agent's behavior, prompt, skill, evaluation, or AI-assisted developer workflow. Command parsing and trigger/dispatch behavior for AI-assisted review count as agent behavior. Choosearea-infrastructurewhen the change primarily alters generic CI execution, authentication, scheduling, or pipeline plumbing without changing the AI-assisted workflow's behavior, even if an agent consumes that infrastructure. - Mixed PRs (infra-primary + small product edits): if the PR is dominated by CI infrastructure changes but also has incidental edits to product code, still apply
area-infrastructure(and omit any productarea-*). If the product-code change is the focus and the infra change is incidental (e.g., a small workflow tweak that supports a feature), prefer the productarea-*label and omitarea-infrastructure.
Tie-breaking when multiple areas could apply β pick the single most specific:
- Specific control beats generic area.
area-controls-tabbedpageoverarea-navigation;area-controls-collectionviewoverarea-layout;area-controls-shelloverarea-navigation. - Sub-area beats parent area.
area-safeareaoverarea-layout;area-core-dispatchingoverarea-core-lifecycle. - Subject-matter focus beats incidental touch. If a PR fixes a CollectionView bug by adjusting layout code, the area is the control (
area-controls-collectionview), not the layout system. - When genuinely tied, prefer the area that names the user-visible feature over the implementation-detail area.
If after applying these heuristics there is still no single best fit, noop rather than apply two area labels.
platform/* labels
This is the most important behavior for PRs.
For pull requests, infer platform/* labels primarily from the changed files, using the rules below. Each rule maps a file pattern to one or more platform labels. Apply a platform/* label if any changed file matches that pattern. The path patterns intentionally target the established MAUI source-layout conventions β match the patterns in the table below (e.g., /Platform/<Name>/, /Platforms/<Name>/, /Handlers/*/<Name>/). Do not match on a bare top-level /Android/, /iOS/, /Windows/, or /MacCatalyst/ segment that is not part of one of the patterns in the table β bare segments occur in templates, docs, and unrelated tooling paths and are not platform-specific source code.
Note on iOS / MacCatalyst: file-extension patterns and directory patterns map differently because of MAUI's compilation conventions β they are split into separate rows below.
| File pattern (changed in the PR) | Label(s) to apply | |
|---|---|---|
*.android.cs, *.Android.cs, paths containing /Platform/Android/, /Platforms/Android/, /AndroidNative/, or handler subdirectories like /Handlers/*/Android/ | platform/android | |
*.ios.cs, *.iOS.cs (file-extension pattern β these compile for both iOS and MacCatalyst) | platform/ios and platform/macos | |
Paths containing /Platform/iOS/, /Platforms/iOS/, or handler subdirectories like /Handlers/*/iOS/ (directory pattern β these compile only for the iOS TFM) | platform/ios only | |
*.maccatalyst.cs, *.MacCatalyst.cs, paths containing /Platform/MacCatalyst/, /Platforms/MacCatalyst/, or handler subdirectories like /Handlers/*/MacCatalyst/ | platform/macos | |
*.windows.cs, *.Windows.cs, paths containing /Platform/Windows/, /Platforms/Windows/, or handler subdirectories like /Handlers/*/Windows/ | platform/windows |
Notes:
- If a PR touches only shared / cross-platform code (e.g.,
src/Core/src/*.cswithout a platform suffix, orsrc/Controls/src/Core/), do not apply anyplatform/*label. - If a PR touches multiple platforms, apply each matching
platform/*label. .ios.csfiles compile for both iOS and MacCatalyst (see split table rows above)..maccatalyst.csfiles do not compile for iOS β apply onlyplatform/macosfor those.- Tizen is excluded.
*.tizen.csfiles and/Platform/Tizen/or/Platforms/Tizen/paths exist in the source tree, butplatform/tizenis never auto-applied. Treat Tizen files as if they had no platform suffix for labeling purposes: pick anarea-*label normally based on the code's subject matter (e.g.,TabbedPage.tizen.csβarea-controls-tabbedpage) and apply noplatform/*label for the Tizen content. Only noop if the global noop rules below (e.g., noarea-*clearly fits) apply on their own merits.
For issues, infer platform/* labels only for platforms the reporter explicitly identifies as affected: Android, iOS, macOS / Mac Catalyst, or Windows. This includes the issue-template's "Affected platforms" field, plus clear evidence in the title, body, or attached logs/stack traces. Do not guess.
- If the reporter explicitly lists named affected platforms, apply one
platform/*label per named platform β even when the list covers every supported platform (e.g., "iOS, Android, Windows, macOS" β apply all four). - Generic phrases like "all platforms", "every platform", "any platform", or "cross-platform" do not by themselves justify any
platform/*label. If a generic phrase is accompanied by an explicit affected-platform list, the named list wins β apply each named platform's label (e.g., "all platforms (iOS, Android, Windows, macOS)" β apply all four). - Do not apply labels for platforms mentioned incidentally ("tested on iOS"), as "not reproduced" / "not affected", or as label requests ("please add platform/android").
- Never apply `platform/tizen` β even when the reporter names Tizen, includes Tizen in an "Affected platforms" enumeration, or attaches Tizen logs. Tizen mentions are silently dropped from the platform set.
When to noop (no labels)
Some items should not be labeled. If any of the following apply, skip labeling entirely:
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryChecking.github/skills/agentic-labeler/SKILL.md
Popularity
- Repository stars
- 23,322
- Repository forks
- 1,985
- 7-day trend score
- 50
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/dotnet/maui/agentic-labeler)