add-sample

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty).

---

Overview

You are executing the Add Sample Skill. This skill creates a SamplesApp sample page with correct XAML, code-behind, and attribute setup. Files dropped under src/SamplesApp/SamplesApp.Samples/ are auto-discovered by glob — no manual project registration is required.

---

Execution Workflow

Phase 0: Determine Location & Names

1. Parse user input for:

   • Control name: The control being demonstrated (e.g., Button, TreeView, NavigationView)
   • Scenario: What the sample demonstrates (e.g., BasicUsage, CustomStyle, DataBinding)

2. Find existing folder under src/SamplesApp/SamplesApp.Samples/ matching the control's namespace:

   • WinUI controls: Microsoft_UI_Xaml_Controls/ (e.g., Microsoft_UI_Xaml_Controls/NavigationViewTests/)
   • XAML framework: Windows_UI_Xaml_Controls/ (e.g., Windows_UI_Xaml_Controls/Button/)
   • Shapes: Windows_UI_Xaml_Shapes/
   • Media: Windows_UI_Xaml_Media/
   • Search for existing samples of the same control to find the right folder

3. Generate file names: ControlName_Scenario.xaml and ControlName_Scenario.xaml.cs

   • Follow the naming convention of nearby existing samples
   • Use PascalCase with underscores separating control from scenario

Phase 1: Create XAML Page

Create the XAML file with:

• Standard Page root element
• Correct namespace declarations for the control
• {ThemeResource ApplicationPageBackgroundThemeBrush} for Background (NOT hardcoded colors — supports light/dark theme)
• The control being demonstrated with meaningful property settings
• Follow patterns from nearby existing samples in the same folder

Template:

<Page x:Class="UITests.FolderNamespace.ControlName_Scenario"
      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
      xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
      xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
      mc:Ignorable="d"
      Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">

    <StackPanel Spacing="8" Padding="16">
        <!-- Sample content here -->
    </StackPanel>
</Page>