dotnet/maui/agentic-labeler

Claude Code and agent skill by dotnet/maui

Trust tier 3
  • community
Source check pending

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-labeler

SKILL.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:

  1. 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.
  2. 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/tizen is 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 by dotnet-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-* or platform/* 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_label MCP tool (provided by the labels toolset). Note the singular name β€” it is list_label, not list_labels.
  • Important pagination caveat: the list_label tool only returns the first ~100 labels (no pagination). This repo has ~440 labels, so many area-* and platform/* labels will be missing from the listing. If you have a strong candidate area-* or platform/* label name in mind that isn't in the listing, verify it exists with the get_label tool 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 the area-controls-<name> prefix β€” never invent shorter aliases (e.g., the Maps area is area-controls-map, not area-maps).
  • Layout, measure/arrange, sizing issues β†’ area-layout.
  • Navigation, Shell routing, page navigation β†’ area-navigation (or area-controls-shell when 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 over area-tooling, which is for the dev-build/MSBuild/workload surface that ships to users).
  • AI-agent vs infrastructure tie-break: choose area-ai-agents when 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. Choose area-infrastructure when 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 product area-*). 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 product area-* label and omit area-infrastructure.

Tie-breaking when multiple areas could apply β€” pick the single most specific:

  • Specific control beats generic area. area-controls-tabbedpage over area-navigation; area-controls-collectionview over area-layout; area-controls-shell over area-navigation.
  • Sub-area beats parent area. area-safearea over area-layout; area-core-dispatching over area-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/*.cs without a platform suffix, or src/Controls/src/Core/), do not apply any platform/* label.
  • If a PR touches multiple platforms, apply each matching platform/* label.
  • .ios.cs files compile for both iOS and MacCatalyst (see split table rows above).
  • .maccatalyst.cs files do not compile for iOS β€” apply only platform/macos for those.
  • Tizen is excluded. *.tizen.cs files and /Platform/Tizen/ or /Platforms/Tizen/ paths exist in the source tree, but platform/tizen is never auto-applied. Treat Tizen files as if they had no platform suffix for labeling purposes: pick an area-* label normally based on the code's subject matter (e.g., TabbedPage.tizen.cs β†’ area-controls-tabbedpage) and apply no platform/* label for the Tizen content. Only noop if the global noop rules below (e.g., no area-* 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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/dotnet/maui/agentic-labeler/badge)](https://verified-skill.com/skills/dotnet/maui/agentic-labeler)

Something wrong with this skill or its page? Tell us.