maui-toolkit-ui-components-skills

Skills for Syncfusion® Toolkit for .NET MAUI components, designed for use with AI coding assistants.

This repository contains 35 AI-ready skill guides for working with Syncfusion® Toolkit for .NET MAUI controls. Each skill includes a SKILL.md file that AI coding assistants can read automatically, plus a references/ subfolder with detailed documentation covering setup, usage patterns, customization, and troubleshooting.

Quick Start

Option 1: Using npx (Recommended)

npx skills add https://github.com/syncfusion/maui-toolkit-ui-components-skills

This will automatically add the skills to your workspace.

Option 2: Manual Installation

1. Clone this repository

git clone https://github.com/syncfusion/maui-toolkit-ui-components-skills.git

2. Add it to your VS Code workspace

Open your .code-workspace file (or create one) and add this repo as a second root folder:

{
  "folders": [
    { "path": "/path/to/your-maui-app" },
    { "path": "/path/to/maui-toolkit-ui-components-skills" }
  ]
}

3. Start asking questions

Your AI assistant will automatically detect and apply the relevant skill based on your prompt:

How do I allow users to pick dates or highlight important days?
How do I present information in a clean, modern card layout?
How do I apply a dark theme to Syncfusion controls?

No configuration required. Skills are loaded automatically from the workspace.

---

Prerequisites

• An AI coding assistant that supports skills/context files (e.g., GitHub Copilot, Cursor, or similar tools)
• .NET 9 SDK

How These Skills Work

Each SKILL.md file contains a description field in its YAML frontmatter. AI coding assistants read this description to decide when to automatically apply a skill during a conversation. When you ask about a specific Syncfusion control — for example, "How do I add items to my SegmentedControl?" — the AI assistant detects the match and loads the corresponding skill to guide its response.

You can also reference a skill explicitly by mentioning the component or control by name in your prompt.

Example Prompts

How do I bind data to the Syncfusion SegmentedControl in .NET MAUI?

→ The AI assistant loads the SegmentedControl skill and uses its get-started and data-binding reference docs.

Help me migrate my Xamarin.Forms app to .NET MAUI.

→ The AI assistant loads the Migration skill.

Using Reference Files

Each references/ subfolder contains deeper implementation guides. When the AI assistant loads a skill, it can also pull in these files when you ask follow-up questions:

Show me how to use auto-scroll, programmatic scrolling, and proper layout in .NET MAUI Accordion?.

→ The AI assistant uses references/advanced-features.md from the Accordion skill for the detailed answer.

Skill File Structure

Every skill folder follows this layout:

skills/
└── syncfusion-maui-toolkit-<control>/
    ├── SKILL.md                  ← Loaded by AI assistant; contains When to Use, Component Overview, and navigation links
    └── references/
        ├── getting-started.md    ← Installation, setup, NuGet packages, MauiProgram.cs
        ├── advanced-features.md  ← In-depth feature guides and code samples
        └── ...                   ← Additional reference files per control

SKILL.md sections:

• When to Use This Skill — trigger phrases and scenarios that activate this skill
• Component Overview — NuGet package, namespace, key capabilities at a glance
• Documentation and Navigation Guide — links to all reference files in the skill

Repository Structure

README.md
skills/
    syncfusion-maui-toolkit-getting-started/
    syncfusion-maui-toolkit-migration/
    syncfusion-maui-toolkit-theming/
    syncfusion-maui-toolkit-accordion/
    syncfusion-maui-toolkit-shimmer/
    ... (one folder per control, 32 total)

Skill Index

Tip: Start with Getting Started if you are setting up a new project, and Migration if upgrading from Syncfusion® .NET MAUI. For all other tasks, find the skill that matches the specific control below.

Foundation

• Getting Started — installation, themes
• Migration — Syncfusion® .NET MAUI to Syncfusion® Toolkit for .NET MAUI migration guide
• Theming — Material themes, dark mode, custom styling

Data Visualization

• Cartesian Charts
• Circular Charts
• Funnel Charts
• Polar Charts
• Pyramid Charts
• Spark Charts
• Sunburst Charts

Calendars

• Calendar

Editors

• Date Picker
• Date Time Picker
• Numeric Entry
• Numeric Up Down
• OTP Input
• Picker
• Time Picker

Navigation

• Bottom Sheet
• Navigation Drawer
• Tab View

Layout

• Accordion
• Cards
• Carousel
• Expander
• Popup
• Text Input Layout
• Grid Splitter

Buttons

• Button
• Chips
• Segmented Control

Notification

• Circular Progress Bar
• Linear Progress Bar
• Pull to Refresh

Miscellaneous

• Effects View
• Shimmer