React Native Best Practices
vercel-labs/openreview
A prioritized rule set for React Native and Expo apps covering list performance, animation, navigation, UI patterns, state, rendering, monorepos and configuration.
Guide for creating custom .NET MAUI handlers, customizing existing handlers with property mappers, and implementing platform-specific native views.
Install Maui Custom Handlers
$ npx skills add davidortinau/maui-skills --skill maui-custom-handlers -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install davidortinau/maui-skills maui-custom-handlers --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/maui-skills/skills/maui-custom-handlers .claude/skills/maui-custom-handlers && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "maui-custom-handlers" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-custom-handlers into .claude/skills/maui-custom-handlers/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-custom-handlers", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-custom-handlersType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add davidortinau/maui-skills --skill maui-custom-handlers -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install davidortinau/maui-skills maui-custom-handlers --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/maui-skills/skills/maui-custom-handlers .agents/skills/maui-custom-handlers && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "maui-custom-handlers" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-custom-handlers into .agents/skills/maui-custom-handlers/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-custom-handlers", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davidortinau/maui-skills --skill maui-custom-handlers -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install davidortinau/maui-skills maui-custom-handlers --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/maui-skills/skills/maui-custom-handlers .cursor/skills/maui-custom-handlers && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "maui-custom-handlers" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-custom-handlers into .cursor/skills/maui-custom-handlers/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-custom-handlers", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/davidortinau/maui-skills.git --path plugins/maui-skills/skills/maui-custom-handlers--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add davidortinau/maui-skills --skill maui-custom-handlers -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install davidortinau/maui-skills maui-custom-handlers --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/maui-skills/skills/maui-custom-handlers .gemini/skills/maui-custom-handlers && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "maui-custom-handlers" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-custom-handlers into .gemini/skills/maui-custom-handlers/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-custom-handlers", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install davidortinau/maui-skills maui-custom-handlersInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add davidortinau/maui-skills --skill maui-custom-handlers -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/maui-skills/skills/maui-custom-handlers .github/skills/maui-custom-handlers && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "maui-custom-handlers" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-custom-handlers into .github/skills/maui-custom-handlers/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-custom-handlers", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davidortinau/maui-skills --skill maui-custom-handlers -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install davidortinau/maui-skills maui-custom-handlers --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidortinau/maui-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/maui-skills/skills/maui-custom-handlers .opencode/skills/maui-custom-handlers && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "maui-custom-handlers" agent skill from https://github.com/davidortinau/maui-skills/tree/main/plugins/maui-skills/skills/maui-custom-handlers into .opencode/skills/maui-custom-handlers/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "maui-custom-handlers", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
maui-custom-handlers- GitHub stars
- 175
- Token cost
- ~1.3k tokens
- SKILL.md length
- 376 words
- Files
- 2 (incl. references)
- Skills in repo
- 41
- Repo updated
- First seen
- Licence
- MIT
At a glance
Guide for creating custom .NET MAUI handlers, customizing existing handlers with property mappers, and implementing platform-specific native views.
- : custom handler
- SKILL.md covers Decision: Customize Existing…, Gotchas & Common Mistakes, Mapper Method Selection and PropertyMapper vs. CommandMapper, plus 1 more section
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- AppendToMapping
What it does
Maui Custom Handlers is an agent skill from davidortinau/maui-skills. Guide for creating custom .NET MAUI handlers, customizing existing handlers with property mappers, and implementing platform-specific native views. Covers PrependToMapping/ModifyMapping/AppendToMapping, PropertyMapper, CommandMapper, partial handler classes, and handler registration. USE FOR: "custom handler", "PropertyMapper", "AppendToMapping", "PrependToMapping", "ModifyMapping", "CommandMapper", "platform-specific rendering", "native view", "handler registration", "custom control renderer". DO NOT USE FOR…
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/custom-handlers-api.md`).
It sits in Mobile, covering Cross-platform mobile apps. The repository describes itself as: .NET MAUI skills for GitHub Copilot and Claude Code. The licence is MIT.
When your agent uses it
- : custom handler
- AppendToMapping
- PrependToMapping
- Platform-specific rendering
Example prompts
- “custom handler”
- “PropertyMapper”
- “AppendToMapping”
- “/maui-custom-handlers”
What it can do on your machine
Read from SKILL.md and the folder at commit 79bb4bf. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are csharp).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Maui Custom Handlers loads about 1.3k tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 172 tokens; SKILL.md has 376 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from davidortinau/maui-skills at commit 79bb4bf, republished under its MIT licence (© davidortinau). 376 words, ~1,252 tokens.
Download SKILL.mdSave it as
.claude/skills/maui-custom-handlers/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- maui-custom-handlers
- description
- Guide for creating custom .NET MAUI handlers, customizing existing handlers with property mappers, and implementing platform-specific native views. Covers PrependToMapping/ModifyMapping/AppendToMapping, PropertyMapper, CommandMapper, partial handler classes, and handler registration. USE FOR: "custom handler", "PropertyMapper", "AppendToMapping", "PrependToMapping", "ModifyMapping", "CommandMapper", "platform-specific rendering", "native view", "handler registration", "custom control renderer". DO NOT USE FOR: platform API calls without custom controls (use maui-platform-invoke), data binding (use maui-data-binding), or gesture handling (use maui-gestures).
.NET MAUI Custom Handlers
Decision: Customize Existing vs. Create New
| Scenario | Approach |
|---|---|
| Change how a built-in control looks/behaves on one platform | Customize — use AppendToMapping / PrependToMapping |
| Need the change on only some instances of a control | Customize — subclass the control + type-check in mapper |
| Need a completely new cross-platform control with native backing | Create new handler with partial classes |
⚠️ Prefer
AppendToMappingoverModifyMapping.ModifyMappingreplaces the default mapper action entirely — if the framework adds behaviour in a future release, your override silently drops it.
Gotchas & Common Mistakes
Mapper customizations are global
Every instance of the control is affected. Guard with a subclass check for instance-specific behaviour:
// ❌ Removes borders from EVERY Entry in the app
EntryHandler.Mapper.AppendToMapping("NoBorder", (handler, view) =>
{
#if ANDROID
handler.PlatformView.Background = null;
#endif
});
// ✅ Only affects BorderlessEntry instances
EntryHandler.Mapper.AppendToMapping("NoBorder", (handler, view) =>
{
if (view is not BorderlessEntry) return;
#if ANDROID
handler.PlatformView.Background = null;
#endif
});Unsubscribe native events in HandlerChanging
Failing to remove native event handlers causes memory leaks because the native view may outlive the managed wrapper.
// ❌ Subscribes but never unsubscribes — leaks
entry.HandlerChanged += (s, e) =>
{
#if ANDROID
((Entry)s!).Handler!.PlatformView.As<Android.Widget.EditText>()!
.FocusChange += OnNativeFocusChange;
#endif
};
// ✅ Pair subscribe in HandlerChanged with unsubscribe in HandlerChanging
entry.HandlerChanged += OnHandlerChanged;
entry.HandlerChanging += OnHandlerChanging;Partial class name/namespace mismatch
Namespace and class name must match exactly across the shared handler file and every platform file. A mismatch silently creates separate classes — no compiler error, just a handler that does nothing on that platform.
Conditional using placement
The using PlatformView = ... aliases must be at the top of the shared
handler file (not the platform files) so the ViewHandler<TControl, TPlatformView>
base-class generic resolves correctly per platform.
// ✅ Top of Handlers/VideoPlayerHandler.cs
#if ANDROID
using PlatformView = Android.Widget.VideoView;
#elif IOS || MACCATALYST
using PlatformView = AVKit.AVPlayerViewController;
#elif WINDOWS
using PlatformView = Microsoft.UI.Xaml.Controls.MediaPlayerElement;
#endifMissing CreatePlatformView()
Each platform partial must override CreatePlatformView(). Omitting it
produces a compile error — but the error message points at the base class,
not your handler, making it confusing to debug.
Show full SKILL.md (149 more words)Show less
Mapper Method Selection
| Method | Risk | Use when |
|---|---|---|
AppendToMapping | Low — runs after default | Adding behaviour without breaking defaults |
PrependToMapping | Low — runs before default | Setting initial state that the default can override |
ModifyMapping | ⚠️ High — replaces default | You intentionally want to suppress the framework's mapper logic |
PropertyMapper vs. CommandMapper
| Mapper | Purpose | Pattern |
|---|---|---|
PropertyMapper | Sync a bindable property to the native view | Runs whenever the property value changes |
CommandMapper | Fire-and-forget action from control → handler | Runs once per invocation, no return value |
⚠️ Don't put property sync logic in
CommandMapper— it won't re-run when the property changes, leading to stale native views.
Checklist — New Handler
- Cross-platform control inherits
View(or appropriate base) - Shared handler file has conditional
using PlatformView = ...aliases - Handler inherits
ViewHandler<TControl, PlatformView> -
PropertyMappermaps every bindable property - Each platform partial overrides
CreatePlatformView() - Namespace + class name identical across all partial files
- Handler registered in
MauiProgram.csviaConfigureMauiHandlers - Native event subscriptions cleaned up in
HandlerChanging
© davidortinau, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file (references) in plugins/maui-skills/skills/maui-custom-handlers of davidortinau/maui-skills.
- SKILL.md
- references/custom-handlers-api.md
Open the folder on GitHubat commit 79bb4bf
Compare with similar skills
Maui Custom Handlers next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Maui Custom Handlers this skilldavidortinau/maui-skills | 175 | — | ~1.3k | Automated safety check: Pass | MIT | |
| React Native Best Practicesvercel-labs/openreview | 1.7k | 17 repos | ~1.1k | Automated safety check: Pass | MIT | |
| Compose Multiplatform Patternsmonta-app/ocpp-emulator | 180 | 5 repos | ~2k | Automated safety check: Pass | Apache-2.0 | |
| Creating Reanimated Animationsgluestack/gluestack-ui | 5.3k | — | ~2.4k | Automated safety check: Pass | None | |
| Uni-app Components and APIsfeige996/unibest | 2.3k | — | ~1.6k | Automated safety check: Pass | MIT | |
| Add Flutter Docusaurus Localematthiasn/lotti | 1.2k | — | ~1.2k | Automated safety check: Pass | GPL-3.0 |
Similar skills
- Official
Compose Multiplatform Patterns
monta-app/ocpp-emulator
Compose Multiplatform and Jetpack Compose patterns for KMP projects — state management, navigation, theming, performance, and platform-specific UI.
Creating Reanimated Animations
gluestack/gluestack-ui
Generate React Native Reanimated animation code for React Native apps.
Uni-app Components and APIs
feige996/unibest
Gives per-component and per-API examples, reference specs and compatibility notes for building cross-platform uni-app apps, mirroring the official documentation.
Add Flutter Docusaurus Locale
matthiasn/lotti
Add, complete, or audit a locale across a Flutter application's ARB catalogs and a localized Docusaurus manual, including generated localization code, locale selectors, native platform declarations…
Jetpack Compose Expert
aldefy/compose-skill
Guides Jetpack Compose and Compose Multiplatform work across Android, Desktop, iOS and web, plus Android TV, Material 3 motion, paging, navigation and design-to-code.
More from davidortinau/maui-skills
All 41 skills in this repoMaui Hot Reload Diagnostics
davidortinau/maui-skills
Diagnose and troubleshoot .NET MAUI Hot Reload issues (C Hot Reload, XAML Hot Reload, Blazor Hybrid).
Maui Accessibility
davidortinau/maui-skills
Guide for making .NET MAUI apps accessible — screen reader support via SemanticProperties, heading levels, AutomationProperties visibility control, programmatic focus and announcements, and…
Maui Animations
davidortinau/maui-skills
.NET MAUI view animations, custom animations, easing functions, rotation, scale, translation, and fade effects.
Maui App Icons Splash
davidortinau/maui-skills
.NET MAUI app icon configuration, splash screen setup, SVG to PNG conversion at build time, composed/adaptive icons, and platform-specific icon and splash screen requirements for Android, iOS, Mac…
Maui App Lifecycle
davidortinau/maui-skills
.NET MAUI app lifecycle guidance covering the four app states (not running, running, deactivated, stopped), cross-platform Window lifecycle events, backgrounding and resume behaviour…
Maui Aspire
davidortinau/maui-skills
Guide for .NET MAUI apps consuming .NET Aspire-hosted backend services.
Related
Categories
Questions about Maui Custom Handlers
What does Maui Custom Handlers do?
Guide for creating custom .NET MAUI handlers, customizing existing handlers with property mappers, and implementing platform-specific native views. Maui Custom Handlers is an agent skill from davidortinau/maui-skills.NET MAUI handlers, customizing existing handlers with property mappers, and implementing platform-specific native views.
When should I use Maui Custom Handlers?
Maui Custom Handlers fits situations like: : custom handler; appendToMapping; prependToMapping; platform-specific rendering.
How do I install Maui Custom Handlers in Claude Code?
Run `npx skills add davidortinau/maui-skills --skill maui-custom-handlers -a claude-code`. Or copy the skill folder (plugins/maui-skills/skills/maui-custom-handlers in davidortinau/maui-skills) into .claude/skills/maui-custom-handlers in your project. Claude Code loads it when a task matches its description.
How do I install Maui Custom Handlers in Codex?
Run `npx skills add davidortinau/maui-skills --skill maui-custom-handlers -a codex`. Or copy the skill folder (plugins/maui-skills/skills/maui-custom-handlers in davidortinau/maui-skills) into .agents/skills/maui-custom-handlers in your project. Codex loads it when a task matches its description.
Can I use Maui Custom Handlers in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davidortinau/maui-skills --skill maui-custom-handlers -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/maui-custom-handlers, .gemini/skills/maui-custom-handlers, .github/skills/maui-custom-handlers and .opencode/skills/maui-custom-handlers in your project.
What does Maui Custom Handlers need to run?
SKILL.md names no scripts, command-line tools or credentials: Maui Custom Handlers is instructions for the agent only.
Does Maui Custom Handlers access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Maui Custom Handlers safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Maui Custom Handlers use?
Maui Custom Handlers is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Maui Custom Handlers use?
About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.
What are the alternatives to Maui Custom Handlers?
Skills that share tags, products or a category with Maui Custom Handlers: React Native Best Practices (vercel-labs/openreview, 1.7k stars), Compose Multiplatform Patterns (monta-app/ocpp-emulator, 180 stars), Creating Reanimated Animations (gluestack/gluestack-ui, 5.3k stars) and Uni-app Components and APIs (feige996/unibest, 2.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Maui Custom Handlers?
davidortinau (a GitHub user) maintains it in davidortinau/maui-skills, which has 175 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on July 6, 2026.
Source: davidortinau/maui-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.