# Avalonia Control Skill Generator

> Repository-local meta-skill for generating a control reference page inside an existing skill under an Avalonia control library plugin. Does not produce a standalone skill.

- Skill: `irihitech/avalonia-control-skill-generator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add irihitech/avalonia-control-skill-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/irihitech/avalonia-control-skill-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: irihitech (https://skillmd.com/u/irihitech)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/irihitech/avalonia-control-skill-generator

---


# Avalonia Control Skill Generator

Use this skill when asked to create a reference for a specific Avalonia control
inside an existing skill of a control library plugin.

## Workflow

1. Ask the user:
   - **Library name** (e.g. `irihi-avalonia`) — determines the plugin directory.
   - **Parent skill** (e.g. `controls`) — the existing skill this reference
     belongs to.
   - **Control name** (kebab-case, e.g. `color-picker`).
   - **One-line description** of what the control does.
2. Create the reference at:
   `plugins/<library-name>/skills/<parent-skill>/references/<control-name>.md`
3. Populate using the template below.

## Template

All generated references must include a **YAML front matter** header followed by
**dual-language** content (English + Simplified Chinese). Every section heading
is bilingual. Descriptive text is provided in both languages. Code snippets are
language-agnostic.

```markdown
---
category: Components
title: <ControlName>
subtitle: <控件名>
description: <One-line description in Simplified Chinese.>
---

## <ControlName> / <控件名>

## When to Use / 何时使用

<English: one paragraph describing when this control is appropriate.>

<中文：一段描述该控件适用场景的文字。This is the most important section —
agents use it to decide whether to load the reference.>

## Basic Usage / 基本使用

<Simplest XAML + C# snippet — equivalent to the "基本使用" demo.>

## Common Scenarios / 常用场景

<2-4 representative scenarios with XAML/C# snippets, analogous to the sample's
demo sections (e.g. sizing, data binding, event handling). Each scenario gets a
bilingual heading and code block.>

## Property Reference / 属性参考

<Key properties and events table. Not an exhaustive API dump; focus on the
properties agents most often need when generating or reviewing Avalonia code.

| Property / 属性 | Type / 类型 | Description / 说明 |
| --- | --- | --- |
| ... | ... | ... |

Optionally include a version/备注 column.>

## Styling & Templating / 样式与模板

<How to style the control, relevant style keys, ControlTheme structure, and
Template Parts — mapping from the sample's "Semantic DOM" section.
Dual-language description.>

## FAQ / 常见问题

<1-3 known pitfalls or frequently asked questions. Each Q&A pair in both
languages.>
```

## Rules

- Output must begin with a **YAML front matter** header containing `category`,
  `title`, `subtitle`, and `description` fields. This is required — not optional.
- Path: `plugins/<library-name>/skills/<parent-skill>/references/<control-name>.md`.
- **Dual-language**: every heading and descriptive paragraph in both English and
  Simplified Chinese. Code blocks are language-neutral.
- **When to Use / 何时使用** is the most critical section — it must be clear
  and specific so agents can decide when to load this reference.
- Derive code snippets from the official Avalonia documentation and IRIHI Tech
  conventions.
- Keep the property table focused on what an agent actually needs — not a
  copy-paste of the full API reference.
- After writing, read back the file to confirm correctness.