SKILL.md
.NET MAUI — Performance Optimization Skill
Purpose
This skill provides agents with best practices, patterns, and diagnostics for improving performance in .NET MAUI applications. It covers startup time, layout efficiency, memory usage, rendering performance, compiled bindings, AOT, image optimization, and responsiveness across platforms.
The goal is to ensure that all generated MAUI code is fast, efficient, and production-ready.
Core Principles
- Minimize layout complexity
Avoid deep nesting and prefer efficient containers like Grid.
- Use compiled bindings
Reduce reflection overhead and improve rendering speed.
- Optimize startup
Defer heavy work, preload only what’s necessary, and use AOT where appropriate.
- Reduce memory pressure
Dispose resources, unload pages, and avoid large in-memory objects.
- Optimize images
Use correct resolutions, caching, and vector assets when possible.
- Measure, don’t guess
Use profiling tools and performance diagnostics.
Key Optimization Areas
- Startup time
- XAML rendering
- Navigation performance
- Memory usage
- Image loading
- Threading and async patterns
- AOT compilation
- Resource cleanup
Agent Usage Guidelines
- When generating XAML, apply compiled bindings and avoid unnecessary nesting.
- When generating services, ensure async methods are properly awaited.
- When asked to “improve performance,” apply rules from this skill before others.
- When generating image-heavy UI, use caching and correct image formats.
- When generating navigation code, avoid creating multiple page instances unnecessarily.
Out of Scope
- UI design (covered in
maui-ui-best-practices) - Authentication (covered in
maui-authentication) - Database performance (covered in
maui-data-storage)