diff --git a/skills/README.md b/skills/README.md
new file mode 100644
index 00000000..c610c7ee
--- /dev/null
+++ b/skills/README.md
@@ -0,0 +1,58 @@
+# HandyControl WPF 控件 Skills
+
+参照 [Syncfusion WPF skills](https://github.com/syncfusion/wpf-ui-components-skills/tree/master/skills) 的“每控件一个 Skill + 按需 references”组织方式，为当前 HandyControl WPF 实现编写。内容从本仓库源码、样式和中文文档生成，不包含 Syncfusion 的实现文档或 API。
+
+共 82 个 Skill：79 个已文档化的扩展控件主题，以及接入入口、主题、原生控件样式。一个主题可能包含多个类型，例如 grid 对应 Row/Col，loading 对应 LoadingLine/LoadingCircle。范围为 `doc/source/handycontrol/extend_controls/*/index.md`；未文档化类型可通过入口 Skill 按源码查找，不代表已单独提供 Skill。Avalonia 不在此集合内。
+
+## 安装与使用
+
+需要 Python 3.9 或更新版本，无第三方依赖。在仓库根目录执行：
+
+```powershell
+# 仅安装接入入口（默认安装到 CODEX_HOME/skills 或 ~/.codex/skills）
+python skills/scripts/install_skills.py
+
+# 按需安装控件；每个控件 Skill 自带接入说明与 API 导航，可独立使用
+python skills/scripts/install_skills.py handycontrol-wpf-numeric-up-down handycontrol-wpf-dialog handycontrol-wpf-growl
+
+# 查看名称 / 安装全部 / 更新已安装文件
+python skills/scripts/install_skills.py --list
+python skills/scripts/install_skills.py --all
+python skills/scripts/install_skills.py --all --force
+
+# 项目内安装（Codex 可发现的项目技能目录）；其他支持 SKILL.md 的工具也可指定目录
+python skills/scripts/install_skills.py --all --dest .agents/skills
+```
+
+默认不会覆盖已有同名目录；`--force` 更新文件但不删除额外文件。安装器先检查全部名称与目标目录，再复制；不修改业务工程、NuGet 引用或 AGENTS.md。不要把 skills/scripts 或 templates 当作独立 Skill 安装。
+
+安装后在新会话中使用，例如：
+
+```text
+使用 $handycontrol-wpf，在当前 WPF 工程接入 HandyControl。
+使用 $handycontrol-wpf-numeric-up-down，实现数量输入，范围 1–999，双向绑定到 Quantity。
+使用 $handycontrol-wpf-dialog，实现带关闭按钮的页面内对话框。
+使用 $handycontrol-wpf-native-styles，为现有原生 Button、TextBox 应用 HandyControl 样式。
+使用 $handycontrol-wpf-theming，为现有应用添加深色皮肤。
+```
+
+## 文件与维护
+
+- `handycontrol-wpf/SKILL.md`：统一入口，提供接入流程、排错及控件选择。
+- `handycontrol-wpf/references/controls.md`：完整控件索引。
+- `handycontrol-wpf-*/SKILL.md`：独立控件的使用约束、最小示例（适用时）。
+- `references/api.md`：公共声明和本库基类导航；仅声明摘录，不可当作完整代码编译。
+- `references/usage.md`：对应文档、样式和 Demo 源码位置。
+- `agents/openai.yaml`：Codex 展示信息和调用提示，保留默认自动发现行为。
+- `templates/`：维护接入、主题、原生样式手写内容的源文件。
+- `scripts/build_skills.py`：生成全部 Skill；特殊用法和精选示例在 NOTES / EXAMPLES 中维护。
+- `scripts/validate_skills.py`：检查生成一致性、元信息、引用、源码路径和 XML 语法。
+
+```powershell
+python skills/scripts/build_skills.py
+python skills/scripts/validate_skills.py
+```
+
+修改生成文件后应同步修改模板或生成器，再重新生成。`build_skills.py --check` 只检查，不写入。删除控件主题时，生成器会报告遗留 Skill，由维护者确认后手动移除，避免自动删除用户内容。
+
+API 摘录不含所有继承成员、访问器或条件编译分支。在线源码链接指向 master，使用旧 NuGet 包时需核对对应版本；优先以实际引用版本源码为准。XML 语法校验不等于 WPF 编译、资源解析或运行时验证。可继续使用“代码审查”检查使用这些 Skill 后生成的具体实现。
diff --git a/skills/catalog.json b/skills/catalog.json
new file mode 100644
index 00000000..c9ae59c2
--- /dev/null
+++ b/skills/catalog.json
@@ -0,0 +1,86 @@
+{
+  "skills": [
+    "handycontrol-wpf",
+    "handycontrol-wpf-animation-path",
+    "handycontrol-wpf-badge",
+    "handycontrol-wpf-blur-window",
+    "handycontrol-wpf-button-group",
+    "handycontrol-wpf-calendar-with-clock",
+    "handycontrol-wpf-card",
+    "handycontrol-wpf-carousel",
+    "handycontrol-wpf-chat-bubble",
+    "handycontrol-wpf-check-combo-box",
+    "handycontrol-wpf-circle-panel",
+    "handycontrol-wpf-circle-progress-bar",
+    "handycontrol-wpf-clock",
+    "handycontrol-wpf-color-picker",
+    "handycontrol-wpf-combo-box",
+    "handycontrol-wpf-compare-slider",
+    "handycontrol-wpf-context-menu-button",
+    "handycontrol-wpf-cover-flow",
+    "handycontrol-wpf-cover-view",
+    "handycontrol-wpf-dashed-border",
+    "handycontrol-wpf-date-picker",
+    "handycontrol-wpf-date-time-picker",
+    "handycontrol-wpf-dialog",
+    "handycontrol-wpf-divider",
+    "handycontrol-wpf-drawer",
+    "handycontrol-wpf-flip-clock",
+    "handycontrol-wpf-floating-block",
+    "handycontrol-wpf-gif-image",
+    "handycontrol-wpf-glow-window",
+    "handycontrol-wpf-goto-top",
+    "handycontrol-wpf-gravatar",
+    "handycontrol-wpf-grid",
+    "handycontrol-wpf-growl",
+    "handycontrol-wpf-honeycomb-panel",
+    "handycontrol-wpf-image-block",
+    "handycontrol-wpf-image-browser",
+    "handycontrol-wpf-image-selector",
+    "handycontrol-wpf-image-viewer",
+    "handycontrol-wpf-loading",
+    "handycontrol-wpf-magnifier",
+    "handycontrol-wpf-message-box",
+    "handycontrol-wpf-native-styles",
+    "handycontrol-wpf-notification",
+    "handycontrol-wpf-notify-icon",
+    "handycontrol-wpf-numeric-up-down",
+    "handycontrol-wpf-outline-text",
+    "handycontrol-wpf-pagination",
+    "handycontrol-wpf-password-box",
+    "handycontrol-wpf-pin-box",
+    "handycontrol-wpf-pop-tip",
+    "handycontrol-wpf-popup-window",
+    "handycontrol-wpf-preview-slider",
+    "handycontrol-wpf-progress-button",
+    "handycontrol-wpf-property-grid",
+    "handycontrol-wpf-range-slider",
+    "handycontrol-wpf-rate",
+    "handycontrol-wpf-relative-panel",
+    "handycontrol-wpf-running-block",
+    "handycontrol-wpf-screenshot",
+    "handycontrol-wpf-scroll-viewer",
+    "handycontrol-wpf-search-bar",
+    "handycontrol-wpf-shield",
+    "handycontrol-wpf-side-menu",
+    "handycontrol-wpf-simple-items-control",
+    "handycontrol-wpf-simple-panel",
+    "handycontrol-wpf-simple-text",
+    "handycontrol-wpf-split-button",
+    "handycontrol-wpf-sprite",
+    "handycontrol-wpf-step-bar",
+    "handycontrol-wpf-tab-control",
+    "handycontrol-wpf-tag",
+    "handycontrol-wpf-text-box",
+    "handycontrol-wpf-theming",
+    "handycontrol-wpf-time-bar",
+    "handycontrol-wpf-time-picker",
+    "handycontrol-wpf-toggle-block",
+    "handycontrol-wpf-transfer",
+    "handycontrol-wpf-transitioning-content-control",
+    "handycontrol-wpf-waterfall-panel",
+    "handycontrol-wpf-watermark",
+    "handycontrol-wpf-wave-progress-bar",
+    "handycontrol-wpf-window"
+  ]
+}
diff --git a/skills/handycontrol-wpf-animation-path/SKILL.md b/skills/handycontrol-wpf-animation-path/SKILL.md
new file mode 100644
index 00000000..b3a37a0b
--- /dev/null
+++ b/skills/handycontrol-wpf-animation-path/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-animation-path
+description: "实现、配置或排查 HandyControl WPF 的 AnimationPath 动画路径（AnimationPath）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF AnimationPath 动画路径
+
+实现或排查 **AnimationPath 动画路径**。相关类型：`AnimationPath`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-animation-path/agents/openai.yaml b/skills/handycontrol-wpf-animation-path/agents/openai.yaml
new file mode 100644
index 00000000..7657a288
--- /dev/null
+++ b/skills/handycontrol-wpf-animation-path/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF AnimationPath 动画路径"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-animation-path to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-animation-path/references/api.md b/skills/handycontrol-wpf-animation-path/references/api.md
new file mode 100644
index 00000000..282de9ea
--- /dev/null
+++ b/skills/handycontrol-wpf-animation-path/references/api.md
@@ -0,0 +1,19 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## AnimationPath
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/AnimationPath.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/AnimationPath.cs)
+
+```text
+public class AnimationPath : Shape
+public Geometry Data
+public double PathLength
+public Duration Duration
+public bool IsPlaying
+public RepeatBehavior RepeatBehavior
+public FillBehavior FillBehavior
+public AnimationPath()
+public event EventHandler Completed
+```
diff --git a/skills/handycontrol-wpf-animation-path/references/usage.md b/skills/handycontrol-wpf-animation-path/references/usage.md
new file mode 100644
index 00000000..2bea82c8
--- /dev/null
+++ b/skills/handycontrol-wpf-animation-path/references/usage.md
@@ -0,0 +1,16 @@
+# AnimationPath 动画路径 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/animationPath/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/animationPath/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/animationPath/)
+
+按任务阅读原文中的章节：属性、Data 数据、PathLength 路径长度、Duration 时间间隔、IsPlaying 是否正在播放动画、RepeatBehavior 重复行为、继承自Shape常用属性、相关事件、Completed。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/AnimationPath.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/AnimationPath.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/AnimationPathDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/AnimationPathDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/AnimationPathDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/AnimationPathDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-badge/SKILL.md b/skills/handycontrol-wpf-badge/SKILL.md
new file mode 100644
index 00000000..e9d90bde
--- /dev/null
+++ b/skills/handycontrol-wpf-badge/SKILL.md
@@ -0,0 +1,43 @@
+---
+name: handycontrol-wpf-badge
+description: "实现、配置或排查 HandyControl WPF 的 Badge 标记（Badge）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Badge 标记
+
+实现或排查 **Badge 标记**。相关类型：`Badge`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:Badge Value="12" Text="New" BadgeMargin="0,-14,-20,0" Height="30">
+        <Button Content="默认样式"/>
+    </hc:Badge>
+    <hc:Badge Value="12" BadgeMargin="0,-14,-20,0" Height="30">
+        <Button Content="默认样式"/>
+    </hc:Badge>
+```
diff --git a/skills/handycontrol-wpf-badge/agents/openai.yaml b/skills/handycontrol-wpf-badge/agents/openai.yaml
new file mode 100644
index 00000000..79efe205
--- /dev/null
+++ b/skills/handycontrol-wpf-badge/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Badge 标记"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-badge to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-badge/references/api.md b/skills/handycontrol-wpf-badge/references/api.md
new file mode 100644
index 00000000..58feda7b
--- /dev/null
+++ b/skills/handycontrol-wpf-badge/references/api.md
@@ -0,0 +1,19 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Badge
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/Badge.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Badge.cs)
+
+```text
+public class Badge : ContentControl
+public event EventHandler<FunctionEventArgs<int>> ValueChanged
+public string Text
+public int Value
+public BadgeStatus Status
+public int Maximum
+public Thickness BadgeMargin
+public bool ShowBadge
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-badge/references/usage.md b/skills/handycontrol-wpf-badge/references/usage.md
new file mode 100644
index 00000000..267730eb
--- /dev/null
+++ b/skills/handycontrol-wpf-badge/references/usage.md
@@ -0,0 +1,17 @@
+# Badge 标记 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/badge/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/badge/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/badge/)
+
+按任务阅读原文中的章节：基础属性、`Text`和`Value`、案例、效果、`Maximum`最大显示数值、案例、效果、`Status`标记状态类型、案例、效果、`BadgeMargin`相对外边距、案例、效果、事件、相关样式、案例、效果、FAQ、坐标偏移问题[版本 小于等于 2.4]、问题描述、现状、解决方案。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/Badge.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Badge.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Badge.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Badge.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/BadgeDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/BadgeDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/BadgeDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/BadgeDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-blur-window/SKILL.md b/skills/handycontrol-wpf-blur-window/SKILL.md
new file mode 100644
index 00000000..76ef7af8
--- /dev/null
+++ b/skills/handycontrol-wpf-blur-window/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-blur-window
+description: "实现、配置或排查 HandyControl WPF 的 BlurWindow 背景模糊窗口（BlurWindow）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF BlurWindow 背景模糊窗口
+
+实现或排查 **BlurWindow 背景模糊窗口**。相关类型：`BlurWindow`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-blur-window/agents/openai.yaml b/skills/handycontrol-wpf-blur-window/agents/openai.yaml
new file mode 100644
index 00000000..aa346fad
--- /dev/null
+++ b/skills/handycontrol-wpf-blur-window/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF BlurWindow 背景模糊窗口"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-blur-window to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-blur-window/references/api.md b/skills/handycontrol-wpf-blur-window/references/api.md
new file mode 100644
index 00000000..247671cf
--- /dev/null
+++ b/skills/handycontrol-wpf-blur-window/references/api.md
@@ -0,0 +1,38 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## BlurWindow
+
+源码：[src/Shared/HandyControl_Shared/Controls/Window/BlurWindow.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/BlurWindow.cs)
+
+```text
+public class BlurWindow : Window
+public override void OnApplyTemplate()
+```
+
+## Window
+
+源码：[src/Shared/HandyControl_Shared/Controls/Window/Window.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/Window.cs)
+
+```text
+public class Window : System.Windows.Window
+public Window()
+public object NonClientAreaContent
+public Brush CloseButtonHoverBackground
+public Brush CloseButtonHoverForeground
+public Brush CloseButtonBackground
+public Brush CloseButtonForeground
+public Brush OtherButtonBackground
+public Brush OtherButtonForeground
+public Brush OtherButtonHoverBackground
+public Brush OtherButtonHoverForeground
+public Brush NonClientAreaBackground
+public Brush NonClientAreaForeground
+public double NonClientAreaHeight
+public bool ShowNonClientArea
+public bool ShowTitle
+public bool IsFullScreen
+public bool ShowIcon
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-blur-window/references/usage.md b/skills/handycontrol-wpf-blur-window/references/usage.md
new file mode 100644
index 00000000..46a2252b
--- /dev/null
+++ b/skills/handycontrol-wpf-blur-window/references/usage.md
@@ -0,0 +1,15 @@
+# BlurWindow 背景模糊窗口 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/blurWindow/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/blurWindow/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/blurWindow/)
+
+按任务阅读原文中的章节：案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Window/BlurWindow.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/BlurWindow.cs)
+
+## 样式及官方示例
+
+
diff --git a/skills/handycontrol-wpf-button-group/SKILL.md b/skills/handycontrol-wpf-button-group/SKILL.md
new file mode 100644
index 00000000..cf593456
--- /dev/null
+++ b/skills/handycontrol-wpf-button-group/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-button-group
+description: "实现、配置或排查 HandyControl WPF 的 ButtonGroup 按钮组（ButtonGroup）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ButtonGroup 按钮组
+
+实现或排查 **ButtonGroup 按钮组**。相关类型：`ButtonGroup`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-button-group/agents/openai.yaml b/skills/handycontrol-wpf-button-group/agents/openai.yaml
new file mode 100644
index 00000000..0809193c
--- /dev/null
+++ b/skills/handycontrol-wpf-button-group/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ButtonGroup 按钮组"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-button-group to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-button-group/references/api.md b/skills/handycontrol-wpf-button-group/references/api.md
new file mode 100644
index 00000000..c8687360
--- /dev/null
+++ b/skills/handycontrol-wpf-button-group/references/api.md
@@ -0,0 +1,13 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ButtonGroup
+
+源码：[src/Shared/HandyControl_Shared/Controls/Button/ButtonGroup.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Button/ButtonGroup.cs)
+
+```text
+public class ButtonGroup : ItemsControl
+public Orientation Orientation
+public LinearLayout Layout
+```
diff --git a/skills/handycontrol-wpf-button-group/references/usage.md b/skills/handycontrol-wpf-button-group/references/usage.md
new file mode 100644
index 00000000..730ccf10
--- /dev/null
+++ b/skills/handycontrol-wpf-button-group/references/usage.md
@@ -0,0 +1,17 @@
+# ButtonGroup 按钮组 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/buttonGroup/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/buttonGroup/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/buttonGroup/)
+
+按任务阅读原文中的章节：RadioGroupItemBaseStyle、RadioGroup关联样式。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Button/ButtonGroup.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Button/ButtonGroup.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/ButtonGroup.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ButtonGroup.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ButtonGroupDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ButtonGroupDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ButtonGroupDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ButtonGroupDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-calendar-with-clock/SKILL.md b/skills/handycontrol-wpf-calendar-with-clock/SKILL.md
new file mode 100644
index 00000000..7ad4516b
--- /dev/null
+++ b/skills/handycontrol-wpf-calendar-with-clock/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-calendar-with-clock
+description: "实现、配置或排查 HandyControl WPF 的 CalendarWithClock 带有时钟的日历（CalendarWithClock）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF CalendarWithClock 带有时钟的日历
+
+实现或排查 **CalendarWithClock 带有时钟的日历**。相关类型：`CalendarWithClock`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:CalendarWithClock />
+```
diff --git a/skills/handycontrol-wpf-calendar-with-clock/agents/openai.yaml b/skills/handycontrol-wpf-calendar-with-clock/agents/openai.yaml
new file mode 100644
index 00000000..4daa239c
--- /dev/null
+++ b/skills/handycontrol-wpf-calendar-with-clock/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF CalendarWithClock 带有时钟的日历"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-calendar-with-clock to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-calendar-with-clock/references/api.md b/skills/handycontrol-wpf-calendar-with-clock/references/api.md
new file mode 100644
index 00000000..3c71d6c7
--- /dev/null
+++ b/skills/handycontrol-wpf-calendar-with-clock/references/api.md
@@ -0,0 +1,20 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## CalendarWithClock
+
+源码：[src/Shared/HandyControl_Shared/Controls/Time/CalendarWithClock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Time/CalendarWithClock.cs)
+
+```text
+public class CalendarWithClock : Control
+public event EventHandler<FunctionEventArgs<DateTime?>> SelectedDateTimeChanged
+public event EventHandler<FunctionEventArgs<DateTime>> DisplayDateTimeChanged;
+public event Action Confirmed;
+public CalendarWithClock()
+public string DateTimeFormat
+public bool ShowConfirmButton
+public DateTime? SelectedDateTime
+public DateTime DisplayDateTime
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-calendar-with-clock/references/usage.md b/skills/handycontrol-wpf-calendar-with-clock/references/usage.md
new file mode 100644
index 00000000..250210d2
--- /dev/null
+++ b/skills/handycontrol-wpf-calendar-with-clock/references/usage.md
@@ -0,0 +1,17 @@
+# CalendarWithClock 带有时钟的日历 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/calendarWithClock/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/calendarWithClock/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/calendarWithClock/)
+
+按任务阅读原文中的章节：创建日期选取器、选择日期和时间、属性、方法。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Time/CalendarWithClock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Time/CalendarWithClock.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/CalendarWithClock.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/CalendarWithClock.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CalendarWithClockDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CalendarWithClockDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CalendarWithClockDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CalendarWithClockDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-card/SKILL.md b/skills/handycontrol-wpf-card/SKILL.md
new file mode 100644
index 00000000..2b0c6329
--- /dev/null
+++ b/skills/handycontrol-wpf-card/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-card
+description: "实现、配置或排查 HandyControl WPF 的 Card 卡片（Card）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Card 卡片
+
+实现或排查 **Card 卡片**。相关类型：`Card`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-card/agents/openai.yaml b/skills/handycontrol-wpf-card/agents/openai.yaml
new file mode 100644
index 00000000..d103166d
--- /dev/null
+++ b/skills/handycontrol-wpf-card/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Card 卡片"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-card to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-card/references/api.md b/skills/handycontrol-wpf-card/references/api.md
new file mode 100644
index 00000000..947469e6
--- /dev/null
+++ b/skills/handycontrol-wpf-card/references/api.md
@@ -0,0 +1,19 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Card
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/Card.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Card.cs)
+
+```text
+public class Card : ContentControl
+public object Header
+public DataTemplate HeaderTemplate
+public DataTemplateSelector HeaderTemplateSelector
+public string HeaderStringFormat
+public object Footer
+public DataTemplate FooterTemplate
+public DataTemplateSelector FooterTemplateSelector
+public string FooterStringFormat
+```
diff --git a/skills/handycontrol-wpf-card/references/usage.md b/skills/handycontrol-wpf-card/references/usage.md
new file mode 100644
index 00000000..6163b572
--- /dev/null
+++ b/skills/handycontrol-wpf-card/references/usage.md
@@ -0,0 +1,17 @@
+# Card 卡片 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/card/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/card/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/card/)
+
+按任务阅读原文中的章节：基础属性、案例、单卡片使用、`xaml`中使用、效果、作为数据模板、数据类型、视图实体、`xaml`中的使用方式、效果。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/Card.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Card.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Card.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Card.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CardDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CardDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CardDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CardDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-carousel/SKILL.md b/skills/handycontrol-wpf-carousel/SKILL.md
new file mode 100644
index 00000000..ed76315d
--- /dev/null
+++ b/skills/handycontrol-wpf-carousel/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-carousel
+description: "实现、配置或排查 HandyControl WPF 的 Carousel 轮播（Carousel）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Carousel 轮播
+
+实现或排查 **Carousel 轮播**。相关类型：`Carousel`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-carousel/agents/openai.yaml b/skills/handycontrol-wpf-carousel/agents/openai.yaml
new file mode 100644
index 00000000..25be9e96
--- /dev/null
+++ b/skills/handycontrol-wpf-carousel/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Carousel 轮播"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-carousel to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-carousel/references/api.md b/skills/handycontrol-wpf-carousel/references/api.md
new file mode 100644
index 00000000..f0a5c40a
--- /dev/null
+++ b/skills/handycontrol-wpf-carousel/references/api.md
@@ -0,0 +1,36 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Carousel
+
+源码：[src/Shared/HandyControl_Shared/Controls/Carousel/Carousel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Carousel/Carousel.cs)
+
+```text
+public class Carousel : SimpleItemsControl, IDisposable
+public override void OnApplyTemplate()
+public double ExtendWidth
+public bool IsCenter
+public Style PageButtonStyle
+public Carousel()
+public void Dispose()
+public bool AutoRun
+public TimeSpan Interval
+public int PageIndex
+public void UpdatePageButtons(int index = -1)
+```
+
+## SimpleItemsControl
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs)
+
+```text
+public class SimpleItemsControl : Control
+public SimpleItemsControl()
+public IEnumerable ItemsSource
+public Style ItemContainerStyle
+public DataTemplate ItemTemplate
+public Collection<object> Items
+public override void OnApplyTemplate()
+public bool HasItems
+```
diff --git a/skills/handycontrol-wpf-carousel/references/usage.md b/skills/handycontrol-wpf-carousel/references/usage.md
new file mode 100644
index 00000000..24d0b4f2
--- /dev/null
+++ b/skills/handycontrol-wpf-carousel/references/usage.md
@@ -0,0 +1,17 @@
+# Carousel 轮播 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/carousel/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/carousel/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/carousel/)
+
+按任务阅读原文中的章节：属性、案例、显示填充轮播项、使用绑定生成轮播项。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Carousel/Carousel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Carousel/Carousel.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Carousel.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Carousel.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CarouselDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CarouselDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CarouselDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CarouselDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-chat-bubble/SKILL.md b/skills/handycontrol-wpf-chat-bubble/SKILL.md
new file mode 100644
index 00000000..eafba785
--- /dev/null
+++ b/skills/handycontrol-wpf-chat-bubble/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-chat-bubble
+description: "实现、配置或排查 HandyControl WPF 的 ChatBubble 对话气泡（ChatBubble）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ChatBubble 对话气泡
+
+实现或排查 **ChatBubble 对话气泡**。相关类型：`ChatBubble`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-chat-bubble/agents/openai.yaml b/skills/handycontrol-wpf-chat-bubble/agents/openai.yaml
new file mode 100644
index 00000000..2680513c
--- /dev/null
+++ b/skills/handycontrol-wpf-chat-bubble/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ChatBubble 对话气泡"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-chat-bubble to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-chat-bubble/references/api.md b/skills/handycontrol-wpf-chat-bubble/references/api.md
new file mode 100644
index 00000000..39a69632
--- /dev/null
+++ b/skills/handycontrol-wpf-chat-bubble/references/api.md
@@ -0,0 +1,28 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ChatBubble
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/ChatBubble.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/ChatBubble.cs)
+
+```text
+public class ChatBubble : SelectableItem
+public ChatRoleType Role
+public ChatMessageType Type
+public bool IsRead
+public Action<object> ReadAction
+```
+
+## SelectableItem
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/SelectableItem.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/SelectableItem.cs)
+
+```text
+public class SelectableItem : ContentControl, ISelectable
+public bool IsSelected
+public bool SelfManage
+public bool CanDeselect
+public event RoutedEventHandler Selected
+public event RoutedEventHandler Deselected
+```
diff --git a/skills/handycontrol-wpf-chat-bubble/references/usage.md b/skills/handycontrol-wpf-chat-bubble/references/usage.md
new file mode 100644
index 00000000..0eb8b49d
--- /dev/null
+++ b/skills/handycontrol-wpf-chat-bubble/references/usage.md
@@ -0,0 +1,17 @@
+# ChatBubble 对话气泡 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/chatBubble/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/chatBubble/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/chatBubble/)
+
+按任务阅读原文中的章节：属性。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/ChatBubble.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/ChatBubble.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/ChatBubble.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ChatBubble.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ChatBubbleDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ChatBubbleDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ChatBubbleDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ChatBubbleDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-check-combo-box/SKILL.md b/skills/handycontrol-wpf-check-combo-box/SKILL.md
new file mode 100644
index 00000000..d616330e
--- /dev/null
+++ b/skills/handycontrol-wpf-check-combo-box/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-check-combo-box
+description: "实现、配置或排查 HandyControl WPF 的 CheckComboBox 复选组合框（CheckComboBox）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF CheckComboBox 复选组合框
+
+实现或排查 **CheckComboBox 复选组合框**。相关类型：`CheckComboBox`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-check-combo-box/agents/openai.yaml b/skills/handycontrol-wpf-check-combo-box/agents/openai.yaml
new file mode 100644
index 00000000..81799d3a
--- /dev/null
+++ b/skills/handycontrol-wpf-check-combo-box/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF CheckComboBox 复选组合框"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-check-combo-box to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-check-combo-box/references/api.md b/skills/handycontrol-wpf-check-combo-box/references/api.md
new file mode 100644
index 00000000..15d1b0fd
--- /dev/null
+++ b/skills/handycontrol-wpf-check-combo-box/references/api.md
@@ -0,0 +1,19 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## CheckComboBox
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/CheckComboBox/CheckComboBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/CheckComboBox/CheckComboBox.cs)
+
+```text
+public class CheckComboBox : ListBox
+public double MaxDropDownHeight
+public bool IsDropDownOpen
+public Style TagStyle
+public double TagSpacing
+public bool ShowSelectAllButton
+public bool IsReadOnly
+public CheckComboBox()
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-check-combo-box/references/usage.md b/skills/handycontrol-wpf-check-combo-box/references/usage.md
new file mode 100644
index 00000000..ff389de8
--- /dev/null
+++ b/skills/handycontrol-wpf-check-combo-box/references/usage.md
@@ -0,0 +1,17 @@
+# CheckComboBox 复选组合框 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/checkComboBox/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/checkComboBox/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/checkComboBox/)
+
+按任务阅读原文中的章节：属性、附加属性、方法、样式、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Input/CheckComboBox/CheckComboBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/CheckComboBox/CheckComboBox.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/CheckComboBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/CheckComboBox.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CheckComboBoxDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CheckComboBoxDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CheckComboBoxDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CheckComboBoxDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-circle-panel/SKILL.md b/skills/handycontrol-wpf-circle-panel/SKILL.md
new file mode 100644
index 00000000..4469e87f
--- /dev/null
+++ b/skills/handycontrol-wpf-circle-panel/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-circle-panel
+description: "实现、配置或排查 HandyControl WPF 的 CirclePanel 圆形布局（CirclePanel）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF CirclePanel 圆形布局
+
+实现或排查 **CirclePanel 圆形布局**。相关类型：`CirclePanel`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-circle-panel/agents/openai.yaml b/skills/handycontrol-wpf-circle-panel/agents/openai.yaml
new file mode 100644
index 00000000..133e5b6f
--- /dev/null
+++ b/skills/handycontrol-wpf-circle-panel/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF CirclePanel 圆形布局"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-circle-panel to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-circle-panel/references/api.md b/skills/handycontrol-wpf-circle-panel/references/api.md
new file mode 100644
index 00000000..9ba55309
--- /dev/null
+++ b/skills/handycontrol-wpf-circle-panel/references/api.md
@@ -0,0 +1,14 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## CirclePanel
+
+源码：[src/Shared/HandyControl_Shared/Controls/Panel/CirclePanel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/CirclePanel.cs)
+
+```text
+public class CirclePanel : Panel
+public double Diameter
+public bool KeepVertical
+public double OffsetAngle
+```
diff --git a/skills/handycontrol-wpf-circle-panel/references/usage.md b/skills/handycontrol-wpf-circle-panel/references/usage.md
new file mode 100644
index 00000000..a2f8a8be
--- /dev/null
+++ b/skills/handycontrol-wpf-circle-panel/references/usage.md
@@ -0,0 +1,16 @@
+# CirclePanel 圆形布局 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/circlePanel/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/circlePanel/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/circlePanel/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Panel/CirclePanel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/CirclePanel.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CirclePanelDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CirclePanelDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CirclePanelDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CirclePanelDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-circle-progress-bar/SKILL.md b/skills/handycontrol-wpf-circle-progress-bar/SKILL.md
new file mode 100644
index 00000000..8a3579cc
--- /dev/null
+++ b/skills/handycontrol-wpf-circle-progress-bar/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-circle-progress-bar
+description: "实现、配置或排查 HandyControl WPF 的 CircleProgressBar 圆形进度条（CircleProgressBar）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF CircleProgressBar 圆形进度条
+
+实现或排查 **CircleProgressBar 圆形进度条**。相关类型：`CircleProgressBar`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-circle-progress-bar/agents/openai.yaml b/skills/handycontrol-wpf-circle-progress-bar/agents/openai.yaml
new file mode 100644
index 00000000..42e327f8
--- /dev/null
+++ b/skills/handycontrol-wpf-circle-progress-bar/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF CircleProgressBar 圆形进度条"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-circle-progress-bar to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-circle-progress-bar/references/api.md b/skills/handycontrol-wpf-circle-progress-bar/references/api.md
new file mode 100644
index 00000000..d0645d15
--- /dev/null
+++ b/skills/handycontrol-wpf-circle-progress-bar/references/api.md
@@ -0,0 +1,16 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## CircleProgressBar
+
+源码：[src/Shared/HandyControl_Shared/Controls/ProgressBar/CircleProgressBar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/ProgressBar/CircleProgressBar.cs)
+
+```text
+public class CircleProgressBar : RangeBase
+public string Text
+public bool ShowText
+public double ArcThickness
+public bool IsIndeterminate
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-circle-progress-bar/references/usage.md b/skills/handycontrol-wpf-circle-progress-bar/references/usage.md
new file mode 100644
index 00000000..651e420c
--- /dev/null
+++ b/skills/handycontrol-wpf-circle-progress-bar/references/usage.md
@@ -0,0 +1,15 @@
+# CircleProgressBar 圆形进度条 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/circleProgressBar/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/circleProgressBar/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/circleProgressBar/)
+
+按任务阅读原文中的章节：属性、样式、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/ProgressBar/CircleProgressBar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/ProgressBar/CircleProgressBar.cs)
+
+## 样式及官方示例
+
+
diff --git a/skills/handycontrol-wpf-clock/SKILL.md b/skills/handycontrol-wpf-clock/SKILL.md
new file mode 100644
index 00000000..df497f50
--- /dev/null
+++ b/skills/handycontrol-wpf-clock/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-clock
+description: "实现、配置或排查 HandyControl WPF 的 Clock 时钟（Clock）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Clock 时钟
+
+实现或排查 **Clock 时钟**。相关类型：`Clock`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:Clock />
+```
diff --git a/skills/handycontrol-wpf-clock/agents/openai.yaml b/skills/handycontrol-wpf-clock/agents/openai.yaml
new file mode 100644
index 00000000..6d0ebf9e
--- /dev/null
+++ b/skills/handycontrol-wpf-clock/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Clock 时钟"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-clock to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-clock/references/api.md b/skills/handycontrol-wpf-clock/references/api.md
new file mode 100644
index 00000000..8ab6d784
--- /dev/null
+++ b/skills/handycontrol-wpf-clock/references/api.md
@@ -0,0 +1,29 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Clock
+
+源码：[src/Shared/HandyControl_Shared/Controls/Time/Clock/Clock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Time/Clock/Clock.cs)
+
+```text
+public class Clock : ClockBase
+public Style ClockRadioButtonStyle
+public override void OnApplyTemplate()
+```
+
+## ClockBase
+
+源码：[src/Shared/HandyControl_Shared/Controls/Time/Clock/ClockBase.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Time/Clock/ClockBase.cs)
+
+```text
+public abstract class ClockBase : Control
+public event Action Confirmed;
+public event EventHandler<FunctionEventArgs<DateTime>> DisplayTimeChanged;
+public event EventHandler<FunctionEventArgs<DateTime?>> SelectedTimeChanged
+public string TimeFormat
+public DateTime? SelectedTime
+public DateTime DisplayTime
+public virtual void OnClockClosed()
+public virtual void OnClockOpened()
+```
diff --git a/skills/handycontrol-wpf-clock/references/usage.md b/skills/handycontrol-wpf-clock/references/usage.md
new file mode 100644
index 00000000..fc5d9a57
--- /dev/null
+++ b/skills/handycontrol-wpf-clock/references/usage.md
@@ -0,0 +1,17 @@
+# Clock 时钟 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/clock/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/clock/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/clock/)
+
+按任务阅读原文中的章节：创建Clock、选择时间、属性、事件。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Time/Clock/Clock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Time/Clock/Clock.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Clock.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Clock.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ClockDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ClockDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ClockDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ClockDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-color-picker/SKILL.md b/skills/handycontrol-wpf-color-picker/SKILL.md
new file mode 100644
index 00000000..fc64c08f
--- /dev/null
+++ b/skills/handycontrol-wpf-color-picker/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-color-picker
+description: "实现、配置或排查 HandyControl WPF 的 ColorPicker 颜色拾取器（ColorPicker）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ColorPicker 颜色拾取器
+
+实现或排查 **ColorPicker 颜色拾取器**。相关类型：`ColorPicker`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:ColorPicker Name="ColorPicker" Margin="32"/>
+```
diff --git a/skills/handycontrol-wpf-color-picker/agents/openai.yaml b/skills/handycontrol-wpf-color-picker/agents/openai.yaml
new file mode 100644
index 00000000..593176e3
--- /dev/null
+++ b/skills/handycontrol-wpf-color-picker/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ColorPicker 颜色拾取器"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-color-picker to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-color-picker/references/api.md b/skills/handycontrol-wpf-color-picker/references/api.md
new file mode 100644
index 00000000..212b6a1b
--- /dev/null
+++ b/skills/handycontrol-wpf-color-picker/references/api.md
@@ -0,0 +1,21 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ColorPicker
+
+源码：[src/Shared/HandyControl_Shared/Controls/ColorPicker/ColorPicker.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/ColorPicker/ColorPicker.cs)
+
+```text
+public class ColorPicker : Control, ISingleOpen
+public event EventHandler<FunctionEventArgs<Color>> SelectedColorChanged
+public event EventHandler<FunctionEventArgs<Color>> Confirmed
+public event EventHandler Canceled
+public SolidColorBrush SelectedBrush
+public SolidColorBrush SelectedBrushWithoutOpacity
+public SolidColorBrush BackColor
+public ColorPicker()
+public override void OnApplyTemplate()
+public void Dispose()
+public bool CanDispose
+```
diff --git a/skills/handycontrol-wpf-color-picker/references/usage.md b/skills/handycontrol-wpf-color-picker/references/usage.md
new file mode 100644
index 00000000..873bce7a
--- /dev/null
+++ b/skills/handycontrol-wpf-color-picker/references/usage.md
@@ -0,0 +1,17 @@
+# ColorPicker 颜色拾取器 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/colorPicker/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/colorPicker/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/colorPicker/)
+
+按任务阅读原文中的章节：属性、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/ColorPicker/ColorPicker.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/ColorPicker/ColorPicker.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/ColorPicker.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ColorPicker.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ColorPickerDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ColorPickerDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ColorPickerDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ColorPickerDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-combo-box/SKILL.md b/skills/handycontrol-wpf-combo-box/SKILL.md
new file mode 100644
index 00000000..9888c29c
--- /dev/null
+++ b/skills/handycontrol-wpf-combo-box/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-combo-box
+description: "实现、配置或排查 HandyControl WPF 的 ComboBox 组合框（ComboBox）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ComboBox 组合框
+
+实现或排查 **ComboBox 组合框**。相关类型：`ComboBox`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-combo-box/agents/openai.yaml b/skills/handycontrol-wpf-combo-box/agents/openai.yaml
new file mode 100644
index 00000000..caded482
--- /dev/null
+++ b/skills/handycontrol-wpf-combo-box/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ComboBox 组合框"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-combo-box to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-combo-box/references/api.md b/skills/handycontrol-wpf-combo-box/references/api.md
new file mode 100644
index 00000000..e928601d
--- /dev/null
+++ b/skills/handycontrol-wpf-combo-box/references/api.md
@@ -0,0 +1,19 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ComboBox
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/ComboBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/ComboBox.cs)
+
+```text
+public class ComboBox : System.Windows.Controls.ComboBox
+public ComboBox()
+public override void OnApplyTemplate()
+public Func<ItemCollection, object, IEnumerable<object>> SearchFunc
+public bool AutoComplete
+public Brush SelectionBrush
+public Brush SelectionTextBrush
+public double SelectionOpacity
+public Brush CaretBrush
+```
diff --git a/skills/handycontrol-wpf-combo-box/references/usage.md b/skills/handycontrol-wpf-combo-box/references/usage.md
new file mode 100644
index 00000000..6381d686
--- /dev/null
+++ b/skills/handycontrol-wpf-combo-box/references/usage.md
@@ -0,0 +1,17 @@
+# ComboBox 组合框 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/comboBox/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/comboBox/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/comboBox/)
+
+按任务阅读原文中的章节：属性、附加属性、方法、样式、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Input/ComboBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/ComboBox.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/ComboBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ComboBox.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ComboBoxDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ComboBoxDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ComboBoxDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ComboBoxDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-compare-slider/SKILL.md b/skills/handycontrol-wpf-compare-slider/SKILL.md
new file mode 100644
index 00000000..3361cbce
--- /dev/null
+++ b/skills/handycontrol-wpf-compare-slider/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-compare-slider
+description: "实现、配置或排查 HandyControl WPF 的 CompareSlider 对比滑块（CompareSlider）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF CompareSlider 对比滑块
+
+实现或排查 **CompareSlider 对比滑块**。相关类型：`CompareSlider`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-compare-slider/agents/openai.yaml b/skills/handycontrol-wpf-compare-slider/agents/openai.yaml
new file mode 100644
index 00000000..0d38c1b6
--- /dev/null
+++ b/skills/handycontrol-wpf-compare-slider/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF CompareSlider 对比滑块"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-compare-slider to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-compare-slider/references/api.md b/skills/handycontrol-wpf-compare-slider/references/api.md
new file mode 100644
index 00000000..973fe863
--- /dev/null
+++ b/skills/handycontrol-wpf-compare-slider/references/api.md
@@ -0,0 +1,13 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## CompareSlider
+
+源码：[src/Shared/HandyControl_Shared/Controls/Slider/CompareSlider/CompareSlider.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Slider/CompareSlider/CompareSlider.cs)
+
+```text
+public class CompareSlider : Slider
+public object TargetContent
+public object SourceContent
+```
diff --git a/skills/handycontrol-wpf-compare-slider/references/usage.md b/skills/handycontrol-wpf-compare-slider/references/usage.md
new file mode 100644
index 00000000..4f31930d
--- /dev/null
+++ b/skills/handycontrol-wpf-compare-slider/references/usage.md
@@ -0,0 +1,16 @@
+# CompareSlider 对比滑块 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/compareSlider/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/compareSlider/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/compareSlider/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Slider/CompareSlider/CompareSlider.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Slider/CompareSlider/CompareSlider.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CompareSliderDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CompareSliderDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CompareSliderDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CompareSliderDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-context-menu-button/SKILL.md b/skills/handycontrol-wpf-context-menu-button/SKILL.md
new file mode 100644
index 00000000..0017744b
--- /dev/null
+++ b/skills/handycontrol-wpf-context-menu-button/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-context-menu-button
+description: "实现、配置或排查 HandyControl WPF 的 ContextMenuButton 上下文菜单按钮（ContextMenuButton）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ContextMenuButton 上下文菜单按钮
+
+实现或排查 **ContextMenuButton 上下文菜单按钮**。相关类型：`ContextMenuButton`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-context-menu-button/agents/openai.yaml b/skills/handycontrol-wpf-context-menu-button/agents/openai.yaml
new file mode 100644
index 00000000..9b148121
--- /dev/null
+++ b/skills/handycontrol-wpf-context-menu-button/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ContextMenuButton 上下文菜单按钮"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-context-menu-button to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-context-menu-button/references/api.md b/skills/handycontrol-wpf-context-menu-button/references/api.md
new file mode 100644
index 00000000..d8fc16e0
--- /dev/null
+++ b/skills/handycontrol-wpf-context-menu-button/references/api.md
@@ -0,0 +1,12 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ContextMenuButton
+
+源码：[src/Shared/HandyControl_Shared/Controls/Button/ContextMenuButton.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Button/ContextMenuButton.cs)
+
+```text
+public class ContextMenuButton : Button
+public ContextMenu Menu
+```
diff --git a/skills/handycontrol-wpf-context-menu-button/references/usage.md b/skills/handycontrol-wpf-context-menu-button/references/usage.md
new file mode 100644
index 00000000..5af59158
--- /dev/null
+++ b/skills/handycontrol-wpf-context-menu-button/references/usage.md
@@ -0,0 +1,15 @@
+# ContextMenuButton 上下文菜单按钮 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/contextMenuButton/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/contextMenuButton/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/contextMenuButton/)
+
+按任务阅读原文中的章节：。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Button/ContextMenuButton.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Button/ContextMenuButton.cs)
+
+## 样式及官方示例
+
+
diff --git a/skills/handycontrol-wpf-cover-flow/SKILL.md b/skills/handycontrol-wpf-cover-flow/SKILL.md
new file mode 100644
index 00000000..5a170f93
--- /dev/null
+++ b/skills/handycontrol-wpf-cover-flow/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-cover-flow
+description: "实现、配置或排查 HandyControl WPF 的 CoverFlow 封面流（CoverFlow）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF CoverFlow 封面流
+
+实现或排查 **CoverFlow 封面流**。相关类型：`CoverFlow`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:CoverFlow x:Name="CoverFlowMain" Margin="32" Width="500" Height="300"/>
+```
diff --git a/skills/handycontrol-wpf-cover-flow/agents/openai.yaml b/skills/handycontrol-wpf-cover-flow/agents/openai.yaml
new file mode 100644
index 00000000..ef677559
--- /dev/null
+++ b/skills/handycontrol-wpf-cover-flow/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF CoverFlow 封面流"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-cover-flow to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-cover-flow/references/api.md b/skills/handycontrol-wpf-cover-flow/references/api.md
new file mode 100644
index 00000000..0361c601
--- /dev/null
+++ b/skills/handycontrol-wpf-cover-flow/references/api.md
@@ -0,0 +1,19 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## CoverFlow
+
+源码：[src/Shared/HandyControl_Shared/Controls/Cover/CoverFlow/CoverFlow.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Cover/CoverFlow/CoverFlow.cs)
+
+```text
+public class CoverFlow : Control
+public int PageIndex
+public bool Loop
+public override void OnApplyTemplate()
+public void AddRange(IEnumerable<object> contentList)
+public void Add(string uriString)
+public void Add(Uri uri)
+public void Next()
+public void Prev()
+```
diff --git a/skills/handycontrol-wpf-cover-flow/references/usage.md b/skills/handycontrol-wpf-cover-flow/references/usage.md
new file mode 100644
index 00000000..13dcf82b
--- /dev/null
+++ b/skills/handycontrol-wpf-cover-flow/references/usage.md
@@ -0,0 +1,17 @@
+# CoverFlow 封面流 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/coverFlow/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/coverFlow/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/coverFlow/)
+
+按任务阅读原文中的章节：属性、方法、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Cover/CoverFlow/CoverFlow.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Cover/CoverFlow/CoverFlow.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/CoverFlow.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/CoverFlow.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CoverFlowDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CoverFlowDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CoverFlowDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CoverFlowDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-cover-view/SKILL.md b/skills/handycontrol-wpf-cover-view/SKILL.md
new file mode 100644
index 00000000..ecb0da3a
--- /dev/null
+++ b/skills/handycontrol-wpf-cover-view/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-cover-view
+description: "实现、配置或排查 HandyControl WPF 的 CoverView 封面视图（CoverView）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF CoverView 封面视图
+
+实现或排查 **CoverView 封面视图**。相关类型：`CoverView`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-cover-view/agents/openai.yaml b/skills/handycontrol-wpf-cover-view/agents/openai.yaml
new file mode 100644
index 00000000..152d81ed
--- /dev/null
+++ b/skills/handycontrol-wpf-cover-view/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF CoverView 封面视图"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-cover-view to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-cover-view/references/api.md b/skills/handycontrol-wpf-cover-view/references/api.md
new file mode 100644
index 00000000..72c4e3cd
--- /dev/null
+++ b/skills/handycontrol-wpf-cover-view/references/api.md
@@ -0,0 +1,44 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## CoverView
+
+源码：[src/Shared/HandyControl_Shared/Controls/Cover/CoverView/CoverView.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Cover/CoverView/CoverView.cs)
+
+```text
+public class CoverView : RegularItemsControl
+public CoverView()
+public override void OnApplyTemplate()
+public Style CoverViewContentStyle
+public int Groups
+public double ItemContentHeight
+public bool ItemContentHeightFixed
+public DataTemplate ItemHeaderTemplate
+```
+
+## RegularItemsControl
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/RegularItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/RegularItemsControl.cs)
+
+```text
+public class RegularItemsControl : SimpleItemsControl
+public double ItemWidth
+public double ItemHeight
+public Thickness ItemMargin
+```
+
+## SimpleItemsControl
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs)
+
+```text
+public class SimpleItemsControl : Control
+public SimpleItemsControl()
+public IEnumerable ItemsSource
+public Style ItemContainerStyle
+public DataTemplate ItemTemplate
+public Collection<object> Items
+public override void OnApplyTemplate()
+public bool HasItems
+```
diff --git a/skills/handycontrol-wpf-cover-view/references/usage.md b/skills/handycontrol-wpf-cover-view/references/usage.md
new file mode 100644
index 00000000..0744c620
--- /dev/null
+++ b/skills/handycontrol-wpf-cover-view/references/usage.md
@@ -0,0 +1,17 @@
+# CoverView 封面视图 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/coverView/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/coverView/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/coverView/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Cover/CoverView/CoverView.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Cover/CoverView/CoverView.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/CoverView.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/CoverView.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CoverViewDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CoverViewDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/CoverViewDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/CoverViewDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-dashed-border/SKILL.md b/skills/handycontrol-wpf-dashed-border/SKILL.md
new file mode 100644
index 00000000..2630d047
--- /dev/null
+++ b/skills/handycontrol-wpf-dashed-border/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-dashed-border
+description: "实现、配置或排查 HandyControl WPF 的 DashedBorder 虚线边框（DashedBorder）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF DashedBorder 虚线边框
+
+实现或排查 **DashedBorder 虚线边框**。相关类型：`DashedBorder`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:DashedBorder Width="100" Height="100" BorderDashThickness="2" BorderBrush="Black" BorderDashArray="3, 1" CornerRadius="0,50,0,0"/>
+```
diff --git a/skills/handycontrol-wpf-dashed-border/agents/openai.yaml b/skills/handycontrol-wpf-dashed-border/agents/openai.yaml
new file mode 100644
index 00000000..b7637f31
--- /dev/null
+++ b/skills/handycontrol-wpf-dashed-border/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF DashedBorder 虚线边框"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-dashed-border to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-dashed-border/references/api.md b/skills/handycontrol-wpf-dashed-border/references/api.md
new file mode 100644
index 00000000..bfd41fad
--- /dev/null
+++ b/skills/handycontrol-wpf-dashed-border/references/api.md
@@ -0,0 +1,20 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## DashedBorder
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/DashedBorder.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/DashedBorder.cs)
+
+```text
+public class DashedBorder : Decorator
+public Thickness BorderThickness
+public double BorderDashThickness
+public Thickness Padding
+public CornerRadius CornerRadius
+public Brush BorderBrush
+public Brush Background
+public DoubleCollection BorderDashArray
+public PenLineCap BorderDashCap
+public double BorderDashOffset
+```
diff --git a/skills/handycontrol-wpf-dashed-border/references/usage.md b/skills/handycontrol-wpf-dashed-border/references/usage.md
new file mode 100644
index 00000000..3e66ea74
--- /dev/null
+++ b/skills/handycontrol-wpf-dashed-border/references/usage.md
@@ -0,0 +1,15 @@
+# DashedBorder 虚线边框 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/dashedBorder/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/dashedBorder/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/dashedBorder/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/DashedBorder.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/DashedBorder.cs)
+
+## 样式及官方示例
+
+
diff --git a/skills/handycontrol-wpf-date-picker/SKILL.md b/skills/handycontrol-wpf-date-picker/SKILL.md
new file mode 100644
index 00000000..8bf33cc4
--- /dev/null
+++ b/skills/handycontrol-wpf-date-picker/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-date-picker
+description: "实现、配置或排查 HandyControl WPF 的 DatePicker 日期选择器（DatePicker）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF DatePicker 日期选择器
+
+实现或排查 **DatePicker 日期选择器**。相关类型：`DatePicker`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:DatePicker />
+```
diff --git a/skills/handycontrol-wpf-date-picker/agents/openai.yaml b/skills/handycontrol-wpf-date-picker/agents/openai.yaml
new file mode 100644
index 00000000..d1fe97df
--- /dev/null
+++ b/skills/handycontrol-wpf-date-picker/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF DatePicker 日期选择器"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-date-picker to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-date-picker/references/api.md b/skills/handycontrol-wpf-date-picker/references/api.md
new file mode 100644
index 00000000..10091122
--- /dev/null
+++ b/skills/handycontrol-wpf-date-picker/references/api.md
@@ -0,0 +1,17 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## DatePicker
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/DatePicker.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/DatePicker.cs)
+
+```text
+public class DatePicker : System.Windows.Controls.DatePicker
+public DatePicker()
+public override void OnApplyTemplate()
+public Brush SelectionBrush
+public Brush SelectionTextBrush
+public double SelectionOpacity
+public Brush CaretBrush
+```
diff --git a/skills/handycontrol-wpf-date-picker/references/usage.md b/skills/handycontrol-wpf-date-picker/references/usage.md
new file mode 100644
index 00000000..d8a85f61
--- /dev/null
+++ b/skills/handycontrol-wpf-date-picker/references/usage.md
@@ -0,0 +1,17 @@
+# DatePicker 日期选择器 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/datePicker/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/datePicker/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/datePicker/)
+
+按任务阅读原文中的章节：创建DatePicker、选择日期、设置标题和占位符文本、属性、方法。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Input/DatePicker.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/DatePicker.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/DatePicker.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/DatePicker.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/DatePickerDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/DatePickerDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/DatePickerDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/DatePickerDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-date-time-picker/SKILL.md b/skills/handycontrol-wpf-date-time-picker/SKILL.md
new file mode 100644
index 00000000..24b98864
--- /dev/null
+++ b/skills/handycontrol-wpf-date-time-picker/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-date-time-picker
+description: "实现、配置或排查 HandyControl WPF 的 DateTimePicker 日期时间选择器（DateTimePicker）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF DateTimePicker 日期时间选择器
+
+实现或排查 **DateTimePicker 日期时间选择器**。相关类型：`DateTimePicker`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:DateTimePicker />
+```
diff --git a/skills/handycontrol-wpf-date-time-picker/agents/openai.yaml b/skills/handycontrol-wpf-date-time-picker/agents/openai.yaml
new file mode 100644
index 00000000..7961053b
--- /dev/null
+++ b/skills/handycontrol-wpf-date-time-picker/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF DateTimePicker 日期时间选择器"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-date-time-picker to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-date-time-picker/references/api.md b/skills/handycontrol-wpf-date-time-picker/references/api.md
new file mode 100644
index 00000000..bdbab0cc
--- /dev/null
+++ b/skills/handycontrol-wpf-date-time-picker/references/api.md
@@ -0,0 +1,27 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## DateTimePicker
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/DateTimePicker.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/DateTimePicker.cs)
+
+```text
+public class DateTimePicker : Control
+public event EventHandler<FunctionEventArgs<DateTime?>> SelectedDateTimeChanged
+public event RoutedEventHandler PickerClosed;
+public event RoutedEventHandler PickerOpened;
+public DateTimePicker()
+public string DateTimeFormat
+public Style CalendarStyle
+public DateTime DisplayDateTime
+public bool IsDropDownOpen
+public DateTime? SelectedDateTime
+public string Text
+public Brush SelectionBrush
+public Brush SelectionTextBrush
+public double SelectionOpacity
+public Brush CaretBrush
+public override void OnApplyTemplate()
+public override string ToString()
+```
diff --git a/skills/handycontrol-wpf-date-time-picker/references/usage.md b/skills/handycontrol-wpf-date-time-picker/references/usage.md
new file mode 100644
index 00000000..8806b2c7
--- /dev/null
+++ b/skills/handycontrol-wpf-date-time-picker/references/usage.md
@@ -0,0 +1,17 @@
+# DateTimePicker 日期时间选择器 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/dateTimePicker/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/dateTimePicker/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/dateTimePicker/)
+
+按任务阅读原文中的章节：创建DateTimePicker、选择日期和时间、设置标题和占位符文本、属性、方法。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Input/DateTimePicker.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/DateTimePicker.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/DateTimePicker.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/DateTimePicker.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/DateTimePickerDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/DateTimePickerDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/DateTimePickerDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/DateTimePickerDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-dialog/SKILL.md b/skills/handycontrol-wpf-dialog/SKILL.md
new file mode 100644
index 00000000..52913dff
--- /dev/null
+++ b/skills/handycontrol-wpf-dialog/SKILL.md
@@ -0,0 +1,44 @@
+---
+name: handycontrol-wpf-dialog
+description: "实现、配置或排查 HandyControl WPF 的 Dialog 对话框（Dialog）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Dialog 对话框
+
+实现或排查 **Dialog 对话框**。相关类型：`Dialog`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+Dialog.Show 返回覆盖层 Dialog，不等于 Window.ShowDialog。无 token 时依赖活动窗口的 AdornerDecorator；指定 token 时先配置 Dialog.Token 和 DialogContainer。关闭使用返回实例的 Close()。异步结果需要实现库要求的结果接口并引入扩展命名空间，不能直接假定存在任意 Task 返回值。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```csharp
+// 在已显示且具备装饰层的 WPF 窗口的 UI 线程执行。
+var dialog = HandyControl.Controls.Dialog.Show(new System.Windows.Controls.TextBlock
+{
+    Text = "正在处理"
+});
+// 操作完成后关闭。
+dialog.Close();
+```
diff --git a/skills/handycontrol-wpf-dialog/agents/openai.yaml b/skills/handycontrol-wpf-dialog/agents/openai.yaml
new file mode 100644
index 00000000..54c865b5
--- /dev/null
+++ b/skills/handycontrol-wpf-dialog/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Dialog 对话框"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-dialog to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-dialog/references/api.md b/skills/handycontrol-wpf-dialog/references/api.md
new file mode 100644
index 00000000..580e3697
--- /dev/null
+++ b/skills/handycontrol-wpf-dialog/references/api.md
@@ -0,0 +1,23 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Dialog
+
+源码：[src/Shared/HandyControl_Shared/Controls/Dialog/Dialog.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Dialog/Dialog.cs)
+
+```text
+public class Dialog : ContentControl
+public bool IsClosed
+public static void SetMaskCanClose(DependencyObject element, bool value)
+public static bool GetMaskCanClose(DependencyObject element)
+public Brush MaskBrush
+public static void SetToken(DependencyObject element, string value)
+public static string GetToken(DependencyObject element)
+public Dialog()
+public static Dialog Show<T>(string token = "") where T : new()
+public static Dialog Show(object content, string token = "")
+public static void Close(string token)
+public void Close()
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-dialog/references/usage.md b/skills/handycontrol-wpf-dialog/references/usage.md
new file mode 100644
index 00000000..3d3709ad
--- /dev/null
+++ b/skills/handycontrol-wpf-dialog/references/usage.md
@@ -0,0 +1,17 @@
+# Dialog 对话框 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/dialog/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/dialog/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/dialog/)
+
+按任务阅读原文中的章节：属性、附加属性、方法、案例、基本用法、异步等待结果返回、更简单的异步方式、弹框行为。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Dialog/Dialog.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Dialog/Dialog.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Dialog.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Dialog.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/DialogDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/DialogDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/DialogDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/DialogDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-divider/SKILL.md b/skills/handycontrol-wpf-divider/SKILL.md
new file mode 100644
index 00000000..1eee8a08
--- /dev/null
+++ b/skills/handycontrol-wpf-divider/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-divider
+description: "实现、配置或排查 HandyControl WPF 的 Divider 分割线（Divider）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Divider 分割线
+
+实现或排查 **Divider 分割线**。相关类型：`Divider`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-divider/agents/openai.yaml b/skills/handycontrol-wpf-divider/agents/openai.yaml
new file mode 100644
index 00000000..4d386868
--- /dev/null
+++ b/skills/handycontrol-wpf-divider/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Divider 分割线"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-divider to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-divider/references/api.md b/skills/handycontrol-wpf-divider/references/api.md
new file mode 100644
index 00000000..0eeed7ee
--- /dev/null
+++ b/skills/handycontrol-wpf-divider/references/api.md
@@ -0,0 +1,19 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Divider
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/Divider.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Divider.cs)
+
+```text
+public class Divider : Control
+public object Content
+public Orientation Orientation
+public DataTemplate ContentTemplate
+public string ContentStringFormat
+public DataTemplateSelector ContentTemplateSelector
+public Brush LineStroke
+public double LineStrokeThickness
+public DoubleCollection LineStrokeDashArray
+```
diff --git a/skills/handycontrol-wpf-divider/references/usage.md b/skills/handycontrol-wpf-divider/references/usage.md
new file mode 100644
index 00000000..720f4460
--- /dev/null
+++ b/skills/handycontrol-wpf-divider/references/usage.md
@@ -0,0 +1,17 @@
+# Divider 分割线 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/divider/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/divider/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/divider/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/Divider.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Divider.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Divider.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Divider.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/DividerDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/DividerDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/DividerDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/DividerDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-drawer/SKILL.md b/skills/handycontrol-wpf-drawer/SKILL.md
new file mode 100644
index 00000000..342d75c3
--- /dev/null
+++ b/skills/handycontrol-wpf-drawer/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-drawer
+description: "实现、配置或排查 HandyControl WPF 的 Drawer 抽屉（Drawer）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Drawer 抽屉
+
+实现或排查 **Drawer 抽屉**。相关类型：`Drawer`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-drawer/agents/openai.yaml b/skills/handycontrol-wpf-drawer/agents/openai.yaml
new file mode 100644
index 00000000..1017ad99
--- /dev/null
+++ b/skills/handycontrol-wpf-drawer/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Drawer 抽屉"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-drawer to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-drawer/references/api.md b/skills/handycontrol-wpf-drawer/references/api.md
new file mode 100644
index 00000000..c7ffc3c1
--- /dev/null
+++ b/skills/handycontrol-wpf-drawer/references/api.md
@@ -0,0 +1,21 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Drawer
+
+源码：[src/Shared/HandyControl_Shared/Controls/Drawer/Drawer.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Drawer/Drawer.cs)
+
+```text
+public class Drawer : FrameworkElement
+public Drawer()
+public event RoutedEventHandler Opened
+public event RoutedEventHandler Closed
+public bool IsOpen
+public bool MaskCanClose
+public bool ShowMask
+public Dock Dock
+public DrawerShowMode ShowMode
+public Brush MaskBrush
+public object Content
+```
diff --git a/skills/handycontrol-wpf-drawer/references/usage.md b/skills/handycontrol-wpf-drawer/references/usage.md
new file mode 100644
index 00000000..64058f31
--- /dev/null
+++ b/skills/handycontrol-wpf-drawer/references/usage.md
@@ -0,0 +1,17 @@
+# Drawer 抽屉 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/drawer/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/drawer/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/drawer/)
+
+按任务阅读原文中的章节：属性、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Drawer/Drawer.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Drawer/Drawer.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Drawer.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Drawer.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/DrawerDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/DrawerDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/DrawerDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/DrawerDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-flip-clock/SKILL.md b/skills/handycontrol-wpf-flip-clock/SKILL.md
new file mode 100644
index 00000000..f267644c
--- /dev/null
+++ b/skills/handycontrol-wpf-flip-clock/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-flip-clock
+description: "实现、配置或排查 HandyControl WPF 的 FlipClock 翻页时钟（FlipClock）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF FlipClock 翻页时钟
+
+实现或排查 **FlipClock 翻页时钟**。相关类型：`FlipClock`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:FlipClock Margin="32"/>
+```
diff --git a/skills/handycontrol-wpf-flip-clock/agents/openai.yaml b/skills/handycontrol-wpf-flip-clock/agents/openai.yaml
new file mode 100644
index 00000000..41cb5deb
--- /dev/null
+++ b/skills/handycontrol-wpf-flip-clock/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF FlipClock 翻页时钟"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-flip-clock to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-flip-clock/references/api.md b/skills/handycontrol-wpf-flip-clock/references/api.md
new file mode 100644
index 00000000..057dcd31
--- /dev/null
+++ b/skills/handycontrol-wpf-flip-clock/references/api.md
@@ -0,0 +1,15 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## FlipClock
+
+源码：[src/Shared/HandyControl_Shared/Controls/Time/FlipClock/FlipClock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Time/FlipClock/FlipClock.cs)
+
+```text
+public class FlipClock : Control
+public List<int> NumberList
+public DateTime DisplayTime
+public FlipClock()
+public void Dispose()
+```
diff --git a/skills/handycontrol-wpf-flip-clock/references/usage.md b/skills/handycontrol-wpf-flip-clock/references/usage.md
new file mode 100644
index 00000000..f01c2917
--- /dev/null
+++ b/skills/handycontrol-wpf-flip-clock/references/usage.md
@@ -0,0 +1,17 @@
+# FlipClock 翻页时钟 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/flipClock/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/flipClock/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/flipClock/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Time/FlipClock/FlipClock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Time/FlipClock/FlipClock.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/FlipClock.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/FlipClock.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/FlipClockDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/FlipClockDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/FlipClockDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/FlipClockDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-floating-block/SKILL.md b/skills/handycontrol-wpf-floating-block/SKILL.md
new file mode 100644
index 00000000..054343fa
--- /dev/null
+++ b/skills/handycontrol-wpf-floating-block/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-floating-block
+description: "实现、配置或排查 HandyControl WPF 的 FloatingBlock 漂浮块（FloatingBlock）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF FloatingBlock 漂浮块
+
+实现或排查 **FloatingBlock 漂浮块**。相关类型：`FloatingBlock`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-floating-block/agents/openai.yaml b/skills/handycontrol-wpf-floating-block/agents/openai.yaml
new file mode 100644
index 00000000..3d777dc3
--- /dev/null
+++ b/skills/handycontrol-wpf-floating-block/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF FloatingBlock 漂浮块"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-floating-block to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-floating-block/references/api.md b/skills/handycontrol-wpf-floating-block/references/api.md
new file mode 100644
index 00000000..13cd9c12
--- /dev/null
+++ b/skills/handycontrol-wpf-floating-block/references/api.md
@@ -0,0 +1,27 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## FloatingBlock
+
+源码：[src/Shared/HandyControl_Shared/Controls/Block/FloatingBlock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Block/FloatingBlock.cs)
+
+```text
+public class FloatingBlock : Control
+public static void SetToX(DependencyObject element, double value)
+public static double GetToX(DependencyObject element)
+public static void SetToY(DependencyObject element, double value)
+public static double GetToY(DependencyObject element)
+public static void SetDuration(DependencyObject element, Duration value)
+public static Duration GetDuration(DependencyObject element)
+public static void SetHorizontalOffset(DependencyObject element, double value)
+public static double GetHorizontalOffset(DependencyObject element)
+public static void SetVerticalOffset(DependencyObject element, double value)
+public static double GetVerticalOffset(DependencyObject element)
+public static void SetContentTemplate(DependencyObject element, DataTemplate value)
+public static DataTemplate GetContentTemplate(DependencyObject element)
+public DataTemplate ContentTemplate
+public static void SetContent(DependencyObject element, object value)
+public static object GetContent(DependencyObject element)
+public object Content
+```
diff --git a/skills/handycontrol-wpf-floating-block/references/usage.md b/skills/handycontrol-wpf-floating-block/references/usage.md
new file mode 100644
index 00000000..520e4da4
--- /dev/null
+++ b/skills/handycontrol-wpf-floating-block/references/usage.md
@@ -0,0 +1,17 @@
+# FloatingBlock 漂浮块 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/floatingBlock/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/floatingBlock/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/floatingBlock/)
+
+按任务阅读原文中的章节：依赖属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Block/FloatingBlock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Block/FloatingBlock.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/FloatingBlock.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/FloatingBlock.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/FloatingBlockDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/FloatingBlockDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/FloatingBlockDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/FloatingBlockDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-gif-image/SKILL.md b/skills/handycontrol-wpf-gif-image/SKILL.md
new file mode 100644
index 00000000..aae2049a
--- /dev/null
+++ b/skills/handycontrol-wpf-gif-image/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-gif-image
+description: "实现、配置或排查 HandyControl WPF 的 GifImage Gif图片（GifImage）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF GifImage Gif图片
+
+实现或排查 **GifImage Gif图片**。相关类型：`GifImage`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-gif-image/agents/openai.yaml b/skills/handycontrol-wpf-gif-image/agents/openai.yaml
new file mode 100644
index 00000000..835794a9
--- /dev/null
+++ b/skills/handycontrol-wpf-gif-image/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF GifImage Gif图片"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-gif-image to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-gif-image/references/api.md b/skills/handycontrol-wpf-gif-image/references/api.md
new file mode 100644
index 00000000..eb1ace02
--- /dev/null
+++ b/skills/handycontrol-wpf-gif-image/references/api.md
@@ -0,0 +1,16 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## GifImage
+
+源码：[src/Shared/HandyControl_Shared/Controls/Image/GifImage.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Image/GifImage.cs)
+
+```text
+public class GifImage : Image, IDisposable
+public Uri Uri
+public GifImage()
+public GifImage(string filename)
+public GifImage(Stream stream)
+public void Dispose()
+```
diff --git a/skills/handycontrol-wpf-gif-image/references/usage.md b/skills/handycontrol-wpf-gif-image/references/usage.md
new file mode 100644
index 00000000..2f2c0738
--- /dev/null
+++ b/skills/handycontrol-wpf-gif-image/references/usage.md
@@ -0,0 +1,16 @@
+# GifImage Gif图片 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/gifImage/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/gifImage/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/gifImage/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Image/GifImage.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Image/GifImage.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/GifImageDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/GifImageDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/GifImageDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/GifImageDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-glow-window/SKILL.md b/skills/handycontrol-wpf-glow-window/SKILL.md
new file mode 100644
index 00000000..b0143955
--- /dev/null
+++ b/skills/handycontrol-wpf-glow-window/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-glow-window
+description: "实现、配置或排查 HandyControl WPF 的 GlowWindow 辉光窗口（GlowWindow）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF GlowWindow 辉光窗口
+
+实现或排查 **GlowWindow 辉光窗口**。相关类型：`GlowWindow`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-glow-window/agents/openai.yaml b/skills/handycontrol-wpf-glow-window/agents/openai.yaml
new file mode 100644
index 00000000..cd9caf3c
--- /dev/null
+++ b/skills/handycontrol-wpf-glow-window/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF GlowWindow 辉光窗口"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-glow-window to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-glow-window/references/api.md b/skills/handycontrol-wpf-glow-window/references/api.md
new file mode 100644
index 00000000..a72cfac9
--- /dev/null
+++ b/skills/handycontrol-wpf-glow-window/references/api.md
@@ -0,0 +1,39 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## GlowWindow
+
+源码：[src/Shared/HandyControl_Shared/Controls/Window/GlowWindow.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/GlowWindow.cs)
+
+```text
+public class GlowWindow : Window
+public Color ActiveGlowColor
+public Color InactiveGlowColor
+```
+
+## Window
+
+源码：[src/Shared/HandyControl_Shared/Controls/Window/Window.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/Window.cs)
+
+```text
+public class Window : System.Windows.Window
+public Window()
+public object NonClientAreaContent
+public Brush CloseButtonHoverBackground
+public Brush CloseButtonHoverForeground
+public Brush CloseButtonBackground
+public Brush CloseButtonForeground
+public Brush OtherButtonBackground
+public Brush OtherButtonForeground
+public Brush OtherButtonHoverBackground
+public Brush OtherButtonHoverForeground
+public Brush NonClientAreaBackground
+public Brush NonClientAreaForeground
+public double NonClientAreaHeight
+public bool ShowNonClientArea
+public bool ShowTitle
+public bool IsFullScreen
+public bool ShowIcon
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-glow-window/references/usage.md b/skills/handycontrol-wpf-glow-window/references/usage.md
new file mode 100644
index 00000000..7434e85d
--- /dev/null
+++ b/skills/handycontrol-wpf-glow-window/references/usage.md
@@ -0,0 +1,15 @@
+# GlowWindow 辉光窗口 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/glowWindow/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/glowWindow/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/glowWindow/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Window/GlowWindow.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/GlowWindow.cs)
+
+## 样式及官方示例
+
+
diff --git a/skills/handycontrol-wpf-goto-top/SKILL.md b/skills/handycontrol-wpf-goto-top/SKILL.md
new file mode 100644
index 00000000..56d4a8ea
--- /dev/null
+++ b/skills/handycontrol-wpf-goto-top/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-goto-top
+description: "实现、配置或排查 HandyControl WPF 的 GotoTop 回到顶部（GotoTop）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF GotoTop 回到顶部
+
+实现或排查 **GotoTop 回到顶部**。相关类型：`GotoTop`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-goto-top/agents/openai.yaml b/skills/handycontrol-wpf-goto-top/agents/openai.yaml
new file mode 100644
index 00000000..5ca38bd1
--- /dev/null
+++ b/skills/handycontrol-wpf-goto-top/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF GotoTop 回到顶部"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-goto-top to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-goto-top/references/api.md b/skills/handycontrol-wpf-goto-top/references/api.md
new file mode 100644
index 00000000..f5cdd67b
--- /dev/null
+++ b/skills/handycontrol-wpf-goto-top/references/api.md
@@ -0,0 +1,18 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## GotoTop
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/GotoTop.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/GotoTop.cs)
+
+```text
+public class GotoTop : Button
+public DependencyObject Target
+public GotoTop()
+public virtual void CreateGotoAction(DependencyObject obj)
+public bool Animated
+public double AnimationTime
+public double HidingHeight
+public bool AutoHiding
+```
diff --git a/skills/handycontrol-wpf-goto-top/references/usage.md b/skills/handycontrol-wpf-goto-top/references/usage.md
new file mode 100644
index 00000000..912ee9f1
--- /dev/null
+++ b/skills/handycontrol-wpf-goto-top/references/usage.md
@@ -0,0 +1,17 @@
+# GotoTop 回到顶部 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/gotoTop/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/gotoTop/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/gotoTop/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/GotoTop.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/GotoTop.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/GotoTop.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/GotoTop.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/GotoTopDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/GotoTopDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/GotoTopDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/GotoTopDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-gravatar/SKILL.md b/skills/handycontrol-wpf-gravatar/SKILL.md
new file mode 100644
index 00000000..6a757beb
--- /dev/null
+++ b/skills/handycontrol-wpf-gravatar/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-gravatar
+description: "实现、配置或排查 HandyControl WPF 的 Gravatar 头像（Gravatar）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Gravatar 头像
+
+实现或排查 **Gravatar 头像**。相关类型：`Gravatar`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-gravatar/agents/openai.yaml b/skills/handycontrol-wpf-gravatar/agents/openai.yaml
new file mode 100644
index 00000000..bec03298
--- /dev/null
+++ b/skills/handycontrol-wpf-gravatar/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Gravatar 头像"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-gravatar to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-gravatar/references/api.md b/skills/handycontrol-wpf-gravatar/references/api.md
new file mode 100644
index 00000000..11c016a5
--- /dev/null
+++ b/skills/handycontrol-wpf-gravatar/references/api.md
@@ -0,0 +1,14 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Gravatar
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/Gravatar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Gravatar.cs)
+
+```text
+public class Gravatar : ContentControl
+public IGravatarGenerator Generator
+public string Id
+public ImageSource Source
+```
diff --git a/skills/handycontrol-wpf-gravatar/references/usage.md b/skills/handycontrol-wpf-gravatar/references/usage.md
new file mode 100644
index 00000000..7178092a
--- /dev/null
+++ b/skills/handycontrol-wpf-gravatar/references/usage.md
@@ -0,0 +1,17 @@
+# Gravatar 头像 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/gravatar/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/gravatar/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/gravatar/)
+
+按任务阅读原文中的章节：属性、样式、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/Gravatar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Gravatar.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Gravatar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Gravatar.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/GravatarDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/GravatarDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/GravatarDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/GravatarDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-grid/SKILL.md b/skills/handycontrol-wpf-grid/SKILL.md
new file mode 100644
index 00000000..e43e8807
--- /dev/null
+++ b/skills/handycontrol-wpf-grid/SKILL.md
@@ -0,0 +1,41 @@
+---
+name: handycontrol-wpf-grid
+description: "实现、配置或排查 HandyControl WPF 的 Grid 栅格（Row, Col）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Grid 栅格
+
+实现或排查 **Grid 栅格**。相关类型：`Row`, `Col`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+这里的栅格是 hc:Row 与 hc:Col，采用 24 列；不是 hc:Grid。布局使用 Span、Offset、Gutter 等当前源码属性。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:Row Gutter="12">
+    <hc:Col Span="12"><TextBlock Text="左列"/></hc:Col>
+    <hc:Col Span="12"><TextBlock Text="右列"/></hc:Col>
+</hc:Row>
+```
diff --git a/skills/handycontrol-wpf-grid/agents/openai.yaml b/skills/handycontrol-wpf-grid/agents/openai.yaml
new file mode 100644
index 00000000..b7212646
--- /dev/null
+++ b/skills/handycontrol-wpf-grid/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Grid 栅格"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-grid to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-grid/references/api.md b/skills/handycontrol-wpf-grid/references/api.md
new file mode 100644
index 00000000..b2a7e022
--- /dev/null
+++ b/skills/handycontrol-wpf-grid/references/api.md
@@ -0,0 +1,24 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Row
+
+源码：[src/Shared/HandyControl_Shared/Controls/Panel/Grid/Row.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/Grid/Row.cs)
+
+```text
+public class Row : Panel
+public double Gutter
+```
+
+## Col
+
+源码：[src/Shared/HandyControl_Shared/Controls/Panel/Grid/Col.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/Grid/Col.cs)
+
+```text
+public class Col : ContentControl
+public ColLayout Layout
+public int Offset
+public int Span
+public bool IsFixed
+```
diff --git a/skills/handycontrol-wpf-grid/references/usage.md b/skills/handycontrol-wpf-grid/references/usage.md
new file mode 100644
index 00000000..5029d0cc
--- /dev/null
+++ b/skills/handycontrol-wpf-grid/references/usage.md
@@ -0,0 +1,16 @@
+# Grid 栅格 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/grid/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/grid/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/grid/)
+
+按任务阅读原文中的章节：属性、Row 行、Col 列、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Panel/Grid/Row.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/Grid/Row.cs)
+- [src/Shared/HandyControl_Shared/Controls/Panel/Grid/Col.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/Grid/Col.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Col.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Col.xaml)
diff --git a/skills/handycontrol-wpf-growl/SKILL.md b/skills/handycontrol-wpf-growl/SKILL.md
new file mode 100644
index 00000000..1260b823
--- /dev/null
+++ b/skills/handycontrol-wpf-growl/SKILL.md
@@ -0,0 +1,39 @@
+---
+name: handycontrol-wpf-growl
+description: "实现、配置或排查 HandyControl WPF 的 Growl 信息通知（Growl）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Growl 信息通知
+
+实现或排查 **Growl 信息通知**。相关类型：`Growl`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+Growl 是通知 API 与控件的组合。页面内通知需要 Panel 上的 Growl.GrowlParent 或 Growl.Token；多窗口使用唯一 token。普通通知与 Global 方法的显示范围不同。后台任务更新 UI 先切回 Dispatcher。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<!-- 在窗口可视树中声明；加载后在 UI 线程调用 Growl.Success("保存成功")。 -->
+<StackPanel hc:Growl.GrowlParent="True"/>
+```
diff --git a/skills/handycontrol-wpf-growl/agents/openai.yaml b/skills/handycontrol-wpf-growl/agents/openai.yaml
new file mode 100644
index 00000000..93c196c8
--- /dev/null
+++ b/skills/handycontrol-wpf-growl/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Growl 信息通知"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-growl to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-growl/references/api.md b/skills/handycontrol-wpf-growl/references/api.md
new file mode 100644
index 00000000..b5c4f87a
--- /dev/null
+++ b/skills/handycontrol-wpf-growl/references/api.md
@@ -0,0 +1,56 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Growl
+
+源码：[src/Shared/HandyControl_Shared/Controls/Growl/Growl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Growl/Growl.cs)
+
+```text
+public class Growl : Control
+public static Panel GrowlPanel
+public InfoType Type
+public bool ShowDateTime
+public string Message
+public DateTime Time
+public Geometry Icon
+public Brush IconBrush
+public Growl()
+public override void OnApplyTemplate()
+public static void SetToken(DependencyObject element, string value)
+public static string GetToken(DependencyObject element)
+public static void SetShowMode(DependencyObject element, GrowlShowMode value)
+public static GrowlShowMode GetShowMode(DependencyObject element)
+public static void SetTransitionMode(DependencyObject element, TransitionMode value)
+public static TransitionMode GetTransitionMode(DependencyObject element)
+public static void SetTransitionStoryboard(DependencyObject element, Storyboard value)
+public static Storyboard GetTransitionStoryboard(DependencyObject element)
+public static void SetGrowlParent(DependencyObject element, bool value)
+public static bool GetGrowlParent(DependencyObject element)
+public static void Success(string message, string token = "")
+public static void Success(GrowlInfo growlInfo)
+public static void SuccessGlobal(string message)
+public static void SuccessGlobal(GrowlInfo growlInfo)
+public static void Info(string message, string token = "")
+public static void Info(GrowlInfo growlInfo)
+public static void InfoGlobal(string message)
+public static void InfoGlobal(GrowlInfo growlInfo)
+public static void Warning(string message, string token = "")
+public static void Warning(GrowlInfo growlInfo)
+public static void WarningGlobal(string message)
+public static void WarningGlobal(GrowlInfo growlInfo)
+public static void Error(string message, string token = "")
+public static void Error(GrowlInfo growlInfo)
+public static void ErrorGlobal(string message)
+public static void ErrorGlobal(GrowlInfo growlInfo)
+public static void Fatal(string message, string token = "")
+public static void Fatal(GrowlInfo growlInfo)
+public static void FatalGlobal(string message)
+public static void FatalGlobal(GrowlInfo growlInfo)
+public static void Ask(string message, Func<bool, bool> actionBeforeClose, string token = "")
+public static void Ask(GrowlInfo growlInfo)
+public static void AskGlobal(string message, Func<bool, bool> actionBeforeClose)
+public static void AskGlobal(GrowlInfo growlInfo)
+public static void Clear(string token = "")
+public static void ClearGlobal()
+```
diff --git a/skills/handycontrol-wpf-growl/references/usage.md b/skills/handycontrol-wpf-growl/references/usage.md
new file mode 100644
index 00000000..de3ea44f
--- /dev/null
+++ b/skills/handycontrol-wpf-growl/references/usage.md
@@ -0,0 +1,17 @@
+# Growl 信息通知 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/growl/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/growl/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/growl/)
+
+按任务阅读原文中的章节：控件效果、准备工作、基础用法、只在激活中的窗口显示信息通知、在任意的`StackPanel`容器中显示信息通知、属性、附加属性、方法、注意、FAQ。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Growl/Growl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Growl/Growl.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Growl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Growl.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/GrowlDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/GrowlDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/GrowlDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/GrowlDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-honeycomb-panel/SKILL.md b/skills/handycontrol-wpf-honeycomb-panel/SKILL.md
new file mode 100644
index 00000000..9cb0c686
--- /dev/null
+++ b/skills/handycontrol-wpf-honeycomb-panel/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-honeycomb-panel
+description: "实现、配置或排查 HandyControl WPF 的 HoneycombPanel 蜂窝布局（HoneycombPanel）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF HoneycombPanel 蜂窝布局
+
+实现或排查 **HoneycombPanel 蜂窝布局**。相关类型：`HoneycombPanel`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-honeycomb-panel/agents/openai.yaml b/skills/handycontrol-wpf-honeycomb-panel/agents/openai.yaml
new file mode 100644
index 00000000..23265a71
--- /dev/null
+++ b/skills/handycontrol-wpf-honeycomb-panel/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF HoneycombPanel 蜂窝布局"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-honeycomb-panel to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-honeycomb-panel/references/api.md b/skills/handycontrol-wpf-honeycomb-panel/references/api.md
new file mode 100644
index 00000000..28f7588f
--- /dev/null
+++ b/skills/handycontrol-wpf-honeycomb-panel/references/api.md
@@ -0,0 +1,13 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## HoneycombPanel
+
+源码：[src/Shared/HandyControl_Shared/Controls/Panel/HoneycombPanel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/HoneycombPanel.cs)
+
+```text
+public class HoneycombPanel : Panel
+public HoneycombStuffer(Rect childBounds)
+public Rect Move()
+```
diff --git a/skills/handycontrol-wpf-honeycomb-panel/references/usage.md b/skills/handycontrol-wpf-honeycomb-panel/references/usage.md
new file mode 100644
index 00000000..0313f73f
--- /dev/null
+++ b/skills/handycontrol-wpf-honeycomb-panel/references/usage.md
@@ -0,0 +1,16 @@
+# HoneycombPanel 蜂窝布局 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/honeycombPanel/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/honeycombPanel/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/honeycombPanel/)
+
+按任务阅读原文中的章节：蜂窝布局方式、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Panel/HoneycombPanel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/HoneycombPanel.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/HoneycombPanelDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/HoneycombPanelDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/HoneycombPanelDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/HoneycombPanelDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-image-block/SKILL.md b/skills/handycontrol-wpf-image-block/SKILL.md
new file mode 100644
index 00000000..2c63cf70
--- /dev/null
+++ b/skills/handycontrol-wpf-image-block/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-image-block
+description: "实现、配置或排查 HandyControl WPF 的 ImageBlock 图片块（ImageBlock）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ImageBlock 图片块
+
+实现或排查 **ImageBlock 图片块**。相关类型：`ImageBlock`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-image-block/agents/openai.yaml b/skills/handycontrol-wpf-image-block/agents/openai.yaml
new file mode 100644
index 00000000..f98c397c
--- /dev/null
+++ b/skills/handycontrol-wpf-image-block/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ImageBlock 图片块"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-image-block to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-image-block/references/api.md b/skills/handycontrol-wpf-image-block/references/api.md
new file mode 100644
index 00000000..aa1c43ea
--- /dev/null
+++ b/skills/handycontrol-wpf-image-block/references/api.md
@@ -0,0 +1,22 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ImageBlock
+
+源码：[src/Shared/HandyControl_Shared/Controls/Image/ImageBlock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Image/ImageBlock.cs)
+
+```text
+public class ImageBlock : FrameworkElement
+public ImageBlock()
+public void Dispose()
+public int StartColumn
+public int StartRow
+public int EndColumn
+public int EndRow
+public bool IsPlaying
+public int Columns
+public int Rows
+public TimeSpan Interval
+public ImageSource Source
+```
diff --git a/skills/handycontrol-wpf-image-block/references/usage.md b/skills/handycontrol-wpf-image-block/references/usage.md
new file mode 100644
index 00000000..5dcd2299
--- /dev/null
+++ b/skills/handycontrol-wpf-image-block/references/usage.md
@@ -0,0 +1,16 @@
+# ImageBlock 图片块 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/imageBlock/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/imageBlock/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/imageBlock/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Image/ImageBlock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Image/ImageBlock.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageBlockDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageBlockDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageBlockDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageBlockDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-image-browser/SKILL.md b/skills/handycontrol-wpf-image-browser/SKILL.md
new file mode 100644
index 00000000..94c65f06
--- /dev/null
+++ b/skills/handycontrol-wpf-image-browser/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-image-browser
+description: "实现、配置或排查 HandyControl WPF 的 ImageBrowser 图片浏览器（ImageBrowser）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ImageBrowser 图片浏览器
+
+实现或排查 **ImageBrowser 图片浏览器**。相关类型：`ImageBrowser`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-image-browser/agents/openai.yaml b/skills/handycontrol-wpf-image-browser/agents/openai.yaml
new file mode 100644
index 00000000..404e50b9
--- /dev/null
+++ b/skills/handycontrol-wpf-image-browser/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ImageBrowser 图片浏览器"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-image-browser to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-image-browser/references/api.md b/skills/handycontrol-wpf-image-browser/references/api.md
new file mode 100644
index 00000000..b9af1bfa
--- /dev/null
+++ b/skills/handycontrol-wpf-image-browser/references/api.md
@@ -0,0 +1,41 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ImageBrowser
+
+源码：[src/Shared/HandyControl_Shared/Controls/Window/ImageBrowser.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/ImageBrowser.cs)
+
+```text
+public class ImageBrowser : Window
+public ImageBrowser()
+public ImageBrowser(Uri uri) : this()
+public ImageBrowser(string path) : this(new Uri(path))
+public override void OnApplyTemplate()
+```
+
+## Window
+
+源码：[src/Shared/HandyControl_Shared/Controls/Window/Window.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/Window.cs)
+
+```text
+public class Window : System.Windows.Window
+public Window()
+public object NonClientAreaContent
+public Brush CloseButtonHoverBackground
+public Brush CloseButtonHoverForeground
+public Brush CloseButtonBackground
+public Brush CloseButtonForeground
+public Brush OtherButtonBackground
+public Brush OtherButtonForeground
+public Brush OtherButtonHoverBackground
+public Brush OtherButtonHoverForeground
+public Brush NonClientAreaBackground
+public Brush NonClientAreaForeground
+public double NonClientAreaHeight
+public bool ShowNonClientArea
+public bool ShowTitle
+public bool IsFullScreen
+public bool ShowIcon
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-image-browser/references/usage.md b/skills/handycontrol-wpf-image-browser/references/usage.md
new file mode 100644
index 00000000..33d584d8
--- /dev/null
+++ b/skills/handycontrol-wpf-image-browser/references/usage.md
@@ -0,0 +1,16 @@
+# ImageBrowser 图片浏览器 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/imageBrowser/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/imageBrowser/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/imageBrowser/)
+
+按任务阅读原文中的章节：案例、功能。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Window/ImageBrowser.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/ImageBrowser.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageBrowserDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageBrowserDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageBrowserDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageBrowserDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-image-selector/SKILL.md b/skills/handycontrol-wpf-image-selector/SKILL.md
new file mode 100644
index 00000000..67925d54
--- /dev/null
+++ b/skills/handycontrol-wpf-image-selector/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-image-selector
+description: "实现、配置或排查 HandyControl WPF 的 ImageSelector 图片选择器（ImageSelector）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ImageSelector 图片选择器
+
+实现或排查 **ImageSelector 图片选择器**。相关类型：`ImageSelector`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-image-selector/agents/openai.yaml b/skills/handycontrol-wpf-image-selector/agents/openai.yaml
new file mode 100644
index 00000000..26b358c7
--- /dev/null
+++ b/skills/handycontrol-wpf-image-selector/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ImageSelector 图片选择器"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-image-selector to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-image-selector/references/api.md b/skills/handycontrol-wpf-image-selector/references/api.md
new file mode 100644
index 00000000..88e4ea17
--- /dev/null
+++ b/skills/handycontrol-wpf-image-selector/references/api.md
@@ -0,0 +1,25 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ImageSelector
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/ImageSelector.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/ImageSelector.cs)
+
+```text
+public class ImageSelector : Control
+public event RoutedEventHandler ImageSelected
+public event RoutedEventHandler ImageUnselected
+public ImageSelector()
+public Stretch Stretch
+public static readonly DependencyPropertyKey UriPropertyKey = DependencyProperty.RegisterReadOnly(
+public Uri Uri
+public static readonly DependencyPropertyKey PreviewBrushPropertyKey = DependencyProperty.RegisterReadOnly(
+public Brush PreviewBrush
+public double StrokeThickness
+public DoubleCollection StrokeDashArray
+public string DefaultExt
+public string Filter
+public static readonly DependencyPropertyKey HasValuePropertyKey = DependencyProperty.RegisterReadOnly(
+public bool HasValue
+```
diff --git a/skills/handycontrol-wpf-image-selector/references/usage.md b/skills/handycontrol-wpf-image-selector/references/usage.md
new file mode 100644
index 00000000..dd29b7db
--- /dev/null
+++ b/skills/handycontrol-wpf-image-selector/references/usage.md
@@ -0,0 +1,17 @@
+# ImageSelector 图片选择器 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/imageSelector/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/imageSelector/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/imageSelector/)
+
+按任务阅读原文中的章节：属性、样式、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Input/ImageSelector.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/ImageSelector.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/ImageSelector.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ImageSelector.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageSelectorDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageSelectorDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageSelectorDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ImageSelectorDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-image-viewer/SKILL.md b/skills/handycontrol-wpf-image-viewer/SKILL.md
new file mode 100644
index 00000000..64f62301
--- /dev/null
+++ b/skills/handycontrol-wpf-image-viewer/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-image-viewer
+description: "实现、配置或排查 HandyControl WPF 的 ImageViewer 图片视图（ImageViewer）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ImageViewer 图片视图
+
+实现或排查 **ImageViewer 图片视图**。相关类型：`ImageViewer`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-image-viewer/agents/openai.yaml b/skills/handycontrol-wpf-image-viewer/agents/openai.yaml
new file mode 100644
index 00000000..9524a7b9
--- /dev/null
+++ b/skills/handycontrol-wpf-image-viewer/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ImageViewer 图片视图"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-image-viewer to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-image-viewer/references/api.md b/skills/handycontrol-wpf-image-viewer/references/api.md
new file mode 100644
index 00000000..60a1b72a
--- /dev/null
+++ b/skills/handycontrol-wpf-image-viewer/references/api.md
@@ -0,0 +1,29 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ImageViewer
+
+源码：[src/Shared/HandyControl_Shared/Controls/Image/ImageViewer.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Image/ImageViewer.cs)
+
+```text
+public class ImageViewer : Control, IDisposable
+public ImageViewer()
+public ImageViewer(Uri uri) : this()
+public ImageViewer(string path) : this(new Uri(path))
+public bool IsFullScreen
+public MouseGesture MoveGesture
+public bool ShowImgMap
+public BitmapFrame ImageSource
+public Uri Uri
+public bool ShowToolBar
+public bool ShowFullScreenButton
+public Thickness ImageMargin
+public double ImageWidth
+public double ImageHeight
+public string ScaleStr
+public bool ShowSmallImgInternal
+public bool ShowCloseButton
+public override void OnApplyTemplate()
+public void Dispose()
+```
diff --git a/skills/handycontrol-wpf-image-viewer/references/usage.md b/skills/handycontrol-wpf-image-viewer/references/usage.md
new file mode 100644
index 00000000..28bee74c
--- /dev/null
+++ b/skills/handycontrol-wpf-image-viewer/references/usage.md
@@ -0,0 +1,15 @@
+# ImageViewer 图片视图 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/imageViewer/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/imageViewer/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/imageViewer/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Image/ImageViewer.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Image/ImageViewer.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/ImageViewer.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ImageViewer.xaml)
diff --git a/skills/handycontrol-wpf-loading/SKILL.md b/skills/handycontrol-wpf-loading/SKILL.md
new file mode 100644
index 00000000..09bb481b
--- /dev/null
+++ b/skills/handycontrol-wpf-loading/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-loading
+description: "实现、配置或排查 HandyControl WPF 的 Loading 加载条（LoadingBase, LoadingLine, LoadingCircle）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Loading 加载条
+
+实现或排查 **Loading 加载条**。相关类型：`LoadingBase`, `LoadingLine`, `LoadingCircle`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+LoadingBase 是抽象基类，实际使用 LoadingLine 或 LoadingCircle；耗时任务异步执行，避免阻塞动画线程。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:LoadingCircle IsRunning="{Binding IsBusy}"/>
+```
diff --git a/skills/handycontrol-wpf-loading/agents/openai.yaml b/skills/handycontrol-wpf-loading/agents/openai.yaml
new file mode 100644
index 00000000..6fbbfec0
--- /dev/null
+++ b/skills/handycontrol-wpf-loading/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Loading 加载条"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-loading to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-loading/references/api.md b/skills/handycontrol-wpf-loading/references/api.md
new file mode 100644
index 00000000..c1bacc89
--- /dev/null
+++ b/skills/handycontrol-wpf-loading/references/api.md
@@ -0,0 +1,38 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## LoadingBase
+
+源码：[src/Shared/HandyControl_Shared/Controls/Loading/LoadingBase.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Loading/LoadingBase.cs)
+
+```text
+public abstract class LoadingBase : ContentControl
+public bool IsRunning
+public int DotCount
+public double DotInterval
+public Brush DotBorderBrush
+public double DotBorderThickness
+public double DotDiameter
+public double DotSpeed
+public double DotDelayTime
+```
+
+## LoadingLine
+
+源码：[src/Shared/HandyControl_Shared/Controls/Loading/LoadingLine.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Loading/LoadingLine.cs)
+
+```text
+public class LoadingLine : LoadingBase
+public LoadingLine()
+```
+
+## LoadingCircle
+
+源码：[src/Shared/HandyControl_Shared/Controls/Loading/LoadingCircle.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Loading/LoadingCircle.cs)
+
+```text
+public class LoadingCircle : LoadingBase
+public double DotOffSet
+public bool NeedHidden
+```
diff --git a/skills/handycontrol-wpf-loading/references/usage.md b/skills/handycontrol-wpf-loading/references/usage.md
new file mode 100644
index 00000000..20f55e01
--- /dev/null
+++ b/skills/handycontrol-wpf-loading/references/usage.md
@@ -0,0 +1,17 @@
+# Loading 加载条 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/loading/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/loading/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/loading/)
+
+按任务阅读原文中的章节：LoadingBase 属性、LoadingCircle 属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Loading/LoadingBase.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Loading/LoadingBase.cs)
+- [src/Shared/HandyControl_Shared/Controls/Loading/LoadingLine.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Loading/LoadingLine.cs)
+- [src/Shared/HandyControl_Shared/Controls/Loading/LoadingCircle.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Loading/LoadingCircle.cs)
+
+## 样式及官方示例
+
+
diff --git a/skills/handycontrol-wpf-magnifier/SKILL.md b/skills/handycontrol-wpf-magnifier/SKILL.md
new file mode 100644
index 00000000..45283805
--- /dev/null
+++ b/skills/handycontrol-wpf-magnifier/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-magnifier
+description: "实现、配置或排查 HandyControl WPF 的 Magnifier 放大镜（Magnifier）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Magnifier 放大镜
+
+实现或排查 **Magnifier 放大镜**。相关类型：`Magnifier`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-magnifier/agents/openai.yaml b/skills/handycontrol-wpf-magnifier/agents/openai.yaml
new file mode 100644
index 00000000..969f0e8b
--- /dev/null
+++ b/skills/handycontrol-wpf-magnifier/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Magnifier 放大镜"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-magnifier to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-magnifier/references/api.md b/skills/handycontrol-wpf-magnifier/references/api.md
new file mode 100644
index 00000000..a56160fa
--- /dev/null
+++ b/skills/handycontrol-wpf-magnifier/references/api.md
@@ -0,0 +1,30 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Magnifier
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/Magnifier.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Magnifier.cs)
+
+```text
+public class Magnifier : AdornerElement
+public double HorizontalOffset
+public double VerticalOffset
+public static Magnifier Default
+public double Scale
+public Magnifier()
+public override void OnApplyTemplate()
+```
+
+## AdornerElement
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/AdornerElement.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/AdornerElement.cs)
+
+```text
+public abstract class AdornerElement : Control, IDisposable
+public FrameworkElement Target
+public static void SetInstance(DependencyObject element, AdornerElement value)
+public static AdornerElement GetInstance(DependencyObject element)
+public static void SetIsInstance(DependencyObject element, bool value)
+public static bool GetIsInstance(DependencyObject element)
+```
diff --git a/skills/handycontrol-wpf-magnifier/references/usage.md b/skills/handycontrol-wpf-magnifier/references/usage.md
new file mode 100644
index 00000000..2fae3fa9
--- /dev/null
+++ b/skills/handycontrol-wpf-magnifier/references/usage.md
@@ -0,0 +1,17 @@
+# Magnifier 放大镜 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/magnifier/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/magnifier/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/magnifier/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/Magnifier.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Magnifier.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Magnifier.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Magnifier.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/MagnifierDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/MagnifierDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/MagnifierDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/MagnifierDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-message-box/SKILL.md b/skills/handycontrol-wpf-message-box/SKILL.md
new file mode 100644
index 00000000..56e45ac2
--- /dev/null
+++ b/skills/handycontrol-wpf-message-box/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-message-box
+description: "实现、配置或排查 HandyControl WPF 的 MessageBox 消息对话框（MessageBox）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF MessageBox 消息对话框
+
+实现或排查 **MessageBox 消息对话框**。相关类型：`MessageBox`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+使用 HandyControl.Controls.MessageBox 全名或别名以避免与 System.Windows.MessageBox 混淆；按实际重载处理 MessageBoxResult。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-message-box/agents/openai.yaml b/skills/handycontrol-wpf-message-box/agents/openai.yaml
new file mode 100644
index 00000000..a5bd6c08
--- /dev/null
+++ b/skills/handycontrol-wpf-message-box/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF MessageBox 消息对话框"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-message-box to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-message-box/references/api.md b/skills/handycontrol-wpf-message-box/references/api.md
new file mode 100644
index 00000000..08ae093d
--- /dev/null
+++ b/skills/handycontrol-wpf-message-box/references/api.md
@@ -0,0 +1,56 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## MessageBox
+
+源码：[src/Shared/HandyControl_Shared/Controls/Window/MessageBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/MessageBox.cs)
+
+```text
+public sealed class MessageBox : Window
+public string Message
+public Geometry Image
+public Brush ImageBrush
+public bool ShowImage
+public override void OnApplyTemplate()
+public static MessageBoxResult Success(string messageBoxText, string caption = null)
+public static MessageBoxResult Success(System.Windows.Window owner, string messageBoxText, string caption = null)
+public static MessageBoxResult Info(string messageBoxText, string caption = null)
+public static MessageBoxResult Info(System.Windows.Window owner, string messageBoxText, string caption = null)
+public static MessageBoxResult Warning(string messageBoxText, string caption = null)
+public static MessageBoxResult Warning(System.Windows.Window owner, string messageBoxText, string caption = null)
+public static MessageBoxResult Error(string messageBoxText, string caption = null)
+public static MessageBoxResult Error(System.Windows.Window owner, string messageBoxText, string caption = null)
+public static MessageBoxResult Fatal(string messageBoxText, string caption = null)
+public static MessageBoxResult Fatal(System.Windows.Window owner, string messageBoxText, string caption = null)
+public static MessageBoxResult Ask(string messageBoxText, string caption = null)
+public static MessageBoxResult Ask(System.Windows.Window owner, string messageBoxText, string caption = null)
+public static MessageBoxResult Show(MessageBoxInfo info)
+public static MessageBoxResult Show(
+```
+
+## Window
+
+源码：[src/Shared/HandyControl_Shared/Controls/Window/Window.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/Window.cs)
+
+```text
+public class Window : System.Windows.Window
+public Window()
+public object NonClientAreaContent
+public Brush CloseButtonHoverBackground
+public Brush CloseButtonHoverForeground
+public Brush CloseButtonBackground
+public Brush CloseButtonForeground
+public Brush OtherButtonBackground
+public Brush OtherButtonForeground
+public Brush OtherButtonHoverBackground
+public Brush OtherButtonHoverForeground
+public Brush NonClientAreaBackground
+public Brush NonClientAreaForeground
+public double NonClientAreaHeight
+public bool ShowNonClientArea
+public bool ShowTitle
+public bool IsFullScreen
+public bool ShowIcon
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-message-box/references/usage.md b/skills/handycontrol-wpf-message-box/references/usage.md
new file mode 100644
index 00000000..c7cb1b4f
--- /dev/null
+++ b/skills/handycontrol-wpf-message-box/references/usage.md
@@ -0,0 +1,15 @@
+# MessageBox 消息对话框 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/messageBox/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/messageBox/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/messageBox/)
+
+按任务阅读原文中的章节：属性、方法、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Window/MessageBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/MessageBox.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/MessageBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/MessageBox.xaml)
diff --git a/skills/handycontrol-wpf-native-styles/SKILL.md b/skills/handycontrol-wpf-native-styles/SKILL.md
new file mode 100644
index 00000000..bdcb08e8
--- /dev/null
+++ b/skills/handycontrol-wpf-native-styles/SKILL.md
@@ -0,0 +1,14 @@
+---
+name: handycontrol-wpf-native-styles
+description: "为原生 WPF Button、TextBox、DataGrid、ListBox 等应用 HandyControl 样式和附加属性，区分原生与 hc 同名控件。"
+---
+
+# HandyControl WPF 原生控件样式
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+按任务阅读 [配置及示例](references/usage.md)。先确认控件实际 CLR 类型和样式 TargetType，再修改资源。
diff --git a/skills/handycontrol-wpf-native-styles/agents/openai.yaml b/skills/handycontrol-wpf-native-styles/agents/openai.yaml
new file mode 100644
index 00000000..03497b6a
--- /dev/null
+++ b/skills/handycontrol-wpf-native-styles/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF 原生控件样式"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-native-styles to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-native-styles/references/usage.md b/skills/handycontrol-wpf-native-styles/references/usage.md
new file mode 100644
index 00000000..7d863ea1
--- /dev/null
+++ b/skills/handycontrol-wpf-native-styles/references/usage.md
@@ -0,0 +1,217 @@
+# 原生 WPF 控件样式
+
+这里处理 `System.Windows.Controls` 的原生类型。需要扩展控件功能时才选 `HandyControl.Controls` 下的类型。先按实际 CLR 类型选择样式，不能将一个同名扩展类型的样式套在原生类型上。
+
+```xml
+<StackPanel>
+    <Button Content="保存" Style="{StaticResource ButtonPrimary}"
+            Command="{Binding SaveCommand}"/>
+    <TextBox Margin="0,12,0,0" Style="{StaticResource TextBoxExtend}"
+             hc:InfoElement.Title="用户名" hc:InfoElement.Placeholder="请输入用户名"
+             Text="{Binding UserName, UpdateSourceTrigger=PropertyChanged}"/>
+</StackPanel>
+```
+
+片段依赖 App.xaml 的皮肤和主题字典、hc 命名空间，以及使用方 DataContext。原生 PasswordBox 不提供可直接按 TextBox 方式绑定的 Text 属性；需要密码绑定时按实际控件方案实现。
+
+附加属性来自 `Controls/Attach`：检查 InfoElement、TitleElement、BorderElement、IconElement 等的 Get/Set 方法和对应模板的使用位置。设置附加属性不代表任意模板都会展示它。
+
+下面的显式 Style 键从本仓库各原生控件样式源文件生成；不是所有键都适用于控件本身（例如某些键针对子元素），使用前在源文件核对 TargetType。隐式样式和 BasedOn 链不在本清单展开。
+
+## border
+
+[src/Shared/HandyControl_Shared/Themes/Styles/Border.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Border.xaml)
+
+显式样式键：`BorderRegion`、`BorderTipBaseStyle`、`BorderTipPrimary`、`BorderTipDanger`、`BorderTipWarning`、`BorderTipInfo`、`BorderTipSuccess`、`BorderVerticallySplitter`、`BorderHorizontallySplitter`、`BorderCircular`、`BorderClip`、`BorderCircularClip`
+
+## button
+
+[src/Shared/HandyControl_Shared/Themes/Styles/Button.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Button.xaml)
+
+显式样式键：`ButtonDefault`、`ButtonDefault.Small`、`ButtonPrimary`、`ButtonPrimary.Small`、`ButtonSuccess`、`ButtonSuccess.Small`、`ButtonInfo`、`ButtonInfo.Small`、`ButtonWarning`、`ButtonWarning.Small`、`ButtonDanger`、`ButtonDanger.Small`、`ButtonIcon`、`ButtonIcon.Small`、`ButtonIconCircular`、`ButtonIconCircular.Small`、`ButtonDashed`、`ButtonDashed.Small`、`ButtonDashedPrimary`、`ButtonDashedPrimary.Small`、`ButtonDashedSuccess`、`ButtonDashedSuccess.Small`、`ButtonDashedInfo`、`ButtonDashedInfo.Small`、`ButtonDashedWarning`、`ButtonDashedWarning.Small`、`ButtonDashedDanger`、`ButtonDashedDanger.Small`、`ButtonCustom`、`ButtonGroupItemDefault`、`ButtonGroupItemHorizontalFirst`、`ButtonGroupItemHorizontalLast`、`ButtonGroupItemSingle`、`ButtonGroupItemVerticalFirst`、`ButtonGroupItemVerticalLast`
+
+## calendar
+
+[src/Shared/HandyControl_Shared/Themes/Styles/Calendar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Calendar.xaml)
+
+显式样式键：`CalendarButtonStyle`、`CalendarDayButtonStyle`、`CalendarBaseStyle`
+
+## checkBox
+
+[src/Shared/HandyControl_Shared/Themes/Styles/CheckBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/CheckBox.xaml)
+
+显式样式键：
+
+## comboBox
+
+[src/Shared/HandyControl_Shared/Themes/Styles/ComboBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ComboBox.xaml)
+
+显式样式键：`ComboBoxItem.Small`、`ComboBox.Small`、`ComboBoxExtend`、`ComboBoxExtend.Small`、`ComboBoxPlus.Small`
+
+## contentControl
+
+[src/Shared/HandyControl_Shared/Themes/Styles/ContentControl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ContentControl.xaml)
+
+显式样式键：
+
+## contextMenu
+
+[src/Shared/HandyControl_Shared/Themes/Styles/ContextMenu.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ContextMenu.xaml)
+
+显式样式键：`ContextMenu.Small`
+
+## dataGrid
+
+[src/Shared/HandyControl_Shared/Themes/Styles/DataGrid.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/DataGrid.xaml)
+
+显式样式键：`DataGridBaseStyle`、`DataGridCellStyle.Small`、`DataGridRowStyle.Small`、`DataGridColumnHeaderStyle.Small`、`DataGrid.Small`
+
+## datePicker
+
+[src/Shared/HandyControl_Shared/Themes/Styles/DatePicker.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/DatePicker.xaml)
+
+显式样式键：`DatePicker.Small`、`DatePickerExtend`、`DatePickerExtend.Small`、`DatePickerPlus.Small`
+
+## expander
+
+[src/Shared/HandyControl_Shared/Themes/Styles/Expander.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Expander.xaml)
+
+显式样式键：`Expander.Small`
+
+## flowDocument
+
+[src/Shared/HandyControl_Shared/Themes/Styles/FlowDocument.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/FlowDocument.xaml)
+
+显式样式键：
+
+## frame
+
+[src/Shared/HandyControl_Shared/Themes/Styles/Frame.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Frame.xaml)
+
+显式样式键：
+
+## groupBox
+
+[src/Shared/HandyControl_Shared/Themes/Styles/GroupBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/GroupBox.xaml)
+
+显式样式键：`GroupBox.Small`、`GroupBoxOriginal`、`GroupBoxTab`、`GroupBoxTab.Small`
+
+## label
+
+[src/Shared/HandyControl_Shared/Themes/Styles/Label.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Label.xaml)
+
+显式样式键：`LabelDefault`、`LabelDefault.Small`、`LabelPrimary`、`LabelPrimary.Small`、`LabelSuccess`、`LabelSuccess.Small`、`LabelInfo`、`LabelInfo.Small`、`LabelWarning`、`LabelWarning.Small`、`LabelDanger`、`LabelDanger.Small`
+
+## listBox
+
+[src/Shared/HandyControl_Shared/Themes/Styles/ListBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ListBox.xaml)
+
+显式样式键：`ListBoxItemBaseStyle.Small`、`ListBox.Small`、`ListBoxItemCustom`、`ListBoxCustom`、`WrapPanelHorizontalListBox`、`WrapPanelVerticalListBox`、`StackPanelHorizontalListBox`、`StackPanelVerticalListBox`
+
+## listView
+
+[src/Shared/HandyControl_Shared/Themes/Styles/ListView.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ListView.xaml)
+
+显式样式键：`ListViewBaseStyle`、`ListViewItemBaseStyle.Small`、`ListView.Small`
+
+## menu
+
+[src/Shared/HandyControl_Shared/Themes/Styles/Menu.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Menu.xaml)
+
+显式样式键：`Menu.Small`
+
+## passwordBox
+
+[src/Shared/HandyControl_Shared/Themes/Styles/PasswordBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/PasswordBox.xaml)
+
+显式样式键：`PasswordBox.Small`、`PasswordBoxExtend`、`PasswordBoxExtend.Small`、`PasswordBoxPlus.Small`
+
+## progressBar
+
+[src/Shared/HandyControl_Shared/Themes/Styles/ProgressBar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ProgressBar.xaml)
+
+显式样式键：`ProgressBarSuccess`、`ProgressBarInfo`、`ProgressBarWarning`、`ProgressBarDanger`、`ProgressBarPrimaryStripe`、`ProgressBarSuccessStripe`、`ProgressBarInfoStripe`、`ProgressBarWarningStripe`、`ProgressBarDangerStripe`、`ProgressBarSuccessCircle`、`ProgressBarInfoCircle`、`ProgressBarWarningCircle`、`ProgressBarDangerCircle`、`ProgressBarSuccessWave`、`ProgressBarInfoWave`、`ProgressBarWarningWave`、`ProgressBarDangerWave`、`ProgressBarFlat`
+
+## radioButton
+
+[src/Shared/HandyControl_Shared/Themes/Styles/RadioButton.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/RadioButton.xaml)
+
+显式样式键：`RadioButtonSameAsButtonDefault`、`RadioButtonSameAsButtonDefault.Small`、`RadioButtonSameAsButtonPrimary`、`RadioButtonSameAsButtonPrimary.Small`、`RadioButtonSameAsButtonSuccess`、`RadioButtonSameAsButtonSuccess.Small`、`RadioButtonSameAsButtonInfo`、`RadioButtonSameAsButtonInfo.Small`、`RadioButtonSameAsButtonWarning`、`RadioButtonSameAsButtonWarning.Small`、`RadioButtonSameAsButtonDanger`、`RadioButtonSameAsButtonDanger.Small`、`RadioButtonIcon`、`RadioButtonIcon.Small`、`RadioGroupItemDefault`、`RadioGroupItemHorizontalFirst`、`RadioGroupItemHorizontalLast`、`RadioGroupItemSingle`、`RadioGroupItemVerticalFirst`、`RadioGroupItemVerticalLast`
+
+## richTextBox
+
+[src/Shared/HandyControl_Shared/Themes/Styles/RichTextBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/RichTextBox.xaml)
+
+显式样式键：`TextBoxBaseBaseStyle`、`RichTextBoxBaseStyle`
+
+## scrollViewer
+
+[src/Shared/HandyControl_Shared/Themes/Styles/ScrollViewer.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ScrollViewer.xaml)
+
+显式样式键：`ScrollViewerUpDownRepeatButtonStyle`、`ScrollViewerUpDown`
+
+## separator
+
+[src/Shared/HandyControl_Shared/Themes/Styles/Separator.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Separator.xaml)
+
+显式样式键：
+
+## slider
+
+[src/Shared/HandyControl_Shared/Themes/Styles/Slider.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Slider.xaml)
+
+显式样式键：
+
+## statusBar
+
+[src/Shared/HandyControl_Shared/Themes/Styles/StatusBar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/StatusBar.xaml)
+
+显式样式键：
+
+## tabControl
+
+[src/Shared/HandyControl_Shared/Themes/Styles/TabControl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TabControl.xaml)
+
+显式样式键：`TabItemSliding`、`TabControlSliding`、`TabItemInLine`、`TabControlInLine`、`TabItemCapsuleDefault`、`TabItemCapsuleHorizontalFirst`、`TabItemCapsuleHorizontalLast`、`TabItemCapsuleSingle`、`TabItemCapsuleVerticalFirst`、`TabItemCapsuleVerticalLast`、`TabControlCapsule`、`TabControlCapsuleSolid`
+
+## textBlock
+
+[src/Shared/HandyControl_Shared/Themes/Styles/TextBlock.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TextBlock.xaml)
+
+显式样式键：`TextBlockDefault`、`TextBlockDefaultAccent`、`TextBlockDefaultPrimary`、`TextBlockDefaultDanger`、`TextBlockDefaultWarning`、`TextBlockDefaultInfo`、`TextBlockDefaultSuccess`、`TextBlockDefaultSecLight`、`TextBlockDefaultThiLight`、`TextBlockLarge`、`TextBlockTitle`、`TextBlockSubTitle`、`TextBlockLargeBold`、`TextBlockTitleBold`、`TextBlockSubTitleBold`、`TextBlockDefaultBold`
+
+## textBox
+
+[src/Shared/HandyControl_Shared/Themes/Styles/TextBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TextBox.xaml)
+
+显式样式键：`TextBox.Small`、`TextBoxExtend`、`TextBoxExtend.Small`、`TextBoxPlus.Small`
+
+## toggleButton
+
+[src/Shared/HandyControl_Shared/Themes/Styles/ToggleButton.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ToggleButton.xaml)
+
+显式样式键：`ToggleButtonDefault`、`ToggleButtonDefault.Small`、`ToggleButtonPrimary`、`ToggleButtonPrimary.Small`、`ToggleButtonSuccess`、`ToggleButtonSuccess.Small`、`ToggleButtonInfo`、`ToggleButtonInfo.Small`、`ToggleButtonWarning`、`ToggleButtonWarning.Small`、`ToggleButtonDanger`、`ToggleButtonDanger.Small`、`ToggleButtonIcon`、`ToggleButtonIcon.Small`、`ToggleButtonIconPrimary`、`ToggleButtonIconPrimary.Small`、`ToggleButtonIconSuccess`、`ToggleButtonIconSuccess.Small`、`ToggleButtonIconInfo`、`ToggleButtonIconInfo.Small`、`ToggleButtonIconWarning`、`ToggleButtonIconWarning.Small`、`ToggleButtonIconDanger`、`ToggleButtonIconDanger.Small`、`ToggleButtonIconTransparent`、`ToggleButtonIconTransparent.Small`、`ToggleButtonSwitch`、`ToggleButtonSwitch.Small`、`ToggleButtonFlip`、`ToggleButtonFlip.Small`、`ToggleButtonCustom`、`ToggleButtonGroupItemDefault`、`ToggleButtonGroupItemHorizontalFirst`、`ToggleButtonGroupItemHorizontalLast`、`ToggleButtonGroupItemSingle`、`ToggleButtonGroupItemVerticalFirst`、`ToggleButtonGroupItemVerticalLast`、`ToggleButtonLoadingPrimary`、`ToggleButtonLoading`、`ToggleButtonLoadingSuccess`、`ToggleButtonLoadingInfo`、`ToggleButtonLoadingWarning`、`ToggleButtonLoadingDanger`
+
+## toolBar
+
+[src/Shared/HandyControl_Shared/Themes/Styles/ToolBar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ToolBar.xaml)
+
+显式样式键：
+
+## toolTip
+
+[src/Shared/HandyControl_Shared/Themes/Styles/ToolTip.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ToolTip.xaml)
+
+显式样式键：
+
+## treeView
+
+[src/Shared/HandyControl_Shared/Themes/Styles/TreeView.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TreeView.xaml)
+
+显式样式键：`TreeViewItemBaseStyle.Small`、`TreeView.Small`
+
+## window
+
+[src/Shared/HandyControl_Shared/Themes/Styles/Window.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Window.xaml)
+
+显式样式键：`WindowWin10`、`WindowBlur`、`WindowGlow`
diff --git a/skills/handycontrol-wpf-notification/SKILL.md b/skills/handycontrol-wpf-notification/SKILL.md
new file mode 100644
index 00000000..fdb66547
--- /dev/null
+++ b/skills/handycontrol-wpf-notification/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-notification
+description: "实现、配置或排查 HandyControl WPF 的 Notification 桌面通知（Notification）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Notification 桌面通知
+
+实现或排查 **Notification 桌面通知**。相关类型：`Notification`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-notification/agents/openai.yaml b/skills/handycontrol-wpf-notification/agents/openai.yaml
new file mode 100644
index 00000000..01990bc7
--- /dev/null
+++ b/skills/handycontrol-wpf-notification/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Notification 桌面通知"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-notification to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-notification/references/api.md b/skills/handycontrol-wpf-notification/references/api.md
new file mode 100644
index 00000000..7b21ef0b
--- /dev/null
+++ b/skills/handycontrol-wpf-notification/references/api.md
@@ -0,0 +1,13 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Notification
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/Notification.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Notification.cs)
+
+```text
+public sealed class Notification : System.Windows.Window
+public Notification()
+public static Notification Show(object content, ShowAnimation showAnimation = ShowAnimation.None, bool staysOpen = false)
+```
diff --git a/skills/handycontrol-wpf-notification/references/usage.md b/skills/handycontrol-wpf-notification/references/usage.md
new file mode 100644
index 00000000..a5664700
--- /dev/null
+++ b/skills/handycontrol-wpf-notification/references/usage.md
@@ -0,0 +1,17 @@
+# Notification 桌面通知 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/notification/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/notification/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/notification/)
+
+按任务阅读原文中的章节：方法、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/Notification.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Notification.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Notification.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Notification.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/NotificationDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/NotificationDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/NotificationDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/NotificationDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-notify-icon/SKILL.md b/skills/handycontrol-wpf-notify-icon/SKILL.md
new file mode 100644
index 00000000..9690cb39
--- /dev/null
+++ b/skills/handycontrol-wpf-notify-icon/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-notify-icon
+description: "实现、配置或排查 HandyControl WPF 的 NotifyIcon 托盘图标（NotifyIcon）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF NotifyIcon 托盘图标
+
+实现或排查 **NotifyIcon 托盘图标**。相关类型：`NotifyIcon`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-notify-icon/agents/openai.yaml b/skills/handycontrol-wpf-notify-icon/agents/openai.yaml
new file mode 100644
index 00000000..bd56e0de
--- /dev/null
+++ b/skills/handycontrol-wpf-notify-icon/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF NotifyIcon 托盘图标"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-notify-icon to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-notify-icon/references/api.md b/skills/handycontrol-wpf-notify-icon/references/api.md
new file mode 100644
index 00000000..4a4ac3cf
--- /dev/null
+++ b/skills/handycontrol-wpf-notify-icon/references/api.md
@@ -0,0 +1,26 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## NotifyIcon
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/NotifyIcon.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/NotifyIcon.cs)
+
+```text
+public class NotifyIcon : FrameworkElement, IDisposable
+public NotifyIcon()
+public void Init()
+public static void ShowBalloonTip(string title, string content, NotifyIconInfoType infoType, string token)
+public void ShowBalloonTip(string title, string content, NotifyIconInfoType infoType)
+public void Dispose()
+public void CloseContextControl()
+public string Token
+public string Text
+public ImageSource Icon
+public object ContextContent
+public TimeSpan BlinkInterval
+public bool IsBlink
+public event RoutedEventHandler Click
+public event RoutedEventHandler MouseDoubleClick
+public event RoutedEventHandler BalloonTipClick
+```
diff --git a/skills/handycontrol-wpf-notify-icon/references/usage.md b/skills/handycontrol-wpf-notify-icon/references/usage.md
new file mode 100644
index 00000000..df5dc8e5
--- /dev/null
+++ b/skills/handycontrol-wpf-notify-icon/references/usage.md
@@ -0,0 +1,16 @@
+# NotifyIcon 托盘图标 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/notifyIcon/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/notifyIcon/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/notifyIcon/)
+
+按任务阅读原文中的章节：属性、方法、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/NotifyIcon.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/NotifyIcon.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/NotifyIconDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/NotifyIconDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/NotifyIconDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/NotifyIconDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-numeric-up-down/SKILL.md b/skills/handycontrol-wpf-numeric-up-down/SKILL.md
new file mode 100644
index 00000000..2076f7ff
--- /dev/null
+++ b/skills/handycontrol-wpf-numeric-up-down/SKILL.md
@@ -0,0 +1,39 @@
+---
+name: handycontrol-wpf-numeric-up-down
+description: "实现、配置或排查 HandyControl WPF 的 NumericUpDown 数值选择控件（NumericUpDown）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF NumericUpDown 数值选择控件
+
+实现或排查 **NumericUpDown 数值选择控件**。相关类型：`NumericUpDown`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+Value 是 double；范围属性是 Minimum / Maximum，步长是 Increment，不能照搬 Syncfusion 的 MinValue / MaxValue / Step。DecimalPlaces 为 int?，仅控制显示。ValueChanged 的事件参数使用 FunctionEventArgs<double>，读取 Info；绑定时显式指定 Mode=TwoWay。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:NumericUpDown Minimum="0" Maximum="100" Increment="0.5"
+                  DecimalPlaces="2" Value="{Binding Amount, Mode=TwoWay}"/>
+```
diff --git a/skills/handycontrol-wpf-numeric-up-down/agents/openai.yaml b/skills/handycontrol-wpf-numeric-up-down/agents/openai.yaml
new file mode 100644
index 00000000..f9b44dfb
--- /dev/null
+++ b/skills/handycontrol-wpf-numeric-up-down/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF NumericUpDown 数值选择控件"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-numeric-up-down to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-numeric-up-down/references/api.md b/skills/handycontrol-wpf-numeric-up-down/references/api.md
new file mode 100644
index 00000000..56b53413
--- /dev/null
+++ b/skills/handycontrol-wpf-numeric-up-down/references/api.md
@@ -0,0 +1,26 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## NumericUpDown
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/NumericUpDown.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/NumericUpDown.cs)
+
+```text
+public class NumericUpDown : Control
+public NumericUpDown()
+public override void OnApplyTemplate()
+public event EventHandler<FunctionEventArgs<double>> ValueChanged
+public double Value
+public double Maximum
+public double Minimum
+public double Increment
+public int? DecimalPlaces
+public string ValueFormat
+public bool ShowUpDownButton
+public bool IsReadOnly
+public Brush SelectionBrush
+public Brush SelectionTextBrush
+public double SelectionOpacity
+public Brush CaretBrush
+```
diff --git a/skills/handycontrol-wpf-numeric-up-down/references/usage.md b/skills/handycontrol-wpf-numeric-up-down/references/usage.md
new file mode 100644
index 00000000..c866e5e2
--- /dev/null
+++ b/skills/handycontrol-wpf-numeric-up-down/references/usage.md
@@ -0,0 +1,17 @@
+# NumericUpDown 数值选择控件 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/numericUpDown/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/numericUpDown/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/numericUpDown/)
+
+按任务阅读原文中的章节：创建NumericUpDown并设置Value、设置DecimalPlaces、设置Increment、设置上限和下限、设置标题和占位符文本、属性、事件。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Input/NumericUpDown.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/NumericUpDown.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/NumericUpDown.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/NumericUpDown.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/NumericUpDownDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/NumericUpDownDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/NumericUpDownDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/NumericUpDownDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-outline-text/SKILL.md b/skills/handycontrol-wpf-outline-text/SKILL.md
new file mode 100644
index 00000000..b63b25bc
--- /dev/null
+++ b/skills/handycontrol-wpf-outline-text/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-outline-text
+description: "实现、配置或排查 HandyControl WPF 的 OutlineText 轮廓文本（OutlineText）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF OutlineText 轮廓文本
+
+实现或排查 **OutlineText 轮廓文本**。相关类型：`OutlineText`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-outline-text/agents/openai.yaml b/skills/handycontrol-wpf-outline-text/agents/openai.yaml
new file mode 100644
index 00000000..5c508c8c
--- /dev/null
+++ b/skills/handycontrol-wpf-outline-text/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF OutlineText 轮廓文本"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-outline-text to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-outline-text/references/api.md b/skills/handycontrol-wpf-outline-text/references/api.md
new file mode 100644
index 00000000..6075221a
--- /dev/null
+++ b/skills/handycontrol-wpf-outline-text/references/api.md
@@ -0,0 +1,24 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## OutlineText
+
+源码：[src/Shared/HandyControl_Shared/Controls/Text/OutlineText.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Text/OutlineText.cs)
+
+```text
+public class OutlineText : FrameworkElement
+public StrokePosition StrokePosition
+public string Text
+public TextAlignment TextAlignment
+public TextTrimming TextTrimming
+public TextWrapping TextWrapping
+public Brush Fill
+public Brush Stroke
+public double StrokeThickness
+public FontFamily FontFamily
+public double FontSize
+public FontStretch FontStretch
+public FontStyle FontStyle
+public FontWeight FontWeight
+```
diff --git a/skills/handycontrol-wpf-outline-text/references/usage.md b/skills/handycontrol-wpf-outline-text/references/usage.md
new file mode 100644
index 00000000..0aafe069
--- /dev/null
+++ b/skills/handycontrol-wpf-outline-text/references/usage.md
@@ -0,0 +1,16 @@
+# OutlineText 轮廓文本 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/outlineText/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/outlineText/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/outlineText/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Text/OutlineText.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Text/OutlineText.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/OutlineTextDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/OutlineTextDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/OutlineTextDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/OutlineTextDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-pagination/SKILL.md b/skills/handycontrol-wpf-pagination/SKILL.md
new file mode 100644
index 00000000..134cfe4e
--- /dev/null
+++ b/skills/handycontrol-wpf-pagination/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-pagination
+description: "实现、配置或排查 HandyControl WPF 的 Pagination 页码条（Pagination）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Pagination 页码条
+
+实现或排查 **Pagination 页码条**。相关类型：`Pagination`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+绑定页码与数据加载逻辑时检查页码基准、总数变化及边界，事件参数以源码声明为准。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:Pagination MaxPageCount="10" PageIndex="5" IsJumpEnabled="True"/>
+```
diff --git a/skills/handycontrol-wpf-pagination/agents/openai.yaml b/skills/handycontrol-wpf-pagination/agents/openai.yaml
new file mode 100644
index 00000000..e6d4a132
--- /dev/null
+++ b/skills/handycontrol-wpf-pagination/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Pagination 页码条"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-pagination to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-pagination/references/api.md b/skills/handycontrol-wpf-pagination/references/api.md
new file mode 100644
index 00000000..b78c7ac6
--- /dev/null
+++ b/skills/handycontrol-wpf-pagination/references/api.md
@@ -0,0 +1,21 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Pagination
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/Pagination.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Pagination.cs)
+
+```text
+public class Pagination : Control
+public event EventHandler<FunctionEventArgs<int>> PageUpdated
+public Pagination()
+public int MaxPageCount
+public int DataCountPerPage
+public int PageIndex
+public int MaxPageInterval
+public bool IsJumpEnabled
+public bool AutoHiding
+public Style PaginationButtonStyle
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-pagination/references/usage.md b/skills/handycontrol-wpf-pagination/references/usage.md
new file mode 100644
index 00000000..663a78ef
--- /dev/null
+++ b/skills/handycontrol-wpf-pagination/references/usage.md
@@ -0,0 +1,17 @@
+# Pagination 页码条 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/pagination/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/pagination/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/pagination/)
+
+按任务阅读原文中的章节：属性、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/Pagination.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Pagination.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Pagination.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Pagination.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PaginationDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PaginationDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PaginationDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PaginationDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-password-box/SKILL.md b/skills/handycontrol-wpf-password-box/SKILL.md
new file mode 100644
index 00000000..a1b0e448
--- /dev/null
+++ b/skills/handycontrol-wpf-password-box/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-password-box
+description: "实现、配置或排查 HandyControl WPF 的 PasswordBox 密码框（PasswordBox）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF PasswordBox 密码框
+
+实现或排查 **PasswordBox 密码框**。相关类型：`PasswordBox`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+区分 HandyControl.Controls.PasswordBox 与原生 System.Windows.Controls.PasswordBox；核对 Password 的属性定义和绑定机制，不在日志中输出密码。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:PasswordBox />
+```
diff --git a/skills/handycontrol-wpf-password-box/agents/openai.yaml b/skills/handycontrol-wpf-password-box/agents/openai.yaml
new file mode 100644
index 00000000..6d1f288f
--- /dev/null
+++ b/skills/handycontrol-wpf-password-box/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF PasswordBox 密码框"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-password-box to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-password-box/references/api.md b/skills/handycontrol-wpf-password-box/references/api.md
new file mode 100644
index 00000000..45294336
--- /dev/null
+++ b/skills/handycontrol-wpf-password-box/references/api.md
@@ -0,0 +1,30 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## PasswordBox
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/PasswordBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/PasswordBox.cs)
+
+```text
+public class PasswordBox : Control
+public char PasswordChar
+public bool ShowEyeButton
+public bool ShowPassword
+public bool IsSafeEnabled
+public string UnsafePassword
+public int MaxLength
+public Brush SelectionBrush
+public Brush SelectionTextBrush
+public double SelectionOpacity
+public Brush CaretBrush
+public bool IsSelectionActive
+public PasswordBox()
+public System.Windows.Controls.PasswordBox ActualPasswordBox
+public string Password
+public SecureString SecurePassword
+public override void OnApplyTemplate()
+public void Paste()
+public void SelectAll()
+public void Clear()
+```
diff --git a/skills/handycontrol-wpf-password-box/references/usage.md b/skills/handycontrol-wpf-password-box/references/usage.md
new file mode 100644
index 00000000..1b4eccaf
--- /dev/null
+++ b/skills/handycontrol-wpf-password-box/references/usage.md
@@ -0,0 +1,17 @@
+# PasswordBox 密码框 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/passwordBox/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/passwordBox/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/passwordBox/)
+
+按任务阅读原文中的章节：创建PasswordBox、输入密码、显示密码、设置标题和占位符文本、属性、方法。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Input/PasswordBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/PasswordBox.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/PasswordBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/PasswordBox.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PasswordBoxDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PasswordBoxDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PasswordBoxDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PasswordBoxDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-pin-box/SKILL.md b/skills/handycontrol-wpf-pin-box/SKILL.md
new file mode 100644
index 00000000..7daa5921
--- /dev/null
+++ b/skills/handycontrol-wpf-pin-box/SKILL.md
@@ -0,0 +1,41 @@
+---
+name: handycontrol-wpf-pin-box
+description: "实现、配置或排查 HandyControl WPF 的 PinBox PIN码框（PinBox）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF PinBox PIN码框
+
+实现或排查 **PinBox PIN码框**。相关类型：`PinBox`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<StackPanel Margin="32" VerticalAlignment="Center" hc:PinBox.Completed="PinBox_OnCompleted">
+    <hc:PinBox Length="4" Password="1234"/>
+    <hc:PinBox Length="6" Password="123456" Margin="0,16,0,0" PasswordChar="❤"/>
+</StackPanel>
+```
diff --git a/skills/handycontrol-wpf-pin-box/agents/openai.yaml b/skills/handycontrol-wpf-pin-box/agents/openai.yaml
new file mode 100644
index 00000000..74d698e1
--- /dev/null
+++ b/skills/handycontrol-wpf-pin-box/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF PinBox PIN码框"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-pin-box to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-pin-box/references/api.md b/skills/handycontrol-wpf-pin-box/references/api.md
new file mode 100644
index 00000000..a611e6be
--- /dev/null
+++ b/skills/handycontrol-wpf-pin-box/references/api.md
@@ -0,0 +1,26 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## PinBox
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/PinBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/PinBox.cs)
+
+```text
+public class PinBox : Control
+public PinBox()
+public string Password
+public char PasswordChar
+public int Length
+public Thickness ItemMargin
+public double ItemWidth
+public double ItemHeight
+public Brush SelectionBrush
+public Brush SelectionTextBrush
+public double SelectionOpacity
+public Brush CaretBrush
+public bool IsSafeEnabled
+public string UnsafePassword
+public event RoutedEventHandler Completed
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-pin-box/references/usage.md b/skills/handycontrol-wpf-pin-box/references/usage.md
new file mode 100644
index 00000000..94c9cec3
--- /dev/null
+++ b/skills/handycontrol-wpf-pin-box/references/usage.md
@@ -0,0 +1,17 @@
+# PinBox PIN码框 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/pinBox/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/pinBox/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/pinBox/)
+
+按任务阅读原文中的章节：属性、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Input/PinBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/PinBox.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/PinBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/PinBox.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PinBoxDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PinBoxDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PinBoxDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PinBoxDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-pop-tip/SKILL.md b/skills/handycontrol-wpf-pop-tip/SKILL.md
new file mode 100644
index 00000000..4c9405b5
--- /dev/null
+++ b/skills/handycontrol-wpf-pop-tip/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-pop-tip
+description: "实现、配置或排查 HandyControl WPF 的 PopTip 气泡提示（Poptip）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF PopTip 气泡提示
+
+实现或排查 **PopTip 气泡提示**。相关类型：`Poptip`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-pop-tip/agents/openai.yaml b/skills/handycontrol-wpf-pop-tip/agents/openai.yaml
new file mode 100644
index 00000000..14756dd7
--- /dev/null
+++ b/skills/handycontrol-wpf-pop-tip/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF PopTip 气泡提示"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-pop-tip to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-pop-tip/references/api.md b/skills/handycontrol-wpf-pop-tip/references/api.md
new file mode 100644
index 00000000..c19c6e29
--- /dev/null
+++ b/skills/handycontrol-wpf-pop-tip/references/api.md
@@ -0,0 +1,48 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Poptip
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/Poptip.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Poptip.cs)
+
+```text
+public class Poptip : AdornerElement
+public Poptip()
+public static void SetHitMode(DependencyObject element, HitMode value)
+public static HitMode GetHitMode(DependencyObject element)
+public HitMode HitMode
+public static void SetContent(DependencyObject element, object value)
+public static object GetContent(DependencyObject element)
+public object Content
+public DataTemplate ContentTemplate
+public string ContentStringFormat
+public DataTemplateSelector ContentTemplateSelector
+public static void SetVerticalOffset(DependencyObject element, double value)
+public static double GetVerticalOffset(DependencyObject element)
+public double VerticalOffset
+public static void SetHorizontalOffset(DependencyObject element, double value)
+public static double GetHorizontalOffset(DependencyObject element)
+public double HorizontalOffset
+public static void SetPlacement(DependencyObject element, PlacementType value)
+public static PlacementType GetPlacement(DependencyObject element)
+public PlacementType PlacementType
+public static void SetIsOpen(DependencyObject element, bool value)
+public static bool GetIsOpen(DependencyObject element)
+public bool IsOpen
+public double Delay
+public static Poptip Default
+```
+
+## AdornerElement
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/AdornerElement.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/AdornerElement.cs)
+
+```text
+public abstract class AdornerElement : Control, IDisposable
+public FrameworkElement Target
+public static void SetInstance(DependencyObject element, AdornerElement value)
+public static AdornerElement GetInstance(DependencyObject element)
+public static void SetIsInstance(DependencyObject element, bool value)
+public static bool GetIsInstance(DependencyObject element)
+```
diff --git a/skills/handycontrol-wpf-pop-tip/references/usage.md b/skills/handycontrol-wpf-pop-tip/references/usage.md
new file mode 100644
index 00000000..047d0b14
--- /dev/null
+++ b/skills/handycontrol-wpf-pop-tip/references/usage.md
@@ -0,0 +1,17 @@
+# PopTip 气泡提示 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/popTip/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/popTip/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/popTip/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/Poptip.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Poptip.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Poptip.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Poptip.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PoptipDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PoptipDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PoptipDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PoptipDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-popup-window/SKILL.md b/skills/handycontrol-wpf-popup-window/SKILL.md
new file mode 100644
index 00000000..878c93bf
--- /dev/null
+++ b/skills/handycontrol-wpf-popup-window/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-popup-window
+description: "实现、配置或排查 HandyControl WPF 的 PopupWindow 弹出窗口（PopupWindow）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF PopupWindow 弹出窗口
+
+实现或排查 **PopupWindow 弹出窗口**。相关类型：`PopupWindow`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-popup-window/agents/openai.yaml b/skills/handycontrol-wpf-popup-window/agents/openai.yaml
new file mode 100644
index 00000000..522d606a
--- /dev/null
+++ b/skills/handycontrol-wpf-popup-window/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF PopupWindow 弹出窗口"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-popup-window to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-popup-window/references/api.md b/skills/handycontrol-wpf-popup-window/references/api.md
new file mode 100644
index 00000000..f01455d3
--- /dev/null
+++ b/skills/handycontrol-wpf-popup-window/references/api.md
@@ -0,0 +1,24 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## PopupWindow
+
+源码：[src/Shared/HandyControl_Shared/Controls/Window/PopupWindow.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/PopupWindow.cs)
+
+```text
+public class PopupWindow : System.Windows.Window
+public override void OnApplyTemplate()
+public string ContentStr
+public PopupWindow()
+public PopupWindow(System.Windows.Window owner) : this()
+public FrameworkElement PopupElement
+public bool ShowTitle
+public bool ShowCancel
+public bool ShowBorder
+public void Show(FrameworkElement element, bool showBackground = true)
+public void ShowDialog(FrameworkElement element, bool showBackground = true)
+public void Show(System.Windows.Window element, Point point)
+public static void Show(string message)
+public static bool? ShowDialog(string message, string title = default, bool showCancel = false)
+```
diff --git a/skills/handycontrol-wpf-popup-window/references/usage.md b/skills/handycontrol-wpf-popup-window/references/usage.md
new file mode 100644
index 00000000..98c36c69
--- /dev/null
+++ b/skills/handycontrol-wpf-popup-window/references/usage.md
@@ -0,0 +1,15 @@
+# PopupWindow 弹出窗口 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/popupWindow/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/popupWindow/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/popupWindow/)
+
+按任务阅读原文中的章节：属性、方法。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Window/PopupWindow.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/PopupWindow.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/PopupWindow.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/PopupWindow.xaml)
diff --git a/skills/handycontrol-wpf-preview-slider/SKILL.md b/skills/handycontrol-wpf-preview-slider/SKILL.md
new file mode 100644
index 00000000..c286a2fe
--- /dev/null
+++ b/skills/handycontrol-wpf-preview-slider/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-preview-slider
+description: "实现、配置或排查 HandyControl WPF 的 PreviewSlider 预览滑块（PreviewSlider）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF PreviewSlider 预览滑块
+
+实现或排查 **PreviewSlider 预览滑块**。相关类型：`PreviewSlider`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-preview-slider/agents/openai.yaml b/skills/handycontrol-wpf-preview-slider/agents/openai.yaml
new file mode 100644
index 00000000..563443ef
--- /dev/null
+++ b/skills/handycontrol-wpf-preview-slider/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF PreviewSlider 预览滑块"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-preview-slider to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-preview-slider/references/api.md b/skills/handycontrol-wpf-preview-slider/references/api.md
new file mode 100644
index 00000000..7f67e7b0
--- /dev/null
+++ b/skills/handycontrol-wpf-preview-slider/references/api.md
@@ -0,0 +1,18 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## PreviewSlider
+
+源码：[src/Shared/HandyControl_Shared/Controls/Slider/PreviewSlider.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Slider/PreviewSlider.cs)
+
+```text
+public class PreviewSlider : Slider
+public object PreviewContent
+public double PreviewContentOffset
+public static void SetPreviewPosition(DependencyObject element, double value)
+public static double GetPreviewPosition(DependencyObject element)
+public double PreviewPosition
+public event EventHandler<FunctionEventArgs<double>> PreviewPositionChanged
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-preview-slider/references/usage.md b/skills/handycontrol-wpf-preview-slider/references/usage.md
new file mode 100644
index 00000000..353d6e5d
--- /dev/null
+++ b/skills/handycontrol-wpf-preview-slider/references/usage.md
@@ -0,0 +1,16 @@
+# PreviewSlider 预览滑块 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/previewSlider/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/previewSlider/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/previewSlider/)
+
+按任务阅读原文中的章节：属性、附加属性、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Slider/PreviewSlider.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Slider/PreviewSlider.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PreviewSliderDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PreviewSliderDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PreviewSliderDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PreviewSliderDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-progress-button/SKILL.md b/skills/handycontrol-wpf-progress-button/SKILL.md
new file mode 100644
index 00000000..f03b5fe1
--- /dev/null
+++ b/skills/handycontrol-wpf-progress-button/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-progress-button
+description: "实现、配置或排查 HandyControl WPF 的 ProgressButton 进度按钮（ProgressButton）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ProgressButton 进度按钮
+
+实现或排查 **ProgressButton 进度按钮**。相关类型：`ProgressButton`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-progress-button/agents/openai.yaml b/skills/handycontrol-wpf-progress-button/agents/openai.yaml
new file mode 100644
index 00000000..67efb255
--- /dev/null
+++ b/skills/handycontrol-wpf-progress-button/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ProgressButton 进度按钮"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-progress-button to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-progress-button/references/api.md b/skills/handycontrol-wpf-progress-button/references/api.md
new file mode 100644
index 00000000..705333dc
--- /dev/null
+++ b/skills/handycontrol-wpf-progress-button/references/api.md
@@ -0,0 +1,13 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ProgressButton
+
+源码：[src/Shared/HandyControl_Shared/Controls/Button/ProgressButton.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Button/ProgressButton.cs)
+
+```text
+public class ProgressButton : ToggleButton
+public Style ProgressStyle
+public double Progress
+```
diff --git a/skills/handycontrol-wpf-progress-button/references/usage.md b/skills/handycontrol-wpf-progress-button/references/usage.md
new file mode 100644
index 00000000..8ca87a90
--- /dev/null
+++ b/skills/handycontrol-wpf-progress-button/references/usage.md
@@ -0,0 +1,17 @@
+# ProgressButton 进度按钮 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/progressButton/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/progressButton/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/progressButton/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Button/ProgressButton.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Button/ProgressButton.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/ProgressButton.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ProgressButton.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ProgressButtonDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ProgressButtonDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ProgressButtonDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ProgressButtonDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-property-grid/SKILL.md b/skills/handycontrol-wpf-property-grid/SKILL.md
new file mode 100644
index 00000000..30018d52
--- /dev/null
+++ b/skills/handycontrol-wpf-property-grid/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-property-grid
+description: "实现、配置或排查 HandyControl WPF 的 PropertyGrid 属性编辑器（PropertyGrid, PlainTextPropertyEditor）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF PropertyGrid 属性编辑器
+
+实现或排查 **PropertyGrid 属性编辑器**。相关类型：`PropertyGrid`, `PlainTextPropertyEditor`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+先确认 SelectedObject 的实际类型及属性可读写性，再选择编辑器；自定义编辑器需要实现库内 PropertyEditorBase 约定。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-property-grid/agents/openai.yaml b/skills/handycontrol-wpf-property-grid/agents/openai.yaml
new file mode 100644
index 00000000..fadd387b
--- /dev/null
+++ b/skills/handycontrol-wpf-property-grid/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF PropertyGrid 属性编辑器"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-property-grid to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-property-grid/references/api.md b/skills/handycontrol-wpf-property-grid/references/api.md
new file mode 100644
index 00000000..026fe343
--- /dev/null
+++ b/skills/handycontrol-wpf-property-grid/references/api.md
@@ -0,0 +1,50 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## PropertyGrid
+
+源码：[src/Shared/HandyControl_Shared/Controls/PropertyGrid/PropertyGrid.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/PropertyGrid/PropertyGrid.cs)
+
+```text
+public class PropertyGrid : Control
+public PropertyGrid()
+public virtual PropertyResolver PropertyResolver
+public event RoutedPropertyChangedEventHandler<object> SelectedObjectChanged
+public object SelectedObject
+public string Description
+public double MaxTitleWidth
+public double MinTitleWidth
+public bool ShowSortButton
+public override void OnApplyTemplate()
+```
+
+## PlainTextPropertyEditor
+
+源码：[src/Shared/HandyControl_Shared/Controls/PropertyGrid/Editors/PlainTextPropertyEditor.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/PropertyGrid/Editors/PlainTextPropertyEditor.cs)
+
+```text
+public class PlainTextPropertyEditor : PropertyEditorBase
+public override FrameworkElement CreateElement(PropertyItem propertyItem)
+```
+
+## PropertyEditorBase
+
+源码：[src/Shared/HandyControl_Shared/Controls/PropertyGrid/Editors/PropertyEditorBase.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/PropertyGrid/Editors/PropertyEditorBase.cs)
+
+```text
+public abstract class PropertyEditorBase : DependencyObject
+public abstract FrameworkElement CreateElement(PropertyItem propertyItem);
+public virtual void CreateBinding(PropertyItem propertyItem, DependencyObject element)
+public virtual BindingMode GetBindingMode(PropertyItem propertyItem)
+public virtual UpdateSourceTrigger GetUpdateSourceTrigger(PropertyItem propertyItem)
+```
+
+## PlainTextPropertyEditor
+
+源码：[src/Shared/HandyControl_Shared/Controls/PropertyGrid/Editors/StringPropertyEditor.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/PropertyGrid/Editors/StringPropertyEditor.cs)
+
+```text
+public class PlainTextPropertyEditor : PropertyEditorBase
+public override FrameworkElement CreateElement(PropertyItem propertyItem)
+```
diff --git a/skills/handycontrol-wpf-property-grid/references/usage.md b/skills/handycontrol-wpf-property-grid/references/usage.md
new file mode 100644
index 00000000..87250bdd
--- /dev/null
+++ b/skills/handycontrol-wpf-property-grid/references/usage.md
@@ -0,0 +1,19 @@
+# PropertyGrid 属性编辑器 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/propertyGrid/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/propertyGrid/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/propertyGrid/)
+
+按任务阅读原文中的章节：属性、自带编辑器、事件、案例、基础用法、自定义编辑器。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/PropertyGrid/PropertyGrid.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/PropertyGrid/PropertyGrid.cs)
+- [src/Shared/HandyControl_Shared/Controls/PropertyGrid/Editors/PlainTextPropertyEditor.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/PropertyGrid/Editors/PlainTextPropertyEditor.cs)
+- [src/Shared/HandyControl_Shared/Controls/PropertyGrid/Editors/StringPropertyEditor.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/PropertyGrid/Editors/StringPropertyEditor.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/PropertyGrid.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/PropertyGrid.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PropertyGridDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PropertyGridDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/PropertyGridDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/PropertyGridDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-range-slider/SKILL.md b/skills/handycontrol-wpf-range-slider/SKILL.md
new file mode 100644
index 00000000..dd4290d5
--- /dev/null
+++ b/skills/handycontrol-wpf-range-slider/SKILL.md
@@ -0,0 +1,51 @@
+---
+name: handycontrol-wpf-range-slider
+description: "实现、配置或排查 HandyControl WPF 的 RangeSlider 范围滑块（TwoWayRangeBase, RangeSlider）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF RangeSlider 范围滑块
+
+实现或排查 **RangeSlider 范围滑块**。相关类型：`TwoWayRangeBase`, `RangeSlider`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<StackPanel Margin="32" Orientation="Horizontal">
+    <StackPanel>
+        <hc:RangeSlider Width="400" IsSnapToTickEnabled="True" ValueStart="2" ValueEnd="8"/>
+        <hc:RangeSlider Width="400" IsSnapToTickEnabled="True" ValueEnd="3" Margin="0,32,0,0" IsEnabled="False"/>
+        <hc:RangeSlider Width="400" hc:TipElement.Visibility="Visible" hc:TipElement.Placement="Top" IsSnapToTickEnabled="True" Maximum="100" ValueEnd="60" TickFrequency="10" TickPlacement="BottomRight" Margin="0,32,0,0"/>
+        <hc:RangeSlider Width="400" hc:TipElement.Visibility="Visible" hc:TipElement.Placement="Bottom" hc:TipElement.StringFormat="#0.00" ValueEnd="5" TickPlacement="Both" Margin="0,32,0,0"/>
+    </StackPanel>
+    <StackPanel Margin="32,0,0,0" Orientation="Horizontal">
+        <hc:RangeSlider Height="400" IsSnapToTickEnabled="True" ValueEnd="8" Orientation="Vertical"/>
+        <hc:RangeSlider Height="400" IsSnapToTickEnabled="True" ValueEnd="3" Margin="32,0,0,0" IsEnabled="False" Orientation="Vertical"/>
+        <hc:RangeSlider Height="400" hc:TipElement.Visibility="Visible" hc:TipElement.Placement="Left" IsSnapToTickEnabled="True" Maximum="100" ValueEnd="60" TickFrequency="10" TickPlacement="BottomRight" Margin="32,0,0,0" Orientation="Vertical"/>
+        <hc:RangeSlider Height="400" hc:TipElement.Visibility="Visible" hc:TipElement.Placement="Right" hc:TipElement.StringFormat="#0.00" ValueEnd="5" TickPlacement="Both" Margin="32,0" Orientation="Vertical"/>
+    </StackPanel>
+</StackPanel>
+```
diff --git a/skills/handycontrol-wpf-range-slider/agents/openai.yaml b/skills/handycontrol-wpf-range-slider/agents/openai.yaml
new file mode 100644
index 00000000..2a9b6c40
--- /dev/null
+++ b/skills/handycontrol-wpf-range-slider/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF RangeSlider 范围滑块"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-range-slider to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-range-slider/references/api.md b/skills/handycontrol-wpf-range-slider/references/api.md
new file mode 100644
index 00000000..96ed69f5
--- /dev/null
+++ b/skills/handycontrol-wpf-range-slider/references/api.md
@@ -0,0 +1,45 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## TwoWayRangeBase
+
+源码：[src/Shared/HandyControl_Shared/Controls/Slider/RangeSlider/TwoWayRangeBase.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Slider/RangeSlider/TwoWayRangeBase.cs)
+
+```text
+public class TwoWayRangeBase : Control
+public double Minimum
+public double Maximum
+public double ValueStart
+public double ValueEnd
+public double LargeChange
+public double SmallChange
+public event RoutedPropertyChangedEventHandler<DoubleRange> ValueChanged
+```
+
+## RangeSlider
+
+源码：[src/Shared/HandyControl_Shared/Controls/Slider/RangeSlider/RangeSlider.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Slider/RangeSlider/RangeSlider.cs)
+
+```text
+public class RangeSlider : TwoWayRangeBase
+public RangeSlider()
+public static RoutedCommand IncreaseLarge
+public static RoutedCommand IncreaseSmall
+public static RoutedCommand DecreaseLarge
+public static RoutedCommand DecreaseSmall
+public static RoutedCommand CenterLarge
+public static RoutedCommand CenterSmall
+public override void OnApplyTemplate()
+public Orientation Orientation
+public bool IsDirectionReversed
+public int Delay
+public int Interval
+public AutoToolTipPlacement AutoToolTipPlacement
+public int AutoToolTipPrecision
+public bool IsSnapToTickEnabled
+public TickPlacement TickPlacement
+public double TickFrequency
+public DoubleCollection Ticks
+public bool IsMoveToPointEnabled
+```
diff --git a/skills/handycontrol-wpf-range-slider/references/usage.md b/skills/handycontrol-wpf-range-slider/references/usage.md
new file mode 100644
index 00000000..6cc2fe26
--- /dev/null
+++ b/skills/handycontrol-wpf-range-slider/references/usage.md
@@ -0,0 +1,17 @@
+# RangeSlider 范围滑块 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/rangeSlider/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/rangeSlider/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/rangeSlider/)
+
+按任务阅读原文中的章节：属性、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Slider/RangeSlider/TwoWayRangeBase.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Slider/RangeSlider/TwoWayRangeBase.cs)
+- [src/Shared/HandyControl_Shared/Controls/Slider/RangeSlider/RangeSlider.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Slider/RangeSlider/RangeSlider.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/RangeSliderDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/RangeSliderDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/RangeSliderDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/RangeSliderDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-rate/SKILL.md b/skills/handycontrol-wpf-rate/SKILL.md
new file mode 100644
index 00000000..a1bc0298
--- /dev/null
+++ b/skills/handycontrol-wpf-rate/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-rate
+description: "实现、配置或排查 HandyControl WPF 的 Rate 评分（SimpleItemsControl, RegularItemsControl, Rate）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Rate 评分
+
+实现或排查 **Rate 评分**。相关类型：`SimpleItemsControl`, `RegularItemsControl`, `Rate`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-rate/agents/openai.yaml b/skills/handycontrol-wpf-rate/agents/openai.yaml
new file mode 100644
index 00000000..4784fc48
--- /dev/null
+++ b/skills/handycontrol-wpf-rate/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Rate 评分"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-rate to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-rate/references/api.md b/skills/handycontrol-wpf-rate/references/api.md
new file mode 100644
index 00000000..b31b2214
--- /dev/null
+++ b/skills/handycontrol-wpf-rate/references/api.md
@@ -0,0 +1,50 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## SimpleItemsControl
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs)
+
+```text
+public class SimpleItemsControl : Control
+public SimpleItemsControl()
+public IEnumerable ItemsSource
+public Style ItemContainerStyle
+public DataTemplate ItemTemplate
+public Collection<object> Items
+public override void OnApplyTemplate()
+public bool HasItems
+```
+
+## RegularItemsControl
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/RegularItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/RegularItemsControl.cs)
+
+```text
+public class RegularItemsControl : SimpleItemsControl
+public double ItemWidth
+public double ItemHeight
+public Thickness ItemMargin
+```
+
+## Rate
+
+源码：[src/Shared/HandyControl_Shared/Controls/Rate/Rate.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Rate/Rate.cs)
+
+```text
+public class Rate : RegularItemsControl
+public event EventHandler<FunctionEventArgs<double>> ValueChanged
+public Rate()
+public bool AllowHalf
+public bool AllowClear
+public Geometry Icon
+public int Count
+public double DefaultValue
+public double Value
+public string Text
+public bool ShowText
+public bool IsReadOnly
+public override void OnApplyTemplate()
+public void Reset()
+```
diff --git a/skills/handycontrol-wpf-rate/references/usage.md b/skills/handycontrol-wpf-rate/references/usage.md
new file mode 100644
index 00000000..d4c06a55
--- /dev/null
+++ b/skills/handycontrol-wpf-rate/references/usage.md
@@ -0,0 +1,20 @@
+# Rate 评分 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/rate/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/rate/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/rate/)
+
+按任务阅读原文中的章节：属性、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs)
+- [src/Shared/HandyControl_Shared/Controls/Base/RegularItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/RegularItemsControl.cs)
+- [src/Shared/HandyControl_Shared/Controls/Rate/Rate.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Rate/Rate.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Rate.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Rate.xaml)
+- [src/Shared/HandyControl_Shared/Themes/Styles/SimpleItemsControl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/SimpleItemsControl.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/RateDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/RateDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/RateDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/RateDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-relative-panel/SKILL.md b/skills/handycontrol-wpf-relative-panel/SKILL.md
new file mode 100644
index 00000000..015df115
--- /dev/null
+++ b/skills/handycontrol-wpf-relative-panel/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-relative-panel
+description: "实现、配置或排查 HandyControl WPF 的 RelativePanel 相对布局（RelativePanel）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF RelativePanel 相对布局
+
+实现或排查 **RelativePanel 相对布局**。相关类型：`RelativePanel`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-relative-panel/agents/openai.yaml b/skills/handycontrol-wpf-relative-panel/agents/openai.yaml
new file mode 100644
index 00000000..974f8c85
--- /dev/null
+++ b/skills/handycontrol-wpf-relative-panel/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF RelativePanel 相对布局"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-relative-panel to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-relative-panel/references/api.md b/skills/handycontrol-wpf-relative-panel/references/api.md
new file mode 100644
index 00000000..14a897a3
--- /dev/null
+++ b/skills/handycontrol-wpf-relative-panel/references/api.md
@@ -0,0 +1,74 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## RelativePanel
+
+源码：[src/Shared/HandyControl_Shared/Controls/Panel/RelativePanel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/RelativePanel.cs)
+
+```text
+public class RelativePanel : Panel
+public RelativePanel()
+public static void SetAlignLeftWithPanel(DependencyObject element, bool value)
+public static bool GetAlignLeftWithPanel(DependencyObject element)
+public static void SetAlignTopWithPanel(DependencyObject element, bool value)
+public static bool GetAlignTopWithPanel(DependencyObject element)
+public static void SetAlignRightWithPanel(DependencyObject element, bool value)
+public static bool GetAlignRightWithPanel(DependencyObject element)
+public static void SetAlignBottomWithPanel(DependencyObject element, bool value)
+public static bool GetAlignBottomWithPanel(DependencyObject element)
+public static void SetAlignLeftWith(DependencyObject element, UIElement value)
+public static UIElement GetAlignLeftWith(DependencyObject element)
+public static void SetAlignTopWith(DependencyObject element, UIElement value)
+public static UIElement GetAlignTopWith(DependencyObject element)
+public static void SetAlignRightWith(DependencyObject element, UIElement value)
+public static UIElement GetAlignRightWith(DependencyObject element)
+public static void SetAlignBottomWith(DependencyObject element, UIElement value)
+public static UIElement GetAlignBottomWith(DependencyObject element)
+public static void SetLeftOf(DependencyObject element, UIElement value)
+public static UIElement GetLeftOf(DependencyObject element)
+public static void SetAbove(DependencyObject element, UIElement value)
+public static UIElement GetAbove(DependencyObject element)
+public static void SetRightOf(DependencyObject element, UIElement value)
+public static UIElement GetRightOf(DependencyObject element)
+public static void SetBelow(DependencyObject element, UIElement value)
+public static UIElement GetBelow(DependencyObject element)
+public static void SetAlignHorizontalCenterWithPanel(DependencyObject element, bool value)
+public static bool GetAlignHorizontalCenterWithPanel(DependencyObject element)
+public static void SetAlignVerticalCenterWithPanel(DependencyObject element, bool value)
+public static bool GetAlignVerticalCenterWithPanel(DependencyObject element)
+public static void SetAlignHorizontalCenterWith(DependencyObject element, UIElement value)
+public static UIElement GetAlignHorizontalCenterWith(DependencyObject element)
+public static void SetAlignVerticalCenterWith(DependencyObject element, UIElement value)
+public static UIElement GetAlignVerticalCenterWith(DependencyObject element)
+public bool Measured
+public UIElement Element
+public Size OriginDesiredSize
+public double Left
+public double Top
+public double Right
+public double Bottom
+public HashSet<GraphNode> OutgoingNodes
+public GraphNode AlignLeftWithNode
+public GraphNode AlignTopWithNode
+public GraphNode AlignRightWithNode
+public GraphNode AlignBottomWithNode
+public GraphNode LeftOfNode
+public GraphNode AboveNode
+public GraphNode RightOfNode
+public GraphNode BelowNode
+public GraphNode AlignHorizontalCenterWith
+public GraphNode AlignVerticalCenterWith
+public GraphNode(UIElement element)
+public void Arrange(Size arrangeSize)
+public void Reset(bool clearPos)
+public Size GetBoundingSize()
+public Graph()
+public IEnumerable<GraphNode> GetNodes()
+public void Clear()
+public void Reset(bool clearPos = true)
+public GraphNode AddLink(GraphNode from, UIElement to)
+public GraphNode AddNode(UIElement value)
+public void Measure(Size availableSize)
+public Size GetBoundingSize(bool calcWidth, bool calcHeight)
+```
diff --git a/skills/handycontrol-wpf-relative-panel/references/usage.md b/skills/handycontrol-wpf-relative-panel/references/usage.md
new file mode 100644
index 00000000..b996ba0b
--- /dev/null
+++ b/skills/handycontrol-wpf-relative-panel/references/usage.md
@@ -0,0 +1,16 @@
+# RelativePanel 相对布局 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/relativePanel/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/relativePanel/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/relativePanel/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Panel/RelativePanel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/RelativePanel.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/RelativePanelDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/RelativePanelDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/RelativePanelDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/RelativePanelDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-running-block/SKILL.md b/skills/handycontrol-wpf-running-block/SKILL.md
new file mode 100644
index 00000000..bc7865f8
--- /dev/null
+++ b/skills/handycontrol-wpf-running-block/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-running-block
+description: "实现、配置或排查 HandyControl WPF 的 RunningBlock 滚动块（RunningBlock）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF RunningBlock 滚动块
+
+实现或排查 **RunningBlock 滚动块**。相关类型：`RunningBlock`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-running-block/agents/openai.yaml b/skills/handycontrol-wpf-running-block/agents/openai.yaml
new file mode 100644
index 00000000..81dc45d4
--- /dev/null
+++ b/skills/handycontrol-wpf-running-block/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF RunningBlock 滚动块"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-running-block to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-running-block/references/api.md b/skills/handycontrol-wpf-running-block/references/api.md
new file mode 100644
index 00000000..cb8a923c
--- /dev/null
+++ b/skills/handycontrol-wpf-running-block/references/api.md
@@ -0,0 +1,20 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## RunningBlock
+
+源码：[src/Shared/HandyControl_Shared/Controls/Block/RunningBlock/RunningBlock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Block/RunningBlock/RunningBlock.cs)
+
+```text
+public class RunningBlock : ContentControl
+public override void OnApplyTemplate()
+public bool Runaway
+public bool AutoRun
+public Orientation Orientation
+public Duration Duration
+public double Speed
+public bool IsRunning
+public bool AutoReverse
+public RunningDirection RunningDirection
+```
diff --git a/skills/handycontrol-wpf-running-block/references/usage.md b/skills/handycontrol-wpf-running-block/references/usage.md
new file mode 100644
index 00000000..74559be4
--- /dev/null
+++ b/skills/handycontrol-wpf-running-block/references/usage.md
@@ -0,0 +1,17 @@
+# RunningBlock 滚动块 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/runningBlock/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/runningBlock/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/runningBlock/)
+
+按任务阅读原文中的章节：案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Block/RunningBlock/RunningBlock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Block/RunningBlock/RunningBlock.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/RunningBlock.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/RunningBlock.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/RunningBlockDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/RunningBlockDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/RunningBlockDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/RunningBlockDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-screenshot/SKILL.md b/skills/handycontrol-wpf-screenshot/SKILL.md
new file mode 100644
index 00000000..7a23b143
--- /dev/null
+++ b/skills/handycontrol-wpf-screenshot/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-screenshot
+description: "实现、配置或排查 HandyControl WPF 的 Screenshot 截图（Screenshot）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Screenshot 截图
+
+实现或排查 **Screenshot 截图**。相关类型：`Screenshot`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-screenshot/agents/openai.yaml b/skills/handycontrol-wpf-screenshot/agents/openai.yaml
new file mode 100644
index 00000000..6bbe36ff
--- /dev/null
+++ b/skills/handycontrol-wpf-screenshot/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Screenshot 截图"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-screenshot to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-screenshot/references/api.md b/skills/handycontrol-wpf-screenshot/references/api.md
new file mode 100644
index 00000000..32527bea
--- /dev/null
+++ b/skills/handycontrol-wpf-screenshot/references/api.md
@@ -0,0 +1,13 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Screenshot
+
+源码：[src/Shared/HandyControl_Shared/Controls/Screenshot/Screenshot.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Screenshot/Screenshot.cs)
+
+```text
+public class Screenshot
+public static event EventHandler<FunctionEventArgs<ImageSource>> Snapped;
+public void Start()
+```
diff --git a/skills/handycontrol-wpf-screenshot/references/usage.md b/skills/handycontrol-wpf-screenshot/references/usage.md
new file mode 100644
index 00000000..428c7c6c
--- /dev/null
+++ b/skills/handycontrol-wpf-screenshot/references/usage.md
@@ -0,0 +1,17 @@
+# Screenshot 截图 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/screenshot/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/screenshot/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/screenshot/)
+
+按任务阅读原文中的章节：方法、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Screenshot/Screenshot.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Screenshot/Screenshot.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Screenshot.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Screenshot.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ScreenshotDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ScreenshotDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ScreenshotDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ScreenshotDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-scroll-viewer/SKILL.md b/skills/handycontrol-wpf-scroll-viewer/SKILL.md
new file mode 100644
index 00000000..f4af3aeb
--- /dev/null
+++ b/skills/handycontrol-wpf-scroll-viewer/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-scroll-viewer
+description: "实现、配置或排查 HandyControl WPF 的 ScrollViewer 滚动视图（ScrollViewer）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ScrollViewer 滚动视图
+
+实现或排查 **ScrollViewer 滚动视图**。相关类型：`ScrollViewer`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-scroll-viewer/agents/openai.yaml b/skills/handycontrol-wpf-scroll-viewer/agents/openai.yaml
new file mode 100644
index 00000000..99e9c62d
--- /dev/null
+++ b/skills/handycontrol-wpf-scroll-viewer/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ScrollViewer 滚动视图"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-scroll-viewer to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-scroll-viewer/references/api.md b/skills/handycontrol-wpf-scroll-viewer/references/api.md
new file mode 100644
index 00000000..190610cb
--- /dev/null
+++ b/skills/handycontrol-wpf-scroll-viewer/references/api.md
@@ -0,0 +1,20 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ScrollViewer
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/ScrollViewer.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/ScrollViewer.cs)
+
+```text
+public class ScrollViewer : System.Windows.Controls.ScrollViewer
+public bool CanMouseWheel
+public void ScrollToVerticalOffsetWithAnimation(double offset, double milliseconds = 500)
+public void ScrollToHorizontalOffsetWithAnimation(double offset, double milliseconds = 500)
+public static void SetIsInertiaEnabled(DependencyObject element, bool value)
+public static bool GetIsInertiaEnabled(DependencyObject element)
+public bool IsInertiaEnabled
+public bool IsPenetrating
+public static void SetIsPenetrating(DependencyObject element, bool value)
+public static bool GetIsPenetrating(DependencyObject element)
+```
diff --git a/skills/handycontrol-wpf-scroll-viewer/references/usage.md b/skills/handycontrol-wpf-scroll-viewer/references/usage.md
new file mode 100644
index 00000000..108456d0
--- /dev/null
+++ b/skills/handycontrol-wpf-scroll-viewer/references/usage.md
@@ -0,0 +1,17 @@
+# ScrollViewer 滚动视图 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/scrollViewer/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/scrollViewer/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/scrollViewer/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/ScrollViewer.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/ScrollViewer.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/ScrollViewer.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ScrollViewer.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ScrollViewerDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ScrollViewerDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ScrollViewerDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ScrollViewerDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-search-bar/SKILL.md b/skills/handycontrol-wpf-search-bar/SKILL.md
new file mode 100644
index 00000000..daf66524
--- /dev/null
+++ b/skills/handycontrol-wpf-search-bar/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-search-bar
+description: "实现、配置或排查 HandyControl WPF 的 SearchBar 搜索栏（SearchBar）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF SearchBar 搜索栏
+
+实现或排查 **SearchBar 搜索栏**。相关类型：`SearchBar`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-search-bar/agents/openai.yaml b/skills/handycontrol-wpf-search-bar/agents/openai.yaml
new file mode 100644
index 00000000..8d856d52
--- /dev/null
+++ b/skills/handycontrol-wpf-search-bar/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF SearchBar 搜索栏"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-search-bar to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-search-bar/references/api.md b/skills/handycontrol-wpf-search-bar/references/api.md
new file mode 100644
index 00000000..390e8247
--- /dev/null
+++ b/skills/handycontrol-wpf-search-bar/references/api.md
@@ -0,0 +1,26 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## SearchBar
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/SearchBar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/SearchBar.cs)
+
+```text
+public class SearchBar : TextBox, ICommandSource
+public SearchBar()
+public event EventHandler<FunctionEventArgs<string>> SearchStarted
+public bool IsRealTime
+public ICommand Command
+public object CommandParameter
+public IInputElement CommandTarget
+```
+
+## TextBox
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/TextBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/TextBox.cs)
+
+```text
+public class TextBox : System.Windows.Controls.TextBox
+public TextBox()
+```
diff --git a/skills/handycontrol-wpf-search-bar/references/usage.md b/skills/handycontrol-wpf-search-bar/references/usage.md
new file mode 100644
index 00000000..bddb8e82
--- /dev/null
+++ b/skills/handycontrol-wpf-search-bar/references/usage.md
@@ -0,0 +1,17 @@
+# SearchBar 搜索栏 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/searchBar/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/searchBar/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/searchBar/)
+
+按任务阅读原文中的章节：属性、附加属性、事件、样式、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Input/SearchBar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/SearchBar.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/SearchBar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/SearchBar.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/SearchBarDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/SearchBarDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/SearchBarDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/SearchBarDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-shield/SKILL.md b/skills/handycontrol-wpf-shield/SKILL.md
new file mode 100644
index 00000000..f93a0da6
--- /dev/null
+++ b/skills/handycontrol-wpf-shield/SKILL.md
@@ -0,0 +1,44 @@
+---
+name: handycontrol-wpf-shield
+description: "实现、配置或排查 HandyControl WPF 的 Shield 徽章（Shield）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Shield 徽章
+
+实现或排查 **Shield 徽章**。相关类型：`Shield`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<StackPanel Orientation="Horizontal" Margin="32">
+    <hc:Shield Subject=".net" Status=">=4.0" Color="#1182c3"/>
+    <hc:Shield Subject="c#" Status="7.0" Margin="4,0,0,0" Color="#1182c3"/>
+    <hc:Shield Subject="IDE" Status="2017" Margin="4,0,0,0" Color="#1182c3"/>
+    <hc:Shield Subject="chat" Status="on gitter" Margin="4,0,0,0" Color="#4eb899" Command="hc:ControlCommands.OpenLink" CommandParameter="https://gitter.im/HandyControl/Lobby?utm_source=badge&amp;utm_medium=badge&amp;utm_campaign=pr-badge&amp;utm_content=badge"/>
+    <hc:Shield Subject="qq" Status="714704041" Margin="4,0,0,0" Color="#d8624c" Command="hc:ControlCommands.OpenLink" CommandParameter="http://shang.qq.com/wpa/qunwpa?idkey=a571e5553c9d41e49c4f22f3a8b2865451497a795ff281fedf3285def247efc1"/>
+</StackPanel>
+```
diff --git a/skills/handycontrol-wpf-shield/agents/openai.yaml b/skills/handycontrol-wpf-shield/agents/openai.yaml
new file mode 100644
index 00000000..a20f5300
--- /dev/null
+++ b/skills/handycontrol-wpf-shield/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Shield 徽章"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-shield to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-shield/references/api.md b/skills/handycontrol-wpf-shield/references/api.md
new file mode 100644
index 00000000..7f0146fe
--- /dev/null
+++ b/skills/handycontrol-wpf-shield/references/api.md
@@ -0,0 +1,14 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Shield
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/Shield.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Shield.cs)
+
+```text
+public class Shield : ButtonBase
+public string Subject
+public object Status
+public Brush Color
+```
diff --git a/skills/handycontrol-wpf-shield/references/usage.md b/skills/handycontrol-wpf-shield/references/usage.md
new file mode 100644
index 00000000..2f93e383
--- /dev/null
+++ b/skills/handycontrol-wpf-shield/references/usage.md
@@ -0,0 +1,17 @@
+# Shield 徽章 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/shield/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/shield/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/shield/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/Shield.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Shield.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Shield.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Shield.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ShieldDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ShieldDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/ShieldDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/ShieldDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-side-menu/SKILL.md b/skills/handycontrol-wpf-side-menu/SKILL.md
new file mode 100644
index 00000000..8e900105
--- /dev/null
+++ b/skills/handycontrol-wpf-side-menu/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-side-menu
+description: "实现、配置或排查 HandyControl WPF 的 SideMenu 侧边菜单（SimpleItemsControl, HeaderedSimpleItemsControl, SideMenu）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF SideMenu 侧边菜单
+
+实现或排查 **SideMenu 侧边菜单**。相关类型：`SimpleItemsControl`, `HeaderedSimpleItemsControl`, `SideMenu`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-side-menu/agents/openai.yaml b/skills/handycontrol-wpf-side-menu/agents/openai.yaml
new file mode 100644
index 00000000..1fe22148
--- /dev/null
+++ b/skills/handycontrol-wpf-side-menu/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF SideMenu 侧边菜单"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-side-menu to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-side-menu/references/api.md b/skills/handycontrol-wpf-side-menu/references/api.md
new file mode 100644
index 00000000..bf833132
--- /dev/null
+++ b/skills/handycontrol-wpf-side-menu/references/api.md
@@ -0,0 +1,40 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## SimpleItemsControl
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs)
+
+```text
+public class SimpleItemsControl : Control
+public SimpleItemsControl()
+public IEnumerable ItemsSource
+public Style ItemContainerStyle
+public DataTemplate ItemTemplate
+public Collection<object> Items
+public override void OnApplyTemplate()
+public bool HasItems
+```
+
+## HeaderedSimpleItemsControl
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/HeaderedSimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/HeaderedSimpleItemsControl.cs)
+
+```text
+public class HeaderedSimpleItemsControl : SimpleItemsControl
+public object Header
+```
+
+## SideMenu
+
+源码：[src/Shared/HandyControl_Shared/Controls/SideMenu/SideMenu.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/SideMenu/SideMenu.cs)
+
+```text
+public class SideMenu : HeaderedSimpleItemsControl
+public SideMenu()
+public bool AutoSelect
+public ExpandMode ExpandMode
+public double PanelAreaLength
+public event EventHandler<FunctionEventArgs<object>> SelectionChanged
+```
diff --git a/skills/handycontrol-wpf-side-menu/references/usage.md b/skills/handycontrol-wpf-side-menu/references/usage.md
new file mode 100644
index 00000000..ee260bd4
--- /dev/null
+++ b/skills/handycontrol-wpf-side-menu/references/usage.md
@@ -0,0 +1,20 @@
+# SideMenu 侧边菜单 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/sideMenu/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/sideMenu/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/sideMenu/)
+
+按任务阅读原文中的章节：属性、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs)
+- [src/Shared/HandyControl_Shared/Controls/Base/HeaderedSimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/HeaderedSimpleItemsControl.cs)
+- [src/Shared/HandyControl_Shared/Controls/SideMenu/SideMenu.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/SideMenu/SideMenu.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/SideMenu.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/SideMenu.xaml)
+- [src/Shared/HandyControl_Shared/Themes/Styles/SimpleItemsControl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/SimpleItemsControl.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/SideMenuDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/SideMenuDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/SideMenuDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/SideMenuDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-simple-items-control/SKILL.md b/skills/handycontrol-wpf-simple-items-control/SKILL.md
new file mode 100644
index 00000000..87c479ac
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-items-control/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-simple-items-control
+description: "实现、配置或排查 HandyControl WPF 的 SimpleItemsControl 简单项目控件（SimpleItemsControl）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF SimpleItemsControl 简单项目控件
+
+实现或排查 **SimpleItemsControl 简单项目控件**。相关类型：`SimpleItemsControl`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-simple-items-control/agents/openai.yaml b/skills/handycontrol-wpf-simple-items-control/agents/openai.yaml
new file mode 100644
index 00000000..c230b1d4
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-items-control/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF SimpleItemsControl 简单项目控件"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-simple-items-control to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-simple-items-control/references/api.md b/skills/handycontrol-wpf-simple-items-control/references/api.md
new file mode 100644
index 00000000..485ca033
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-items-control/references/api.md
@@ -0,0 +1,18 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## SimpleItemsControl
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs)
+
+```text
+public class SimpleItemsControl : Control
+public SimpleItemsControl()
+public IEnumerable ItemsSource
+public Style ItemContainerStyle
+public DataTemplate ItemTemplate
+public Collection<object> Items
+public override void OnApplyTemplate()
+public bool HasItems
+```
diff --git a/skills/handycontrol-wpf-simple-items-control/references/usage.md b/skills/handycontrol-wpf-simple-items-control/references/usage.md
new file mode 100644
index 00000000..d438ffe6
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-items-control/references/usage.md
@@ -0,0 +1,15 @@
+# SimpleItemsControl 简单项目控件 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/simpleItemsControl/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/simpleItemsControl/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/simpleItemsControl/)
+
+按任务阅读原文中的章节：属性。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/SimpleItemsControl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/SimpleItemsControl.xaml)
diff --git a/skills/handycontrol-wpf-simple-panel/SKILL.md b/skills/handycontrol-wpf-simple-panel/SKILL.md
new file mode 100644
index 00000000..2b15f4f3
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-panel/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-simple-panel
+description: "实现、配置或排查 HandyControl WPF 的 SimplePanel 简单面板（SimplePanel）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF SimplePanel 简单面板
+
+实现或排查 **SimplePanel 简单面板**。相关类型：`SimplePanel`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-simple-panel/agents/openai.yaml b/skills/handycontrol-wpf-simple-panel/agents/openai.yaml
new file mode 100644
index 00000000..3a440011
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-panel/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF SimplePanel 简单面板"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-simple-panel to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-simple-panel/references/api.md b/skills/handycontrol-wpf-simple-panel/references/api.md
new file mode 100644
index 00000000..099775d2
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-panel/references/api.md
@@ -0,0 +1,11 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## SimplePanel
+
+源码：[src/Shared/HandyControl_Shared/Controls/Panel/SimplePanel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/SimplePanel.cs)
+
+```text
+public class SimplePanel : Panel
+```
diff --git a/skills/handycontrol-wpf-simple-panel/references/usage.md b/skills/handycontrol-wpf-simple-panel/references/usage.md
new file mode 100644
index 00000000..93eec67f
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-panel/references/usage.md
@@ -0,0 +1,15 @@
+# SimplePanel 简单面板 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/simplePanel/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/simplePanel/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/simplePanel/)
+
+按任务阅读原文中的章节：。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Panel/SimplePanel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/SimplePanel.cs)
+
+## 样式及官方示例
+
+
diff --git a/skills/handycontrol-wpf-simple-text/SKILL.md b/skills/handycontrol-wpf-simple-text/SKILL.md
new file mode 100644
index 00000000..8f172e44
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-text/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-simple-text
+description: "实现、配置或排查 HandyControl WPF 的 SimpleText 简单文本（SimpleText）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF SimpleText 简单文本
+
+实现或排查 **SimpleText 简单文本**。相关类型：`SimpleText`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:SimpleText Text="Content"/>
+```
diff --git a/skills/handycontrol-wpf-simple-text/agents/openai.yaml b/skills/handycontrol-wpf-simple-text/agents/openai.yaml
new file mode 100644
index 00000000..72e5f3f9
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-text/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF SimpleText 简单文本"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-simple-text to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-simple-text/references/api.md b/skills/handycontrol-wpf-simple-text/references/api.md
new file mode 100644
index 00000000..f852c6b2
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-text/references/api.md
@@ -0,0 +1,21 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## SimpleText
+
+源码：[src/Shared/HandyControl_Shared/Controls/Text/SimpleText.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Text/SimpleText.cs)
+
+```text
+public class SimpleText : FrameworkElement
+public string Text
+public TextAlignment TextAlignment
+public TextTrimming TextTrimming
+public TextWrapping TextWrapping
+public Brush Foreground
+public FontFamily FontFamily
+public double FontSize
+public FontStretch FontStretch
+public FontStyle FontStyle
+public FontWeight FontWeight
+```
diff --git a/skills/handycontrol-wpf-simple-text/references/usage.md b/skills/handycontrol-wpf-simple-text/references/usage.md
new file mode 100644
index 00000000..88d1663b
--- /dev/null
+++ b/skills/handycontrol-wpf-simple-text/references/usage.md
@@ -0,0 +1,15 @@
+# SimpleText 简单文本 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/simpleText/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/simpleText/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/simpleText/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Text/SimpleText.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Text/SimpleText.cs)
+
+## 样式及官方示例
+
+
diff --git a/skills/handycontrol-wpf-split-button/SKILL.md b/skills/handycontrol-wpf-split-button/SKILL.md
new file mode 100644
index 00000000..e8348522
--- /dev/null
+++ b/skills/handycontrol-wpf-split-button/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-split-button
+description: "实现、配置或排查 HandyControl WPF 的 SplitButton 分割按钮（SplitButton）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF SplitButton 分割按钮
+
+实现或排查 **SplitButton 分割按钮**。相关类型：`SplitButton`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-split-button/agents/openai.yaml b/skills/handycontrol-wpf-split-button/agents/openai.yaml
new file mode 100644
index 00000000..a9dc09da
--- /dev/null
+++ b/skills/handycontrol-wpf-split-button/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF SplitButton 分割按钮"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-split-button to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-split-button/references/api.md b/skills/handycontrol-wpf-split-button/references/api.md
new file mode 100644
index 00000000..003dd34b
--- /dev/null
+++ b/skills/handycontrol-wpf-split-button/references/api.md
@@ -0,0 +1,16 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## SplitButton
+
+源码：[src/Shared/HandyControl_Shared/Controls/Button/SplitButton.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Button/SplitButton.cs)
+
+```text
+public class SplitButton : ButtonBase
+public HitMode HitMode
+public double MaxDropDownHeight
+public bool IsDropDownOpen
+public object DropDownContent
+public SplitButton()
+```
diff --git a/skills/handycontrol-wpf-split-button/references/usage.md b/skills/handycontrol-wpf-split-button/references/usage.md
new file mode 100644
index 00000000..878e71c9
--- /dev/null
+++ b/skills/handycontrol-wpf-split-button/references/usage.md
@@ -0,0 +1,17 @@
+# SplitButton 分割按钮 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/splitButton/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/splitButton/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/splitButton/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Button/SplitButton.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Button/SplitButton.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/SplitButton.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/SplitButton.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/SplitButtonDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/SplitButtonDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/SplitButtonDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/SplitButtonDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-sprite/SKILL.md b/skills/handycontrol-wpf-sprite/SKILL.md
new file mode 100644
index 00000000..7bcf0aab
--- /dev/null
+++ b/skills/handycontrol-wpf-sprite/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-sprite
+description: "实现、配置或排查 HandyControl WPF 的 Sprite 精灵（Sprite）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Sprite 精灵
+
+实现或排查 **Sprite 精灵**。相关类型：`Sprite`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-sprite/agents/openai.yaml b/skills/handycontrol-wpf-sprite/agents/openai.yaml
new file mode 100644
index 00000000..42080c00
--- /dev/null
+++ b/skills/handycontrol-wpf-sprite/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Sprite 精灵"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-sprite to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-sprite/references/api.md b/skills/handycontrol-wpf-sprite/references/api.md
new file mode 100644
index 00000000..c54f5e72
--- /dev/null
+++ b/skills/handycontrol-wpf-sprite/references/api.md
@@ -0,0 +1,12 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Sprite
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/Sprite.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Sprite.cs)
+
+```text
+public sealed class Sprite : System.Windows.Window
+public static Sprite Show(object content)
+```
diff --git a/skills/handycontrol-wpf-sprite/references/usage.md b/skills/handycontrol-wpf-sprite/references/usage.md
new file mode 100644
index 00000000..86443f23
--- /dev/null
+++ b/skills/handycontrol-wpf-sprite/references/usage.md
@@ -0,0 +1,17 @@
+# Sprite 精灵 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/sprite/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/sprite/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/sprite/)
+
+按任务阅读原文中的章节：方法、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/Sprite.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Sprite.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Sprite.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Sprite.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/SpriteDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/SpriteDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/SpriteDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/SpriteDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-step-bar/SKILL.md b/skills/handycontrol-wpf-step-bar/SKILL.md
new file mode 100644
index 00000000..28d6049c
--- /dev/null
+++ b/skills/handycontrol-wpf-step-bar/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-step-bar
+description: "实现、配置或排查 HandyControl WPF 的 StepBar 步骤条（StepBar）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF StepBar 步骤条
+
+实现或排查 **StepBar 步骤条**。相关类型：`StepBar`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-step-bar/agents/openai.yaml b/skills/handycontrol-wpf-step-bar/agents/openai.yaml
new file mode 100644
index 00000000..bdbb6d04
--- /dev/null
+++ b/skills/handycontrol-wpf-step-bar/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF StepBar 步骤条"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-step-bar to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-step-bar/references/api.md b/skills/handycontrol-wpf-step-bar/references/api.md
new file mode 100644
index 00000000..a120fee9
--- /dev/null
+++ b/skills/handycontrol-wpf-step-bar/references/api.md
@@ -0,0 +1,19 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## StepBar
+
+源码：[src/Shared/HandyControl_Shared/Controls/StepBar/StepBar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/StepBar/StepBar.cs)
+
+```text
+public class StepBar : ItemsControl
+public StepBar()
+public event EventHandler<FunctionEventArgs<int>> StepChanged
+public int StepIndex
+public Dock Dock
+public bool IsMouseSelectable
+public override void OnApplyTemplate()
+public void Next()
+public void Prev()
+```
diff --git a/skills/handycontrol-wpf-step-bar/references/usage.md b/skills/handycontrol-wpf-step-bar/references/usage.md
new file mode 100644
index 00000000..6612e91d
--- /dev/null
+++ b/skills/handycontrol-wpf-step-bar/references/usage.md
@@ -0,0 +1,17 @@
+# StepBar 步骤条 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/stepBar/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/stepBar/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/stepBar/)
+
+按任务阅读原文中的章节：属性、方法、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/StepBar/StepBar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/StepBar/StepBar.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/StepBar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/StepBar.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/StepBarDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/StepBarDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/StepBarDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/StepBarDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-tab-control/SKILL.md b/skills/handycontrol-wpf-tab-control/SKILL.md
new file mode 100644
index 00000000..e5101785
--- /dev/null
+++ b/skills/handycontrol-wpf-tab-control/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-tab-control
+description: "实现、配置或排查 HandyControl WPF 的 TabControl 选项卡控件（TabControl）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF TabControl 选项卡控件
+
+实现或排查 **TabControl 选项卡控件**。相关类型：`TabControl`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-tab-control/agents/openai.yaml b/skills/handycontrol-wpf-tab-control/agents/openai.yaml
new file mode 100644
index 00000000..eb3bbbfd
--- /dev/null
+++ b/skills/handycontrol-wpf-tab-control/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF TabControl 选项卡控件"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-tab-control to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-tab-control/references/api.md b/skills/handycontrol-wpf-tab-control/references/api.md
new file mode 100644
index 00000000..47bd2406
--- /dev/null
+++ b/skills/handycontrol-wpf-tab-control/references/api.md
@@ -0,0 +1,28 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## TabControl
+
+源码：[src/Shared/HandyControl_Shared/Controls/TabControl/TabControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/TabControl/TabControl.cs)
+
+```text
+public class TabControl : System.Windows.Controls.TabControl
+public bool IsAnimationEnabled
+public bool IsDraggable
+public static void SetShowCloseButton(DependencyObject element, bool value)
+public static bool GetShowCloseButton(DependencyObject element)
+public bool ShowCloseButton
+public static void SetShowContextMenu(DependencyObject element, bool value)
+public static bool GetShowContextMenu(DependencyObject element)
+public bool ShowContextMenu
+public bool CanBeClosedByMiddleButton
+public bool IsTabFillEnabled
+public double TabItemWidth
+public double TabItemHeight
+public bool IsScrollable
+public bool ShowOverflowButton
+public bool ShowScrollButton
+public string OverflowMenuDisplayMemberPath
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-tab-control/references/usage.md b/skills/handycontrol-wpf-tab-control/references/usage.md
new file mode 100644
index 00000000..f6594ec0
--- /dev/null
+++ b/skills/handycontrol-wpf-tab-control/references/usage.md
@@ -0,0 +1,17 @@
+# TabControl 选项卡控件 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/tabControl/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/tabControl/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/tabControl/)
+
+按任务阅读原文中的章节：属性、案例、TabItem。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/TabControl/TabControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/TabControl/TabControl.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/TabControl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TabControl.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TabControlDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TabControlDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TabControlDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TabControlDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-tag/SKILL.md b/skills/handycontrol-wpf-tag/SKILL.md
new file mode 100644
index 00000000..7b361beb
--- /dev/null
+++ b/skills/handycontrol-wpf-tag/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-tag
+description: "实现、配置或排查 HandyControl WPF 的 Tag 标签（Tag）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Tag 标签
+
+实现或排查 **Tag 标签**。相关类型：`Tag`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-tag/agents/openai.yaml b/skills/handycontrol-wpf-tag/agents/openai.yaml
new file mode 100644
index 00000000..ae83a84d
--- /dev/null
+++ b/skills/handycontrol-wpf-tag/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Tag 标签"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-tag to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-tag/references/api.md b/skills/handycontrol-wpf-tag/references/api.md
new file mode 100644
index 00000000..266bc122
--- /dev/null
+++ b/skills/handycontrol-wpf-tag/references/api.md
@@ -0,0 +1,23 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Tag
+
+源码：[src/Shared/HandyControl_Shared/Controls/Tag/Tag.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Tag/Tag.cs)
+
+```text
+public class Tag : ContentControl
+public Tag()
+public bool ShowCloseButton
+public bool Selectable
+public bool IsSelected
+public object Header
+public bool HasHeader
+public string HeaderStringFormat
+public DataTemplateSelector HeaderTemplateSelector
+public DataTemplate HeaderTemplate
+public event EventHandler Selected
+public event EventHandler Closing
+public event EventHandler Closed
+```
diff --git a/skills/handycontrol-wpf-tag/references/usage.md b/skills/handycontrol-wpf-tag/references/usage.md
new file mode 100644
index 00000000..09dc1fa2
--- /dev/null
+++ b/skills/handycontrol-wpf-tag/references/usage.md
@@ -0,0 +1,17 @@
+# Tag 标签 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/tag/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/tag/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/tag/)
+
+按任务阅读原文中的章节：属性、事件、TagPanel、属性、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Tag/Tag.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Tag/Tag.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Tag.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Tag.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TagDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TagDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TagDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TagDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-text-box/SKILL.md b/skills/handycontrol-wpf-text-box/SKILL.md
new file mode 100644
index 00000000..1ef02769
--- /dev/null
+++ b/skills/handycontrol-wpf-text-box/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-text-box
+description: "实现、配置或排查 HandyControl WPF 的 TextBox 文本框（TextBox）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF TextBox 文本框
+
+实现或排查 **TextBox 文本框**。相关类型：`TextBox`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+hc:TextBox 与原生 TextBox 的样式方案不同。先确定使用的类型，再设置标题、占位和验证属性；不要假定 WPF PasswordBox 或其他输入框都支持 Text 绑定。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:TextBox />
+```
diff --git a/skills/handycontrol-wpf-text-box/agents/openai.yaml b/skills/handycontrol-wpf-text-box/agents/openai.yaml
new file mode 100644
index 00000000..727f3dd4
--- /dev/null
+++ b/skills/handycontrol-wpf-text-box/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF TextBox 文本框"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-text-box to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-text-box/references/api.md b/skills/handycontrol-wpf-text-box/references/api.md
new file mode 100644
index 00000000..e884d85f
--- /dev/null
+++ b/skills/handycontrol-wpf-text-box/references/api.md
@@ -0,0 +1,12 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## TextBox
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/TextBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/TextBox.cs)
+
+```text
+public class TextBox : System.Windows.Controls.TextBox
+public TextBox()
+```
diff --git a/skills/handycontrol-wpf-text-box/references/usage.md b/skills/handycontrol-wpf-text-box/references/usage.md
new file mode 100644
index 00000000..de10af8a
--- /dev/null
+++ b/skills/handycontrol-wpf-text-box/references/usage.md
@@ -0,0 +1,17 @@
+# TextBox 文本框 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/textBox/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/textBox/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/textBox/)
+
+按任务阅读原文中的章节：创建TextBox、输入文本、设置标题和占位符文本、属性、方法。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Input/TextBox.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/TextBox.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/TextBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TextBox.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TextBoxDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TextBoxDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TextBoxDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TextBoxDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-theming/SKILL.md b/skills/handycontrol-wpf-theming/SKILL.md
new file mode 100644
index 00000000..814a2774
--- /dev/null
+++ b/skills/handycontrol-wpf-theming/SKILL.md
@@ -0,0 +1,14 @@
+---
+name: handycontrol-wpf-theming
+description: "配置 HandyControl WPF 的皮肤、资源字典、动态颜色和主题切换；排查资源键与控件样式，不用于 Avalonia。"
+---
+
+# HandyControl WPF 主题
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+按任务阅读 [配置及示例](references/usage.md)。先确认控件实际 CLR 类型和样式 TargetType，再修改资源。
diff --git a/skills/handycontrol-wpf-theming/agents/openai.yaml b/skills/handycontrol-wpf-theming/agents/openai.yaml
new file mode 100644
index 00000000..4a901e3d
--- /dev/null
+++ b/skills/handycontrol-wpf-theming/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF 主题"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-theming to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-theming/references/usage.md b/skills/handycontrol-wpf-theming/references/usage.md
new file mode 100644
index 00000000..fb1919ed
--- /dev/null
+++ b/skills/handycontrol-wpf-theming/references/usage.md
@@ -0,0 +1,41 @@
+# 皮肤、主题与资源
+
+## 静态字典方案
+
+`SkinDefault.xaml`、`SkinDark.xaml`、`SkinViolet.xaml` 是皮肤字典；`Theme.xaml` 提供控件主题。先合并一个皮肤，再合并主题，应用自己的覆盖资源置于其后。通过 `DynamicResource` 引用需要随皮肤变化的颜色和画刷，例如 `PrimaryBrush`、`RegionBrush`；显式样式键通常用 `StaticResource`。
+
+```xml
+<ResourceDictionary.MergedDictionaries>
+    <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/SkinDark.xaml"/>
+    <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/Theme.xaml"/>
+</ResourceDictionary.MergedDictionaries>
+```
+
+这是现有 ResourceDictionary 内的片段，不应额外嵌套 Application.Resources。运行时更换静态皮肤时替换由应用持有的那一个皮肤字典，保留其他字典和顺序，不清空全部 MergedDictionaries。
+
+## Theme 对象方案
+
+当前源码还提供 `HandyControl.Themes.Theme : ResourceDictionary`，其 `Skin` 为 `HandyControl.Data.SkinType`；可以用 Theme 对象管理皮肤。采用此方案时先读取 `Themes/Theme.cs` 的构造和更新逻辑，避免同时再加载一套静态主题字典。
+
+```xml
+<ResourceDictionary.MergedDictionaries>
+    <hc:Theme Skin="Dark"/>
+</ResourceDictionary.MergedDictionaries>
+```
+
+`hc` 对应 `https://handyorg.github.io/handycontrol`。修改 Theme 实例的 Skin 需要保留对该实例的引用；自动跟随系统、强调色等能力以实际版本的 Theme 源码属性为准。
+
+## 调整外观
+
+先找到控件对应的 `Themes/Styles/<控件>.xaml`，核对 x:Key、TargetType、BasedOn 和 TemplateBinding。能通过公开属性或附加属性完成的改动优先使用这些接口；确需重写模板时保留必需的 PART_* 名称。
+
+本仓库 `Themes/Theme.xaml` 由 `XamlCombine.exe` 和 `Theme_GE45.txt` / `Theme_40.txt` 合并。修改相应样式源文件及必要的清单，再按项目构建流程生成；不要把合并文件当作唯一维护入口。使用方项目通常只需要覆盖自己的资源。
+
+先检查工作区已有修改，尤其颜色和主题文件，避免覆盖用户的定制。验证浅色、深色切换时检查文本对比度、禁用态、弹出层及局部资源覆盖；无法运行 UI 时说明限制。
+
+## 源码依据
+
+- [Theme 实现](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Theme.cs)
+- [皮肤枚举](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Data/Enum/SkinType.cs)
+- [样式源目录](https://github.com/HandyOrg/HandyControl/tree/master/src/Shared/HandyControl_Shared/Themes/Styles)
+- [主题合并清单](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Theme_GE45.txt)
diff --git a/skills/handycontrol-wpf-time-bar/SKILL.md b/skills/handycontrol-wpf-time-bar/SKILL.md
new file mode 100644
index 00000000..b9a8ed6b
--- /dev/null
+++ b/skills/handycontrol-wpf-time-bar/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-time-bar
+description: "实现、配置或排查 HandyControl WPF 的 TimeBar 时间条（TimeBar）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF TimeBar 时间条
+
+实现或排查 **TimeBar 时间条**。相关类型：`TimeBar`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:TimeBar BorderThickness="0" Width="600"/>
+```
diff --git a/skills/handycontrol-wpf-time-bar/agents/openai.yaml b/skills/handycontrol-wpf-time-bar/agents/openai.yaml
new file mode 100644
index 00000000..167010ee
--- /dev/null
+++ b/skills/handycontrol-wpf-time-bar/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF TimeBar 时间条"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-time-bar to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-time-bar/references/api.md b/skills/handycontrol-wpf-time-bar/references/api.md
new file mode 100644
index 00000000..9ee770b4
--- /dev/null
+++ b/skills/handycontrol-wpf-time-bar/references/api.md
@@ -0,0 +1,21 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## TimeBar
+
+源码：[src/Shared/HandyControl_Shared/Controls/Time/TimeBar/TimeBar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Time/TimeBar/TimeBar.cs)
+
+```text
+public class TimeBar : Control
+public Collection<DateTimeRange> Hotspots
+public Brush HotspotsBrush
+public bool ShowSpeStr
+public string TimeFormat
+public string SpeStr
+public DateTime SelectedTime
+public TimeBar()
+public override void OnApplyTemplate()
+public int SpeIndex
+public event EventHandler<FunctionEventArgs<DateTime>> TimeChanged
+```
diff --git a/skills/handycontrol-wpf-time-bar/references/usage.md b/skills/handycontrol-wpf-time-bar/references/usage.md
new file mode 100644
index 00000000..c26fc6a3
--- /dev/null
+++ b/skills/handycontrol-wpf-time-bar/references/usage.md
@@ -0,0 +1,17 @@
+# TimeBar 时间条 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/timeBar/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/timeBar/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/timeBar/)
+
+按任务阅读原文中的章节：属性、事件、案例、设置热区。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Time/TimeBar/TimeBar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Time/TimeBar/TimeBar.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/TimeBar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TimeBar.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TimeBarDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TimeBarDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TimeBarDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TimeBarDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-time-picker/SKILL.md b/skills/handycontrol-wpf-time-picker/SKILL.md
new file mode 100644
index 00000000..c67b139b
--- /dev/null
+++ b/skills/handycontrol-wpf-time-picker/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-time-picker
+description: "实现、配置或排查 HandyControl WPF 的 TimePicker 时间选择器（TimePicker）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF TimePicker 时间选择器
+
+实现或排查 **TimePicker 时间选择器**。相关类型：`TimePicker`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:TimePicker />
+```
diff --git a/skills/handycontrol-wpf-time-picker/agents/openai.yaml b/skills/handycontrol-wpf-time-picker/agents/openai.yaml
new file mode 100644
index 00000000..ad24b598
--- /dev/null
+++ b/skills/handycontrol-wpf-time-picker/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF TimePicker 时间选择器"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-time-picker to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-time-picker/references/api.md b/skills/handycontrol-wpf-time-picker/references/api.md
new file mode 100644
index 00000000..8ef66354
--- /dev/null
+++ b/skills/handycontrol-wpf-time-picker/references/api.md
@@ -0,0 +1,27 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## TimePicker
+
+源码：[src/Shared/HandyControl_Shared/Controls/Input/TimePicker.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/TimePicker.cs)
+
+```text
+public class TimePicker : Control
+public event EventHandler<FunctionEventArgs<DateTime?>> SelectedTimeChanged
+public event RoutedEventHandler ClockClosed;
+public event RoutedEventHandler ClockOpened;
+public TimePicker()
+public string TimeFormat
+public DateTime DisplayTime
+public bool IsDropDownOpen
+public DateTime? SelectedTime
+public string Text
+public Brush SelectionBrush
+public Brush SelectionTextBrush
+public double SelectionOpacity
+public Brush CaretBrush
+public ClockBase Clock
+public override void OnApplyTemplate()
+public override string ToString()
+```
diff --git a/skills/handycontrol-wpf-time-picker/references/usage.md b/skills/handycontrol-wpf-time-picker/references/usage.md
new file mode 100644
index 00000000..3317770e
--- /dev/null
+++ b/skills/handycontrol-wpf-time-picker/references/usage.md
@@ -0,0 +1,17 @@
+# TimePicker 时间选择器 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/timePicker/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/timePicker/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/timePicker/)
+
+按任务阅读原文中的章节：创建TimePicker、选择时间、更改时钟样式、设置标题和占位符文本、属性、方法。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Input/TimePicker.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Input/TimePicker.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/TimePicker.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TimePicker.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TimePickerDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TimePickerDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TimePickerDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TimePickerDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-toggle-block/SKILL.md b/skills/handycontrol-wpf-toggle-block/SKILL.md
new file mode 100644
index 00000000..04f21826
--- /dev/null
+++ b/skills/handycontrol-wpf-toggle-block/SKILL.md
@@ -0,0 +1,45 @@
+---
+name: handycontrol-wpf-toggle-block
+description: "实现、配置或排查 HandyControl WPF 的 ToggleBlock 切换块（ToggleBlock）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF ToggleBlock 切换块
+
+实现或排查 **ToggleBlock 切换块**。相关类型：`ToggleBlock`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:ToggleBlock>
+    <hc:ToggleBlock.UnCheckedContent>
+        
+    </hc:ToggleBlock.UnCheckedContent>
+    <hc:ToggleBlock.CheckedContent>
+
+    </hc:ToggleBlock.CheckedContent>
+</hc:ToggleBlock>
+```
diff --git a/skills/handycontrol-wpf-toggle-block/agents/openai.yaml b/skills/handycontrol-wpf-toggle-block/agents/openai.yaml
new file mode 100644
index 00000000..db345a98
--- /dev/null
+++ b/skills/handycontrol-wpf-toggle-block/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF ToggleBlock 切换块"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-toggle-block to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-toggle-block/references/api.md b/skills/handycontrol-wpf-toggle-block/references/api.md
new file mode 100644
index 00000000..747a9f64
--- /dev/null
+++ b/skills/handycontrol-wpf-toggle-block/references/api.md
@@ -0,0 +1,17 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## ToggleBlock
+
+源码：[src/Shared/HandyControl_Shared/Controls/Block/ToggleBlock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Block/ToggleBlock.cs)
+
+```text
+public class ToggleBlock : Control
+public bool? IsChecked
+public object CheckedContent
+public object UnCheckedContent
+public object IndeterminateContent
+public MouseGesture ToggleGesture
+public ToggleBlock()
+```
diff --git a/skills/handycontrol-wpf-toggle-block/references/usage.md b/skills/handycontrol-wpf-toggle-block/references/usage.md
new file mode 100644
index 00000000..316b9a27
--- /dev/null
+++ b/skills/handycontrol-wpf-toggle-block/references/usage.md
@@ -0,0 +1,15 @@
+# ToggleBlock 切换块 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/toggleBlock/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/toggleBlock/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/toggleBlock/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Block/ToggleBlock.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Block/ToggleBlock.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/ToggleBlock.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ToggleBlock.xaml)
diff --git a/skills/handycontrol-wpf-transfer/SKILL.md b/skills/handycontrol-wpf-transfer/SKILL.md
new file mode 100644
index 00000000..d8f7735e
--- /dev/null
+++ b/skills/handycontrol-wpf-transfer/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-transfer
+description: "实现、配置或排查 HandyControl WPF 的 Transfer 穿梭框（SimpleItemsControl, Transfer）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Transfer 穿梭框
+
+实现或排查 **Transfer 穿梭框**。相关类型：`SimpleItemsControl`, `Transfer`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-transfer/agents/openai.yaml b/skills/handycontrol-wpf-transfer/agents/openai.yaml
new file mode 100644
index 00000000..e83e77da
--- /dev/null
+++ b/skills/handycontrol-wpf-transfer/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Transfer 穿梭框"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-transfer to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-transfer/references/api.md b/skills/handycontrol-wpf-transfer/references/api.md
new file mode 100644
index 00000000..e1e74ef1
--- /dev/null
+++ b/skills/handycontrol-wpf-transfer/references/api.md
@@ -0,0 +1,30 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## SimpleItemsControl
+
+源码：[src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs)
+
+```text
+public class SimpleItemsControl : Control
+public SimpleItemsControl()
+public IEnumerable ItemsSource
+public Style ItemContainerStyle
+public DataTemplate ItemTemplate
+public Collection<object> Items
+public override void OnApplyTemplate()
+public bool HasItems
+```
+
+## Transfer
+
+源码：[src/Shared/HandyControl_Shared/Controls/Transfer/Transfer.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Transfer/Transfer.cs)
+
+```text
+public class Transfer : ListBox
+public event SelectionChangedEventHandler TransferredItemsChanged
+public IList TransferredItems
+public Transfer()
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-transfer/references/usage.md b/skills/handycontrol-wpf-transfer/references/usage.md
new file mode 100644
index 00000000..ee976ea8
--- /dev/null
+++ b/skills/handycontrol-wpf-transfer/references/usage.md
@@ -0,0 +1,19 @@
+# Transfer 穿梭框 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/transfer/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/transfer/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/transfer/)
+
+按任务阅读原文中的章节：属性、事件、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Base/SimpleItemsControl.cs)
+- [src/Shared/HandyControl_Shared/Controls/Transfer/Transfer.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Transfer/Transfer.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/SimpleItemsControl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/SimpleItemsControl.xaml)
+- [src/Shared/HandyControl_Shared/Themes/Styles/Transfer.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Transfer.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TransferDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TransferDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TransferDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TransferDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-transitioning-content-control/SKILL.md b/skills/handycontrol-wpf-transitioning-content-control/SKILL.md
new file mode 100644
index 00000000..6fed5d80
--- /dev/null
+++ b/skills/handycontrol-wpf-transitioning-content-control/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-transitioning-content-control
+description: "实现、配置或排查 HandyControl WPF 的 TransitioningContentControl 内容过渡控件（TransitioningContentControl）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF TransitioningContentControl 内容过渡控件
+
+实现或排查 **TransitioningContentControl 内容过渡控件**。相关类型：`TransitioningContentControl`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-transitioning-content-control/agents/openai.yaml b/skills/handycontrol-wpf-transitioning-content-control/agents/openai.yaml
new file mode 100644
index 00000000..7cdc8934
--- /dev/null
+++ b/skills/handycontrol-wpf-transitioning-content-control/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF TransitioningContentControl 内容过渡控件"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-transitioning-content-control to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-transitioning-content-control/references/api.md b/skills/handycontrol-wpf-transitioning-content-control/references/api.md
new file mode 100644
index 00000000..be2afda8
--- /dev/null
+++ b/skills/handycontrol-wpf-transitioning-content-control/references/api.md
@@ -0,0 +1,15 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## TransitioningContentControl
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/TransitioningContentControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/TransitioningContentControl.cs)
+
+```text
+public class TransitioningContentControl : ContentControl
+public TransitioningContentControl()
+public TransitionMode TransitionMode
+public Storyboard TransitionStoryboard
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-transitioning-content-control/references/usage.md b/skills/handycontrol-wpf-transitioning-content-control/references/usage.md
new file mode 100644
index 00000000..9e9eba99
--- /dev/null
+++ b/skills/handycontrol-wpf-transitioning-content-control/references/usage.md
@@ -0,0 +1,17 @@
+# TransitioningContentControl 内容过渡控件 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/transitioningContentControl/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/transitioningContentControl/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/transitioningContentControl/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/TransitioningContentControl.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/TransitioningContentControl.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/TransitioningContentControl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TransitioningContentControl.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TransitioningContentControlDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TransitioningContentControlDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/TransitioningContentControlDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/TransitioningContentControlDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-waterfall-panel/SKILL.md b/skills/handycontrol-wpf-waterfall-panel/SKILL.md
new file mode 100644
index 00000000..1f4fe4e2
--- /dev/null
+++ b/skills/handycontrol-wpf-waterfall-panel/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-waterfall-panel
+description: "实现、配置或排查 HandyControl WPF 的 WaterfallPanel 瀑布流（WaterfallPanel）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF WaterfallPanel 瀑布流
+
+实现或排查 **WaterfallPanel 瀑布流**。相关类型：`WaterfallPanel`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-waterfall-panel/agents/openai.yaml b/skills/handycontrol-wpf-waterfall-panel/agents/openai.yaml
new file mode 100644
index 00000000..c92ce395
--- /dev/null
+++ b/skills/handycontrol-wpf-waterfall-panel/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF WaterfallPanel 瀑布流"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-waterfall-panel to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-waterfall-panel/references/api.md b/skills/handycontrol-wpf-waterfall-panel/references/api.md
new file mode 100644
index 00000000..0fef1960
--- /dev/null
+++ b/skills/handycontrol-wpf-waterfall-panel/references/api.md
@@ -0,0 +1,15 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## WaterfallPanel
+
+源码：[src/Shared/HandyControl_Shared/Controls/Panel/WaterfallPanel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/WaterfallPanel.cs)
+
+```text
+public class WaterfallPanel : Panel
+public int Groups
+public bool AutoGroup
+public double DesiredLength
+public Orientation Orientation
+```
diff --git a/skills/handycontrol-wpf-waterfall-panel/references/usage.md b/skills/handycontrol-wpf-waterfall-panel/references/usage.md
new file mode 100644
index 00000000..8b4023df
--- /dev/null
+++ b/skills/handycontrol-wpf-waterfall-panel/references/usage.md
@@ -0,0 +1,16 @@
+# WaterfallPanel 瀑布流 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/waterfallPanel/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/waterfallPanel/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/waterfallPanel/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Panel/WaterfallPanel.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Panel/WaterfallPanel.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/WaterfallPanelDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/WaterfallPanelDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/WaterfallPanelDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/WaterfallPanelDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-watermark/SKILL.md b/skills/handycontrol-wpf-watermark/SKILL.md
new file mode 100644
index 00000000..9413b9bb
--- /dev/null
+++ b/skills/handycontrol-wpf-watermark/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: handycontrol-wpf-watermark
+description: "实现、配置或排查 HandyControl WPF 的 Watermark 水印（Watermark）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Watermark 水印
+
+实现或排查 **Watermark 水印**。相关类型：`Watermark`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+
+## 最小片段
+
+依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。
+
+```xml
+<hc:Watermark Mark="Project" FontSize="80" FontWeight="Bold" MarkMargin="30,0"/>
+```
diff --git a/skills/handycontrol-wpf-watermark/agents/openai.yaml b/skills/handycontrol-wpf-watermark/agents/openai.yaml
new file mode 100644
index 00000000..15aea475
--- /dev/null
+++ b/skills/handycontrol-wpf-watermark/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Watermark 水印"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-watermark to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-watermark/references/api.md b/skills/handycontrol-wpf-watermark/references/api.md
new file mode 100644
index 00000000..ad6bd14c
--- /dev/null
+++ b/skills/handycontrol-wpf-watermark/references/api.md
@@ -0,0 +1,20 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Watermark
+
+源码：[src/Shared/HandyControl_Shared/Controls/Other/Watermark.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Watermark.cs)
+
+```text
+public class Watermark : Control
+public double Angle
+public object Content
+public object Mark
+public double MarkWidth
+public double MarkHeight
+public Brush MarkBrush
+public bool AutoSizeEnabled
+public Thickness MarkMargin
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-watermark/references/usage.md b/skills/handycontrol-wpf-watermark/references/usage.md
new file mode 100644
index 00000000..3f486d21
--- /dev/null
+++ b/skills/handycontrol-wpf-watermark/references/usage.md
@@ -0,0 +1,17 @@
+# Watermark 水印 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/watermark/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/watermark/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/watermark/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Other/Watermark.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Other/Watermark.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Watermark.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Watermark.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/WatermarkDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/WatermarkDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/WatermarkDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/WatermarkDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf-wave-progress-bar/SKILL.md b/skills/handycontrol-wpf-wave-progress-bar/SKILL.md
new file mode 100644
index 00000000..68694b63
--- /dev/null
+++ b/skills/handycontrol-wpf-wave-progress-bar/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-wave-progress-bar
+description: "实现、配置或排查 HandyControl WPF 的 WaveProgressBar 波形进度条（WaveProgressBar）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF WaveProgressBar 波形进度条
+
+实现或排查 **WaveProgressBar 波形进度条**。相关类型：`WaveProgressBar`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-wave-progress-bar/agents/openai.yaml b/skills/handycontrol-wpf-wave-progress-bar/agents/openai.yaml
new file mode 100644
index 00000000..2be06bab
--- /dev/null
+++ b/skills/handycontrol-wpf-wave-progress-bar/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF WaveProgressBar 波形进度条"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-wave-progress-bar to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-wave-progress-bar/references/api.md b/skills/handycontrol-wpf-wave-progress-bar/references/api.md
new file mode 100644
index 00000000..cd6765c7
--- /dev/null
+++ b/skills/handycontrol-wpf-wave-progress-bar/references/api.md
@@ -0,0 +1,17 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## WaveProgressBar
+
+源码：[src/Shared/HandyControl_Shared/Controls/ProgressBar/WaveProgressBar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/ProgressBar/WaveProgressBar.cs)
+
+```text
+public class WaveProgressBar : RangeBase
+public override void OnApplyTemplate()
+public string Text
+public bool ShowText
+public Brush WaveFill
+public double WaveThickness
+public Brush WaveStroke
+```
diff --git a/skills/handycontrol-wpf-wave-progress-bar/references/usage.md b/skills/handycontrol-wpf-wave-progress-bar/references/usage.md
new file mode 100644
index 00000000..3c638c64
--- /dev/null
+++ b/skills/handycontrol-wpf-wave-progress-bar/references/usage.md
@@ -0,0 +1,15 @@
+# WaveProgressBar 波形进度条 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/waveProgressBar/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/waveProgressBar/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/waveProgressBar/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/ProgressBar/WaveProgressBar.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/ProgressBar/WaveProgressBar.cs)
+
+## 样式及官方示例
+
+
diff --git a/skills/handycontrol-wpf-window/SKILL.md b/skills/handycontrol-wpf-window/SKILL.md
new file mode 100644
index 00000000..abfdfcf4
--- /dev/null
+++ b/skills/handycontrol-wpf-window/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: handycontrol-wpf-window
+description: "实现、配置或排查 HandyControl WPF 的 Window 窗口（Window）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。"
+---
+
+# HandyControl WPF Window 窗口
+
+实现或排查 **Window 窗口**。相关类型：`Window`。
+
+## 接入
+
+程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+XAML 根元素改为 hc:Window 时，code-behind 的基类也必须是 HandyControl.Controls.Window。与 System.Windows.Window 同名，C# 使用别名或全名。
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
diff --git a/skills/handycontrol-wpf-window/agents/openai.yaml b/skills/handycontrol-wpf-window/agents/openai.yaml
new file mode 100644
index 00000000..23f50723
--- /dev/null
+++ b/skills/handycontrol-wpf-window/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF Window 窗口"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf-window to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf-window/references/api.md b/skills/handycontrol-wpf-window/references/api.md
new file mode 100644
index 00000000..daf96cc8
--- /dev/null
+++ b/skills/handycontrol-wpf-window/references/api.md
@@ -0,0 +1,29 @@
+# 源码 API 导航
+
+下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。
+
+## Window
+
+源码：[src/Shared/HandyControl_Shared/Controls/Window/Window.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/Window.cs)
+
+```text
+public class Window : System.Windows.Window
+public Window()
+public object NonClientAreaContent
+public Brush CloseButtonHoverBackground
+public Brush CloseButtonHoverForeground
+public Brush CloseButtonBackground
+public Brush CloseButtonForeground
+public Brush OtherButtonBackground
+public Brush OtherButtonForeground
+public Brush OtherButtonHoverBackground
+public Brush OtherButtonHoverForeground
+public Brush NonClientAreaBackground
+public Brush NonClientAreaForeground
+public double NonClientAreaHeight
+public bool ShowNonClientArea
+public bool ShowTitle
+public bool IsFullScreen
+public bool ShowIcon
+public override void OnApplyTemplate()
+```
diff --git a/skills/handycontrol-wpf-window/references/usage.md b/skills/handycontrol-wpf-window/references/usage.md
new file mode 100644
index 00000000..37fa1627
--- /dev/null
+++ b/skills/handycontrol-wpf-window/references/usage.md
@@ -0,0 +1,17 @@
+# Window 窗口 使用导航
+
+文档：[doc/source/handycontrol/extend_controls/window/index.md](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/extend_controls/window/index.md)
+
+在线文档：[控件说明](https://handyorg.github.io/handycontrol/extend_controls/window/)
+
+按任务阅读原文中的章节：属性、案例。
+
+## 当前源码
+
+- [src/Shared/HandyControl_Shared/Controls/Window/Window.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Controls/Window/Window.cs)
+
+## 样式及官方示例
+
+- [src/Shared/HandyControl_Shared/Themes/Styles/Window.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Window.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/WindowDemo.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/WindowDemo.xaml)
+- [src/Shared/HandyControlDemo_Shared/UserControl/Controls/WindowDemo.xaml.cs](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/UserControl/Controls/WindowDemo.xaml.cs)
diff --git a/skills/handycontrol-wpf/SKILL.md b/skills/handycontrol-wpf/SKILL.md
new file mode 100644
index 00000000..ee8d9fac
--- /dev/null
+++ b/skills/handycontrol-wpf/SKILL.md
@@ -0,0 +1,18 @@
+---
+name: handycontrol-wpf
+description: "在 WPF 项目中接入 HandyControl、选择控件、配置资源或排查 XAML。用于 HandyControl 使用方和本仓库控件开发，不用于 Avalonia 或 Syncfusion。"
+---
+
+# HandyControl WPF
+
+先检查使用方 csproj、App.xaml、现有 MVVM 约定与实际 HandyControl 版本。
+新项目或资源缺失时读 [接入与验证](references/getting-started.md)。
+选择扩展控件时读 [控件索引](references/controls.md)，再调用对应已安装 Skill；
+未安装时可根据索引中的类型与官方文档继续，不假定其他 Skill 必然存在。
+原生控件外观与主题问题读 [样式和主题](references/styling.md)。
+
+本仓库 WPF 共享实现位于 src/Shared/HandyControl_Shared，示例位于
+src/Shared/HandyControlDemo_Shared，项目入口位于 src/Net_GE45 和 src/Net_40。
+src/Avalonia 是独立实现，不能混用。修改库时先查依赖属性、对应样式、Demo，再改动。
+不要直接修改自动合并的 Themes/Theme.xaml；检查 Theme_GE45.txt / Theme_40.txt 和样式源文件。
+保留已有工作区修改。输出实际变更、运行方法及验证限制。
diff --git a/skills/handycontrol-wpf/agents/openai.yaml b/skills/handycontrol-wpf/agents/openai.yaml
new file mode 100644
index 00000000..eb7c0846
--- /dev/null
+++ b/skills/handycontrol-wpf/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+  display_name: "HandyControl WPF"
+  short_description: "Implement HandyControl WPF controls from verified source guidance"
+  default_prompt: "Use $handycontrol-wpf to implement the requested HandyControl WPF UI."
diff --git a/skills/handycontrol-wpf/references/controls.md b/skills/handycontrol-wpf/references/controls.md
new file mode 100644
index 00000000..2eaee034
--- /dev/null
+++ b/skills/handycontrol-wpf/references/controls.md
@@ -0,0 +1,85 @@
+# 扩展控件索引
+
+每行对应可单独安装的 Skill。仅有原生样式需求时选择 handycontrol-wpf-native-styles。
+
+| Skill | 控件 | 类型 |
+|---|---|---|
+| `handycontrol-wpf-animation-path` | [AnimationPath 动画路径](https://handyorg.github.io/handycontrol/extend_controls/animationPath/) | AnimationPath |
+| `handycontrol-wpf-badge` | [Badge 标记](https://handyorg.github.io/handycontrol/extend_controls/badge/) | Badge |
+| `handycontrol-wpf-blur-window` | [BlurWindow 背景模糊窗口](https://handyorg.github.io/handycontrol/extend_controls/blurWindow/) | BlurWindow |
+| `handycontrol-wpf-button-group` | [ButtonGroup 按钮组](https://handyorg.github.io/handycontrol/extend_controls/buttonGroup/) | ButtonGroup |
+| `handycontrol-wpf-calendar-with-clock` | [CalendarWithClock 带有时钟的日历](https://handyorg.github.io/handycontrol/extend_controls/calendarWithClock/) | CalendarWithClock |
+| `handycontrol-wpf-card` | [Card 卡片](https://handyorg.github.io/handycontrol/extend_controls/card/) | Card |
+| `handycontrol-wpf-carousel` | [Carousel 轮播](https://handyorg.github.io/handycontrol/extend_controls/carousel/) | Carousel |
+| `handycontrol-wpf-chat-bubble` | [ChatBubble 对话气泡](https://handyorg.github.io/handycontrol/extend_controls/chatBubble/) | ChatBubble |
+| `handycontrol-wpf-check-combo-box` | [CheckComboBox 复选组合框](https://handyorg.github.io/handycontrol/extend_controls/checkComboBox/) | CheckComboBox |
+| `handycontrol-wpf-circle-panel` | [CirclePanel 圆形布局](https://handyorg.github.io/handycontrol/extend_controls/circlePanel/) | CirclePanel |
+| `handycontrol-wpf-circle-progress-bar` | [CircleProgressBar 圆形进度条](https://handyorg.github.io/handycontrol/extend_controls/circleProgressBar/) | CircleProgressBar |
+| `handycontrol-wpf-clock` | [Clock 时钟](https://handyorg.github.io/handycontrol/extend_controls/clock/) | Clock |
+| `handycontrol-wpf-color-picker` | [ColorPicker 颜色拾取器](https://handyorg.github.io/handycontrol/extend_controls/colorPicker/) | ColorPicker |
+| `handycontrol-wpf-combo-box` | [ComboBox 组合框](https://handyorg.github.io/handycontrol/extend_controls/comboBox/) | ComboBox |
+| `handycontrol-wpf-compare-slider` | [CompareSlider 对比滑块](https://handyorg.github.io/handycontrol/extend_controls/compareSlider/) | CompareSlider |
+| `handycontrol-wpf-context-menu-button` | [ContextMenuButton 上下文菜单按钮](https://handyorg.github.io/handycontrol/extend_controls/contextMenuButton/) | ContextMenuButton |
+| `handycontrol-wpf-cover-flow` | [CoverFlow 封面流](https://handyorg.github.io/handycontrol/extend_controls/coverFlow/) | CoverFlow |
+| `handycontrol-wpf-cover-view` | [CoverView 封面视图](https://handyorg.github.io/handycontrol/extend_controls/coverView/) | CoverView |
+| `handycontrol-wpf-dashed-border` | [DashedBorder 虚线边框](https://handyorg.github.io/handycontrol/extend_controls/dashedBorder/) | DashedBorder |
+| `handycontrol-wpf-date-picker` | [DatePicker 日期选择器](https://handyorg.github.io/handycontrol/extend_controls/datePicker/) | DatePicker |
+| `handycontrol-wpf-date-time-picker` | [DateTimePicker 日期时间选择器](https://handyorg.github.io/handycontrol/extend_controls/dateTimePicker/) | DateTimePicker |
+| `handycontrol-wpf-dialog` | [Dialog 对话框](https://handyorg.github.io/handycontrol/extend_controls/dialog/) | Dialog |
+| `handycontrol-wpf-divider` | [Divider 分割线](https://handyorg.github.io/handycontrol/extend_controls/divider/) | Divider |
+| `handycontrol-wpf-drawer` | [Drawer 抽屉](https://handyorg.github.io/handycontrol/extend_controls/drawer/) | Drawer |
+| `handycontrol-wpf-flip-clock` | [FlipClock 翻页时钟](https://handyorg.github.io/handycontrol/extend_controls/flipClock/) | FlipClock |
+| `handycontrol-wpf-floating-block` | [FloatingBlock 漂浮块](https://handyorg.github.io/handycontrol/extend_controls/floatingBlock/) | FloatingBlock |
+| `handycontrol-wpf-gif-image` | [GifImage Gif图片](https://handyorg.github.io/handycontrol/extend_controls/gifImage/) | GifImage |
+| `handycontrol-wpf-glow-window` | [GlowWindow 辉光窗口](https://handyorg.github.io/handycontrol/extend_controls/glowWindow/) | GlowWindow |
+| `handycontrol-wpf-goto-top` | [GotoTop 回到顶部](https://handyorg.github.io/handycontrol/extend_controls/gotoTop/) | GotoTop |
+| `handycontrol-wpf-gravatar` | [Gravatar 头像](https://handyorg.github.io/handycontrol/extend_controls/gravatar/) | Gravatar |
+| `handycontrol-wpf-grid` | [Grid 栅格](https://handyorg.github.io/handycontrol/extend_controls/grid/) | Row, Col |
+| `handycontrol-wpf-growl` | [Growl 信息通知](https://handyorg.github.io/handycontrol/extend_controls/growl/) | Growl |
+| `handycontrol-wpf-honeycomb-panel` | [HoneycombPanel 蜂窝布局](https://handyorg.github.io/handycontrol/extend_controls/honeycombPanel/) | HoneycombPanel |
+| `handycontrol-wpf-image-block` | [ImageBlock 图片块](https://handyorg.github.io/handycontrol/extend_controls/imageBlock/) | ImageBlock |
+| `handycontrol-wpf-image-browser` | [ImageBrowser 图片浏览器](https://handyorg.github.io/handycontrol/extend_controls/imageBrowser/) | ImageBrowser |
+| `handycontrol-wpf-image-selector` | [ImageSelector 图片选择器](https://handyorg.github.io/handycontrol/extend_controls/imageSelector/) | ImageSelector |
+| `handycontrol-wpf-image-viewer` | [ImageViewer 图片视图](https://handyorg.github.io/handycontrol/extend_controls/imageViewer/) | ImageViewer |
+| `handycontrol-wpf-loading` | [Loading 加载条](https://handyorg.github.io/handycontrol/extend_controls/loading/) | LoadingBase, LoadingLine, LoadingCircle |
+| `handycontrol-wpf-magnifier` | [Magnifier 放大镜](https://handyorg.github.io/handycontrol/extend_controls/magnifier/) | Magnifier |
+| `handycontrol-wpf-message-box` | [MessageBox 消息对话框](https://handyorg.github.io/handycontrol/extend_controls/messageBox/) | MessageBox |
+| `handycontrol-wpf-notification` | [Notification 桌面通知](https://handyorg.github.io/handycontrol/extend_controls/notification/) | Notification |
+| `handycontrol-wpf-notify-icon` | [NotifyIcon 托盘图标](https://handyorg.github.io/handycontrol/extend_controls/notifyIcon/) | NotifyIcon |
+| `handycontrol-wpf-numeric-up-down` | [NumericUpDown 数值选择控件](https://handyorg.github.io/handycontrol/extend_controls/numericUpDown/) | NumericUpDown |
+| `handycontrol-wpf-outline-text` | [OutlineText 轮廓文本](https://handyorg.github.io/handycontrol/extend_controls/outlineText/) | OutlineText |
+| `handycontrol-wpf-pagination` | [Pagination 页码条](https://handyorg.github.io/handycontrol/extend_controls/pagination/) | Pagination |
+| `handycontrol-wpf-password-box` | [PasswordBox 密码框](https://handyorg.github.io/handycontrol/extend_controls/passwordBox/) | PasswordBox |
+| `handycontrol-wpf-pin-box` | [PinBox PIN码框](https://handyorg.github.io/handycontrol/extend_controls/pinBox/) | PinBox |
+| `handycontrol-wpf-pop-tip` | [PopTip 气泡提示](https://handyorg.github.io/handycontrol/extend_controls/popTip/) | Poptip |
+| `handycontrol-wpf-popup-window` | [PopupWindow 弹出窗口](https://handyorg.github.io/handycontrol/extend_controls/popupWindow/) | PopupWindow |
+| `handycontrol-wpf-preview-slider` | [PreviewSlider 预览滑块](https://handyorg.github.io/handycontrol/extend_controls/previewSlider/) | PreviewSlider |
+| `handycontrol-wpf-progress-button` | [ProgressButton 进度按钮](https://handyorg.github.io/handycontrol/extend_controls/progressButton/) | ProgressButton |
+| `handycontrol-wpf-property-grid` | [PropertyGrid 属性编辑器](https://handyorg.github.io/handycontrol/extend_controls/propertyGrid/) | PropertyGrid, PlainTextPropertyEditor |
+| `handycontrol-wpf-range-slider` | [RangeSlider 范围滑块](https://handyorg.github.io/handycontrol/extend_controls/rangeSlider/) | TwoWayRangeBase, RangeSlider |
+| `handycontrol-wpf-rate` | [Rate 评分](https://handyorg.github.io/handycontrol/extend_controls/rate/) | SimpleItemsControl, RegularItemsControl, Rate |
+| `handycontrol-wpf-relative-panel` | [RelativePanel 相对布局](https://handyorg.github.io/handycontrol/extend_controls/relativePanel/) | RelativePanel |
+| `handycontrol-wpf-running-block` | [RunningBlock 滚动块](https://handyorg.github.io/handycontrol/extend_controls/runningBlock/) | RunningBlock |
+| `handycontrol-wpf-screenshot` | [Screenshot 截图](https://handyorg.github.io/handycontrol/extend_controls/screenshot/) | Screenshot |
+| `handycontrol-wpf-scroll-viewer` | [ScrollViewer 滚动视图](https://handyorg.github.io/handycontrol/extend_controls/scrollViewer/) | ScrollViewer |
+| `handycontrol-wpf-search-bar` | [SearchBar 搜索栏](https://handyorg.github.io/handycontrol/extend_controls/searchBar/) | SearchBar |
+| `handycontrol-wpf-shield` | [Shield 徽章](https://handyorg.github.io/handycontrol/extend_controls/shield/) | Shield |
+| `handycontrol-wpf-side-menu` | [SideMenu 侧边菜单](https://handyorg.github.io/handycontrol/extend_controls/sideMenu/) | SimpleItemsControl, HeaderedSimpleItemsControl, SideMenu |
+| `handycontrol-wpf-simple-items-control` | [SimpleItemsControl 简单项目控件](https://handyorg.github.io/handycontrol/extend_controls/simpleItemsControl/) | SimpleItemsControl |
+| `handycontrol-wpf-simple-panel` | [SimplePanel 简单面板](https://handyorg.github.io/handycontrol/extend_controls/simplePanel/) | SimplePanel |
+| `handycontrol-wpf-simple-text` | [SimpleText 简单文本](https://handyorg.github.io/handycontrol/extend_controls/simpleText/) | SimpleText |
+| `handycontrol-wpf-split-button` | [SplitButton 分割按钮](https://handyorg.github.io/handycontrol/extend_controls/splitButton/) | SplitButton |
+| `handycontrol-wpf-sprite` | [Sprite 精灵](https://handyorg.github.io/handycontrol/extend_controls/sprite/) | Sprite |
+| `handycontrol-wpf-step-bar` | [StepBar 步骤条](https://handyorg.github.io/handycontrol/extend_controls/stepBar/) | StepBar |
+| `handycontrol-wpf-tab-control` | [TabControl 选项卡控件](https://handyorg.github.io/handycontrol/extend_controls/tabControl/) | TabControl |
+| `handycontrol-wpf-tag` | [Tag 标签](https://handyorg.github.io/handycontrol/extend_controls/tag/) | Tag |
+| `handycontrol-wpf-text-box` | [TextBox 文本框](https://handyorg.github.io/handycontrol/extend_controls/textBox/) | TextBox |
+| `handycontrol-wpf-time-bar` | [TimeBar 时间条](https://handyorg.github.io/handycontrol/extend_controls/timeBar/) | TimeBar |
+| `handycontrol-wpf-time-picker` | [TimePicker 时间选择器](https://handyorg.github.io/handycontrol/extend_controls/timePicker/) | TimePicker |
+| `handycontrol-wpf-toggle-block` | [ToggleBlock 切换块](https://handyorg.github.io/handycontrol/extend_controls/toggleBlock/) | ToggleBlock |
+| `handycontrol-wpf-transfer` | [Transfer 穿梭框](https://handyorg.github.io/handycontrol/extend_controls/transfer/) | SimpleItemsControl, Transfer |
+| `handycontrol-wpf-transitioning-content-control` | [TransitioningContentControl 内容过渡控件](https://handyorg.github.io/handycontrol/extend_controls/transitioningContentControl/) | TransitioningContentControl |
+| `handycontrol-wpf-waterfall-panel` | [WaterfallPanel 瀑布流](https://handyorg.github.io/handycontrol/extend_controls/waterfallPanel/) | WaterfallPanel |
+| `handycontrol-wpf-watermark` | [Watermark 水印](https://handyorg.github.io/handycontrol/extend_controls/watermark/) | Watermark |
+| `handycontrol-wpf-wave-progress-bar` | [WaveProgressBar 波形进度条](https://handyorg.github.io/handycontrol/extend_controls/waveProgressBar/) | WaveProgressBar |
+| `handycontrol-wpf-window` | [Window 窗口](https://handyorg.github.io/handycontrol/extend_controls/window/) | Window |
diff --git a/skills/handycontrol-wpf/references/getting-started.md b/skills/handycontrol-wpf/references/getting-started.md
new file mode 100644
index 00000000..eee2d266
--- /dev/null
+++ b/skills/handycontrol-wpf/references/getting-started.md
@@ -0,0 +1,75 @@
+# 接入与验证
+
+## 项目与版本
+
+在使用方的 WPF 项目引用 `HandyControl`。保留项目已有版本；新项目先根据目标框架确认兼容的包版本，不自动升级其他依赖。本仓库 `src/Net_GE45/HandyControl_Net_GE45/HandyControl_Net_GE45.csproj` 的版本字段是源码版本依据，不代表 NuGet 当前最新版本。
+
+SDK 项目必须设置 `UseWPF=true`，现代 .NET 使用 Windows TFM，例如 `net8.0-windows`；不要为接入控件擅自改变已有目标框架。旧 .NET Framework 项目沿用已有项目格式。添加引用可使用 `dotnet add <项目.csproj> package HandyControl --version <已确认版本>`，尖括号为待替换参数。
+
+## 应用资源
+
+将下面的字典合并到现有 `Application.Resources`，保留应用已有资源。先加载皮肤，再加载控件主题。不要引用 HandyControlDemo 的主题文件，它们包含示例工程专用资源。
+
+```xml
+<Application.Resources>
+    <ResourceDictionary>
+        <ResourceDictionary.MergedDictionaries>
+            <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml"/>
+            <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/Theme.xaml"/>
+        </ResourceDictionary.MergedDictionaries>
+    </ResourceDictionary>
+</Application.Resources>
+```
+
+在视图根元素声明：
+
+```xml
+xmlns:hc="https://handyorg.github.io/handycontrol"
+```
+
+例如在已有窗口中：
+
+```xml
+<StackPanel Margin="24">
+    <TextBox hc:InfoElement.Placeholder="名称"
+             Style="{StaticResource TextBoxExtend}"
+             Text="{Binding Name, UpdateSourceTrigger=PropertyChanged}"/>
+    <hc:NumericUpDown Margin="0,12,0,0" Minimum="0" Maximum="100"
+                      Increment="1" Value="{Binding Quantity, Mode=TwoWay}"/>
+    <Button Margin="0,12,0,0" Content="保存" Command="{Binding SaveCommand}"
+            Style="{StaticResource ButtonPrimary}"/>
+</StackPanel>
+```
+
+Name、Quantity 和 SaveCommand 由使用方 DataContext 提供，变化通知采用项目已有机制。不要为了示例额外引入 MVVM 框架。
+
+## 类型、绑定与模板
+
+- `Button`、`DataGrid` 等可直接使用原生 WPF 类型配合样式，不要凭名称创造 `hc:Button` 或 `hc:DataGrid`。
+- `hc:TextBox`、`hc:ComboBox`、`hc:Window` 等确实存在，但与原生类型功能不同。C# 同名类型用全名或 alias。
+- `InfoElement`、`TitleElement`、`BorderElement`、`IconElement` 等是附加属性宿主；是否有效取决于实际模板。查 `Controls/Attach` 和 `Themes/Styles`，不能凭其他厂商 API 猜测属性。
+- 事件参数不都使用 WPF 的 `OldValue` / `NewValue`；例如 NumericUpDown.ValueChanged 使用 `FunctionEventArgs<double>.Info`。
+- 自定义模板保留源码 `TemplatePart` 声明的 `PART_*`，并确认模板需要的命令绑定和资源。
+
+## 验证与排错
+
+先构建使用方项目，例如 `dotnet build <项目.csproj> -f <目标框架>`。本库多目标项目应显式选定目标框架，不为文档改动无差别构建全部历史框架。
+
+构建通过后，在 Windows 上打开实际窗口，检查资源加载、初始值、绑定更新、空数据、边界和销毁后的事件订阅。编译成功不能证明动态资源与绑定在运行时有效。
+
+| 症状 | 检查位置 |
+|---|---|
+| 找不到 hc 类型 | 包引用、TFM、XAML 命名空间、AssemblyInfo.XmlnsDefinition、类型是否属于 Avalonia |
+| 控件无模板或资源未找到 | App.xaml 的皮肤/主题顺序、重复字典、资源键大小写、Style.TargetType |
+| ViewModel 没有更新 | DataContext、绑定错误输出、Mode、UpdateSourceTrigger、属性变化通知 |
+| Dialog 不显示 | 活动窗口、AdornerDecorator，或 token 对应的 DialogContainer |
+| Growl 不显示/显示错窗口 | 宿主 Panel、GrowlParent/Token、调用范围和 Dispatcher |
+
+## 源码依据
+
+路径均相对于 HandyControl 仓库根目录。在仓库外可以访问对应链接；对已发布版本应切换到匹配 tag 或提交，避免把 master 新成员用于旧包。
+
+- [快速开始](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/quick_start/index.md)
+- [WPF 项目](https://github.com/HandyOrg/HandyControl/blob/master/src/Net_GE45/HandyControl_Net_GE45/HandyControl_Net_GE45.csproj)
+- [命名空间映射](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Properties/AssemblyInfo.cs)
+- [官方 Demo 资源配置](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/App.xaml)
diff --git a/skills/handycontrol-wpf/references/styling.md b/skills/handycontrol-wpf/references/styling.md
new file mode 100644
index 00000000..fb1919ed
--- /dev/null
+++ b/skills/handycontrol-wpf/references/styling.md
@@ -0,0 +1,41 @@
+# 皮肤、主题与资源
+
+## 静态字典方案
+
+`SkinDefault.xaml`、`SkinDark.xaml`、`SkinViolet.xaml` 是皮肤字典；`Theme.xaml` 提供控件主题。先合并一个皮肤，再合并主题，应用自己的覆盖资源置于其后。通过 `DynamicResource` 引用需要随皮肤变化的颜色和画刷，例如 `PrimaryBrush`、`RegionBrush`；显式样式键通常用 `StaticResource`。
+
+```xml
+<ResourceDictionary.MergedDictionaries>
+    <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/SkinDark.xaml"/>
+    <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/Theme.xaml"/>
+</ResourceDictionary.MergedDictionaries>
+```
+
+这是现有 ResourceDictionary 内的片段，不应额外嵌套 Application.Resources。运行时更换静态皮肤时替换由应用持有的那一个皮肤字典，保留其他字典和顺序，不清空全部 MergedDictionaries。
+
+## Theme 对象方案
+
+当前源码还提供 `HandyControl.Themes.Theme : ResourceDictionary`，其 `Skin` 为 `HandyControl.Data.SkinType`；可以用 Theme 对象管理皮肤。采用此方案时先读取 `Themes/Theme.cs` 的构造和更新逻辑，避免同时再加载一套静态主题字典。
+
+```xml
+<ResourceDictionary.MergedDictionaries>
+    <hc:Theme Skin="Dark"/>
+</ResourceDictionary.MergedDictionaries>
+```
+
+`hc` 对应 `https://handyorg.github.io/handycontrol`。修改 Theme 实例的 Skin 需要保留对该实例的引用；自动跟随系统、强调色等能力以实际版本的 Theme 源码属性为准。
+
+## 调整外观
+
+先找到控件对应的 `Themes/Styles/<控件>.xaml`，核对 x:Key、TargetType、BasedOn 和 TemplateBinding。能通过公开属性或附加属性完成的改动优先使用这些接口；确需重写模板时保留必需的 PART_* 名称。
+
+本仓库 `Themes/Theme.xaml` 由 `XamlCombine.exe` 和 `Theme_GE45.txt` / `Theme_40.txt` 合并。修改相应样式源文件及必要的清单，再按项目构建流程生成；不要把合并文件当作唯一维护入口。使用方项目通常只需要覆盖自己的资源。
+
+先检查工作区已有修改，尤其颜色和主题文件，避免覆盖用户的定制。验证浅色、深色切换时检查文本对比度、禁用态、弹出层及局部资源覆盖；无法运行 UI 时说明限制。
+
+## 源码依据
+
+- [Theme 实现](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Theme.cs)
+- [皮肤枚举](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Data/Enum/SkinType.cs)
+- [样式源目录](https://github.com/HandyOrg/HandyControl/tree/master/src/Shared/HandyControl_Shared/Themes/Styles)
+- [主题合并清单](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Theme_GE45.txt)
diff --git a/skills/scripts/build_skills.py b/skills/scripts/build_skills.py
new file mode 100644
index 00000000..4cf068f2
--- /dev/null
+++ b/skills/scripts/build_skills.py
@@ -0,0 +1,246 @@
+"""Build portable WPF skills from this checkout; no network or third-party modules."""
+import argparse
+import json
+import re
+from pathlib import Path
+from xml.etree import ElementTree as ET
+
+ROOT = Path(__file__).resolve().parents[2]
+OUT = ROOT / 'skills'
+LIB = ROOT / 'src/Shared/HandyControl_Shared'
+DOC = ROOT / 'doc/source/handycontrol'
+REMOTE = 'https://github.com/HandyOrg/HandyControl/blob/master/'
+CLASS = re.compile(r'public\s+(?:(?:abstract|static|partial|sealed)\s+)*class\s+(\w+)(?:\s*:\s*([^\r\n{]+))?')
+
+
+def read(path):
+    return path.read_text(encoding='utf-8-sig')
+
+
+def slug(name):
+    return re.sub(r'(?<=[a-z0-9])(?=[A-Z])', '-', name).lower()
+
+
+def link(path):
+    rel = path.relative_to(ROOT).as_posix()
+    return f'[{rel}]({REMOTE}{rel})'
+
+
+def source_index():
+    result = {}
+    for path in sorted((LIB / 'Controls').rglob('*.cs')):
+        for match in CLASS.finditer(read(path)):
+            result.setdefault(match[1], []).append((path, (match[2] or '').strip()))
+    return result
+
+
+def short_example(text, names, index):
+    """Keep only self-contained, XML-parseable examples without Demo dependencies."""
+    candidates = []
+    for match in re.finditer(r'```\s*(?:xml|xaml)\s*\n(.*?)```', text, re.S | re.I):
+        snippet = match[1].strip()
+        if len(snippet.splitlines()) > 16 or not any(f'<hc:{n}' in snippet for n in names):
+            continue
+        if re.search(r'x:Class|x:Static|HandyControlDemo|\b(?:langs|ex|local|viewModel|system):|\.(?:png|jpg|gif|xaml|ico)', snippet):
+            continue
+        if re.search(r'\{(?:StaticResource|DynamicResource|Binding)', snippet):
+            continue
+        try:
+            element = ET.fromstring('<Root xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" '
+                                    'xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" '
+                                    'xmlns:hc="https://handyorg.github.io/handycontrol">' + snippet + '</Root>')
+        except ET.ParseError:
+            continue
+        types = [e.tag.split('}')[1].split('.')[0] for e in element.iter()
+                 if e.tag.startswith('{https://handyorg.github.io/handycontrol}')]
+        if not all(n in index for n in types):
+            continue
+        candidates.append(snippet)
+    return ('xml', min(candidates, key=len)) if candidates else None
+
+
+def api_reference(names, index):
+    sections = ['# 源码 API 导航\n',
+                '下面是当前工作区的声明摘录，不是完整 C# 文件，不包含全部继承成员、访问器和条件编译条件。'
+                '属性是否可写、依赖属性默认值、枚举成员和目标框架限制，需打开对应源码核对。\n']
+    visited = set()
+
+    def append(name):
+        if name in visited or name not in index:
+            return
+        visited.add(name)
+        for path, base in index[name]:
+            text = read(path)
+            declarations = []
+            for line in text.splitlines():
+                line = line.strip()
+                if not line.startswith('public ') or 'DependencyProperty ' in line or 'RoutedEvent ' in line:
+                    continue
+                # Declaration headers only: never present extracted implementation as compilable code.
+                line = re.split(r'\s*=>|\s*\{', line, maxsplit=1)[0]
+                declarations.append(line)
+            sections.extend([f'## {name}\n', f'源码：{link(path)}\n',
+                             '```text\n' + '\n'.join(dict.fromkeys(declarations)) + '\n```\n'])
+            parent = base.split(',')[0].strip()
+            if parent in index:
+                append(parent)
+
+    for name in names:
+        append(name)
+    return '\n'.join(sections)
+
+
+SETUP = '''程序集/NuGet 为 `HandyControl`，XAML 命名空间为
+`xmlns:hc="https://handyorg.github.io/handycontrol"`，C# 控件命名空间为 `HandyControl.Controls`。
+在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`，
+然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
+已有主题配置时先检查，避免重复合并。版本和目标框架以使用方项目为准。
+'''
+
+NOTES = {
+    'numericUpDown': 'Value 是 double；范围属性是 Minimum / Maximum，步长是 Increment，不能照搬 Syncfusion 的 MinValue / MaxValue / Step。DecimalPlaces 为 int?，仅控制显示。ValueChanged 的事件参数使用 FunctionEventArgs<double>，读取 Info；绑定时显式指定 Mode=TwoWay。',
+    'dialog': 'Dialog.Show 返回覆盖层 Dialog，不等于 Window.ShowDialog。无 token 时依赖活动窗口的 AdornerDecorator；指定 token 时先配置 Dialog.Token 和 DialogContainer。关闭使用返回实例的 Close()。异步结果需要实现库要求的结果接口并引入扩展命名空间，不能直接假定存在任意 Task 返回值。',
+    'growl': 'Growl 是通知 API 与控件的组合。页面内通知需要 Panel 上的 Growl.GrowlParent 或 Growl.Token；多窗口使用唯一 token。普通通知与 Global 方法的显示范围不同。后台任务更新 UI 先切回 Dispatcher。',
+    'grid': '这里的栅格是 hc:Row 与 hc:Col，采用 24 列；不是 hc:Grid。布局使用 Span、Offset、Gutter 等当前源码属性。',
+    'loading': 'LoadingBase 是抽象基类，实际使用 LoadingLine 或 LoadingCircle；耗时任务异步执行，避免阻塞动画线程。',
+    'window': 'XAML 根元素改为 hc:Window 时，code-behind 的基类也必须是 HandyControl.Controls.Window。与 System.Windows.Window 同名，C# 使用别名或全名。',
+    'textBox': 'hc:TextBox 与原生 TextBox 的样式方案不同。先确定使用的类型，再设置标题、占位和验证属性；不要假定 WPF PasswordBox 或其他输入框都支持 Text 绑定。',
+    'passwordBox': '区分 HandyControl.Controls.PasswordBox 与原生 System.Windows.Controls.PasswordBox；核对 Password 的属性定义和绑定机制，不在日志中输出密码。',
+    'messageBox': '使用 HandyControl.Controls.MessageBox 全名或别名以避免与 System.Windows.MessageBox 混淆；按实际重载处理 MessageBoxResult。',
+    'pagination': '绑定页码与数据加载逻辑时检查页码基准、总数变化及边界，事件参数以源码声明为准。',
+    'propertyGrid': '先确认 SelectedObject 的实际类型及属性可读写性，再选择编辑器；自定义编辑器需要实现库内 PropertyEditorBase 约定。',
+}
+
+EXAMPLES = {
+    'numericUpDown': ('xml', '<hc:NumericUpDown Minimum="0" Maximum="100" Increment="0.5"\n                  DecimalPlaces="2" Value="{Binding Amount, Mode=TwoWay}"/>'),
+    'grid': ('xml', '<hc:Row Gutter="12">\n    <hc:Col Span="12"><TextBlock Text="左列"/></hc:Col>\n    <hc:Col Span="12"><TextBlock Text="右列"/></hc:Col>\n</hc:Row>'),
+    'loading': ('xml', '<hc:LoadingCircle IsRunning="{Binding IsBusy}"/>'),
+    'dialog': ('csharp', '// 在已显示且具备装饰层的 WPF 窗口的 UI 线程执行。\nvar dialog = HandyControl.Controls.Dialog.Show(new System.Windows.Controls.TextBlock\n{\n    Text = "正在处理"\n});\n// 操作完成后关闭。\ndialog.Close();'),
+    'growl': ('xml', '<!-- 在窗口可视树中声明；加载后在 UI 线程调用 Growl.Success("保存成功")。 -->\n<StackPanel hc:Growl.GrowlParent="True"/>'),
+}
+
+
+def skill_files(name, title, description, body, refs=None):
+    files = {
+        f'{name}/SKILL.md': f'---\nname: {name}\ndescription: {json.dumps(description, ensure_ascii=False)}\n---\n\n# {title}\n\n{body.strip()}\n',
+        f'{name}/agents/openai.yaml': 'interface:\n' +
+        f'  display_name: {json.dumps(title, ensure_ascii=False)}\n' +
+        '  short_description: "Implement HandyControl WPF controls from verified source guidance"\n' +
+        f'  default_prompt: "Use ${name} to implement the requested HandyControl WPF UI."\n',
+    }
+    for path, content in (refs or {}).items():
+        files[f'{name}/references/{path}'] = content
+    return files
+
+
+def build():
+    index = source_index()
+    files, rows = {}, []
+    for doc in sorted((DOC / 'extend_controls').glob('*/index.md')):
+        text, key = read(doc), doc.parent.name
+        title = re.search(r'^title:\s*(.+)$', text, re.M)[1].strip()
+        names = list(dict.fromkeys(m[0] for m in CLASS.findall(text)))
+        names = [n for n in names if n in index]
+        if not names:
+            names = [n for n in index if n.lower() == key.lower()]
+        if not names:
+            raise ValueError(f'No source mapping for {doc}')
+        name = 'handycontrol-wpf-' + slug(key)
+        doc_url = f'https://handyorg.github.io/handycontrol/extend_controls/{key}/'
+        headings = [m[1].strip() for m in re.finditer(r'^#{1,3}\s+(.+)$', text, re.M)]
+        demos = sorted(p for p in (ROOT / 'src/Shared/HandyControlDemo_Shared').rglob('*')
+                       if p.is_file() and any(p.name.lower() in (n.lower() + 'demo.xaml', n.lower() + 'demo.xaml.cs') for n in names))
+        styles = sorted(p for p in (LIB / 'Themes/Styles').glob('*.xaml') if p.stem.lower() in {n.lower() for n in names})
+        evidence = f'# {title} 使用导航\n\n文档：{link(doc)}\n\n在线文档：[控件说明]({doc_url})\n\n'
+        evidence += '按任务阅读原文中的章节：' + '、'.join(headings) + '。\n\n'
+        evidence += '## 当前源码\n\n' + '\n'.join('- ' + link(p) for n in names for p, _ in index[n]) + '\n\n'
+        evidence += '## 样式及官方示例\n\n' + '\n'.join('- ' + link(p) for p in styles + demos) + '\n'
+        body = f'''实现或排查 **{title}**。相关类型：{', '.join(f'`{n}`' for n in names)}。
+
+## 接入
+
+{SETUP}
+## 实现
+
+先读 [API 声明与继承关系](references/api.md)，再按需求查看
+[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录；
+在本仓库优先读本地文件，安装到其他项目后使用内附声明与链接，遇到版本差异检查实际引用版本的源码。
+不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
+
+{NOTES.get(key, '结合基类确认内容模型、绑定属性和事件参数；集合控件区分 ItemsSource、选中项与 ItemTemplate；修改样式前核对资源键和模板部件。')}
+
+用目标项目现有的 MVVM 方式绑定；需要回写时明确 TwoWay 和更新时机，
+不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
+交付时运行目标框架的构建，并在窗口加载后检查模板、绑定错误、空值和相关输入边界；
+无法运行 WPF 时明确说明尚未验证 UI 行为。
+'''
+        example_pair = EXAMPLES.get(key) or short_example(text, names, index)
+        if example_pair:
+            language, example = example_pair
+            body += f'\n## 最小片段\n\n依赖上面的应用资源配置；Binding 路径由使用方 ViewModel 提供。\n\n```{language}\n{example}\n```\n'
+        files.update(skill_files(name, 'HandyControl WPF ' + title,
+                     f'实现、配置或排查 HandyControl WPF 的 {title}（{", ".join(names)}）。适用于该扩展控件的 XAML、绑定、事件和模板；不用于 Avalonia 或其他厂商控件。',
+                     body, {'api.md': api_reference(names, index), 'usage.md': evidence}))
+        rows.append((name, title, key, names))
+
+    catalog = '# 扩展控件索引\n\n每行对应可单独安装的 Skill。仅有原生样式需求时选择 handycontrol-wpf-native-styles。\n\n| Skill | 控件 | 类型 |\n|---|---|---|\n'
+    catalog += '\n'.join(f'| `{n}` | [{t}](https://handyorg.github.io/handycontrol/extend_controls/{k}/) | {", ".join(types)} |' for n, t, k, types in rows) + '\n'
+    setup = read(OUT / 'templates/getting-started.md')
+    files.update(skill_files('handycontrol-wpf', 'HandyControl WPF',
+        '在 WPF 项目中接入 HandyControl、选择控件、配置资源或排查 XAML。用于 HandyControl 使用方和本仓库控件开发，不用于 Avalonia 或 Syncfusion。',
+        '''先检查使用方 csproj、App.xaml、现有 MVVM 约定与实际 HandyControl 版本。
+新项目或资源缺失时读 [接入与验证](references/getting-started.md)。
+选择扩展控件时读 [控件索引](references/controls.md)，再调用对应已安装 Skill；
+未安装时可根据索引中的类型与官方文档继续，不假定其他 Skill 必然存在。
+原生控件外观与主题问题读 [样式和主题](references/styling.md)。
+
+本仓库 WPF 共享实现位于 src/Shared/HandyControl_Shared，示例位于
+src/Shared/HandyControlDemo_Shared，项目入口位于 src/Net_GE45 和 src/Net_40。
+src/Avalonia 是独立实现，不能混用。修改库时先查依赖属性、对应样式、Demo，再改动。
+不要直接修改自动合并的 Themes/Theme.xaml；检查 Theme_GE45.txt / Theme_40.txt 和样式源文件。
+保留已有工作区修改。输出实际变更、运行方法及验证限制。
+''', {'getting-started.md': setup, 'controls.md': catalog, 'styling.md': read(OUT / 'templates/styling.md')}))
+    for name, title, desc, template in [
+        ('handycontrol-wpf-theming', 'HandyControl WPF 主题', '配置 HandyControl WPF 的皮肤、资源字典、动态颜色和主题切换；排查资源键与控件样式，不用于 Avalonia。', 'styling.md'),
+        ('handycontrol-wpf-native-styles', 'HandyControl WPF 原生控件样式', '为原生 WPF Button、TextBox、DataGrid、ListBox 等应用 HandyControl 样式和附加属性，区分原生与 hc 同名控件。', 'native-styles.md'),
+    ]:
+        files.update(skill_files(name, title, desc,
+            SETUP + '\n按任务阅读 [配置及示例](references/usage.md)。先确认控件实际 CLR 类型和样式 TargetType，再修改资源。\n',
+            {'usage.md': read(OUT / 'templates' / template)}))
+    # Native styles are read from XML, so resource keys cannot drift silently.
+    native = files['handycontrol-wpf-native-styles/references/usage.md']
+    for doc in sorted((DOC / 'native_controls').glob('*/index.md')):
+        candidates = [p for p in (LIB / 'Themes/Styles').glob('*.xaml') if p.stem.lower() == doc.parent.name.lower()]
+        for path in candidates:
+            tree = ET.fromstring(read(path))
+            keys = [e.attrib['{http://schemas.microsoft.com/winfx/2006/xaml}Key'] for e in tree.iter()
+                    if e.tag.endswith('}Style') and '{http://schemas.microsoft.com/winfx/2006/xaml}Key' in e.attrib]
+            native += f'\n## {doc.parent.name}\n\n{link(path)}\n\n显式样式键：' + '、'.join(f'`{k}`' for k in keys) + '\n'
+    files['handycontrol-wpf-native-styles/references/usage.md'] = native
+    files['catalog.json'] = json.dumps({'skills': sorted({p.split('/')[0] for p in files})}, indent=2) + '\n'
+    return files
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('--check', action='store_true', help='Check snapshots without writing')
+    args = parser.parse_args()
+    files = build()
+    stale = []
+    for rel, content in files.items():
+        path = OUT / rel
+        if args.check:
+            if not path.exists() or read(path) != content:
+                stale.append(rel)
+        else:
+            path.parent.mkdir(parents=True, exist_ok=True)
+            path.write_text(content, encoding='utf-8', newline='\n')
+    expected = {p.split('/')[0] for p in files if p.endswith('/SKILL.md')}
+    stale.extend(str(p.parent.relative_to(OUT)) for p in OUT.glob('*/SKILL.md') if p.parent.name not in expected)
+    if stale:
+        raise SystemExit('Stale or unexpected skill files:\n' + '\n'.join(stale))
+    print(f'{"Checked" if args.check else "Generated"} {len(expected)} skills / {len(files)} files')
+
+
+if __name__ == '__main__':
+    main()
diff --git a/skills/scripts/install_skills.py b/skills/scripts/install_skills.py
new file mode 100644
index 00000000..2eb92388
--- /dev/null
+++ b/skills/scripts/install_skills.py
@@ -0,0 +1,53 @@
+"""Install selected repository skills into Codex or another skill directory."""
+import argparse
+import os
+from pathlib import Path
+import re
+import shutil
+
+SOURCE = Path(__file__).resolve().parents[1]
+
+
+def linked(path):
+    return path.is_symlink() or getattr(path, 'is_junction', lambda: False)()
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('names', nargs='*', help='Skill folder names; defaults to handycontrol-wpf')
+    parser.add_argument('--all', action='store_true', help='Install all component skills')
+    parser.add_argument('--dest', type=Path, default=Path(os.environ.get('CODEX_HOME', str(Path.home() / '.codex'))) / 'skills')
+    parser.add_argument('--force', action='store_true', help='Replace files in existing skill folders')
+    parser.add_argument('--list', action='store_true')
+    args = parser.parse_args()
+    available = sorted(p.parent.name for p in SOURCE.glob('*/SKILL.md'))
+    if args.list:
+        print('\n'.join(available))
+        return
+    if args.all and args.names:
+        parser.error('Use names or --all, not both')
+    names = available if args.all else list(dict.fromkeys(args.names or ['handycontrol-wpf']))
+    destination = args.dest.expanduser().resolve()
+    # Preflight every selection before copying anything. No deletes, no shell execution.
+    for name in names:
+        if not re.fullmatch(r'handycontrol-wpf(?:-[a-z0-9]+)*', name) or name not in available:
+            parser.error(f'Unknown skill: {name}')
+        target = destination / name
+        if target.resolve().is_relative_to(SOURCE.resolve()) or SOURCE.resolve().is_relative_to(target.resolve()):
+            parser.error(f'Destination overlaps repository skills: {target}')
+        if linked(target):
+            parser.error(f'Destination must not be a link: {target}')
+        if target.exists() and not args.force:
+            parser.error(f'Already exists: {target}; use --force to update files')
+        if target.exists() and not target.is_dir():
+            parser.error(f'Not a directory: {target}')
+        # Refuse linked descendants too, including when updating an existing skill.
+        if target.exists() and any(linked(p) for p in target.rglob('*')):
+            parser.error(f'Destination contains links: {target}')
+    for name in names:
+        shutil.copytree(SOURCE / name, destination / name, dirs_exist_ok=args.force)
+        print(f'Installed {name} -> {destination / name}')
+
+
+if __name__ == '__main__':
+    main()
diff --git a/skills/scripts/validate_skills.py b/skills/scripts/validate_skills.py
new file mode 100644
index 00000000..8104806a
--- /dev/null
+++ b/skills/scripts/validate_skills.py
@@ -0,0 +1,59 @@
+"""Validate generated skill structure, local/source links and XML snippet syntax."""
+import json
+from pathlib import Path
+import re
+import subprocess
+import sys
+from xml.etree import ElementTree as ET
+
+ROOT = Path(__file__).resolve().parents[2]
+SKILLS = ROOT / 'skills'
+
+
+def main():
+    subprocess.run([sys.executable, str(SKILLS / 'scripts/build_skills.py'), '--check'], check=True)
+    manifest = json.loads((SKILLS / 'catalog.json').read_text(encoding='utf-8'))['skills']
+    errors = []
+    snippets = 0
+    for name in manifest:
+        folder = SKILLS / name
+        text = (folder / 'SKILL.md').read_text(encoding='utf-8')
+        front = re.match(r'---\nname: ([a-z0-9-]+)\ndescription: (.+)\n---\n', text)
+        if not front or front[1] != name or len(name) > 64:
+            errors.append(f'{name}: invalid frontmatter')
+            continue
+        description = json.loads(front[2])
+        if not 1 <= len(description) <= 1024 or '<' in description or '>' in description:
+            errors.append(f'{name}: invalid description')
+        agent = folder / 'agents/openai.yaml'
+        if f'${name}' not in agent.read_text(encoding='utf-8'):
+            errors.append(f'{name}: missing invocation prompt')
+        for path in folder.rglob('*.md'):
+            content = path.read_text(encoding='utf-8')
+            for target in re.findall(r'\]\(([^)]+)\)', content):
+                if target.startswith('https://github.com/HandyOrg/HandyControl/blob/master/'):
+                    local = ROOT / target.split('/blob/master/', 1)[1]
+                    if not local.is_file():
+                        errors.append(f'{path}: missing source {target}')
+                elif '://' not in target and not target.startswith('#'):
+                    local = path.parent / target.split('#')[0]
+                    if not local.is_file():
+                        errors.append(f'{path}: missing reference {target}')
+            for snippet in re.findall(r'```xml\n(.*?)```', content, re.S):
+                # Namespace declaration is intentionally just an attribute, not an element.
+                if snippet.lstrip().startswith('xmlns:'):
+                    continue
+                try:
+                    ET.fromstring('<Root xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" '
+                                  'xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" '
+                                  'xmlns:hc="https://handyorg.github.io/handycontrol">' + snippet + '</Root>')
+                    snippets += 1
+                except ET.ParseError as exc:
+                    errors.append(f'{path}: invalid XML: {exc}')
+    if errors:
+        raise SystemExit('\n'.join(errors))
+    print(f'Validated {len(manifest)} skills; {snippets} XML fragments; all local/source links resolve')
+
+
+if __name__ == '__main__':
+    main()
diff --git a/skills/templates/getting-started.md b/skills/templates/getting-started.md
new file mode 100644
index 00000000..eee2d266
--- /dev/null
+++ b/skills/templates/getting-started.md
@@ -0,0 +1,75 @@
+# 接入与验证
+
+## 项目与版本
+
+在使用方的 WPF 项目引用 `HandyControl`。保留项目已有版本；新项目先根据目标框架确认兼容的包版本，不自动升级其他依赖。本仓库 `src/Net_GE45/HandyControl_Net_GE45/HandyControl_Net_GE45.csproj` 的版本字段是源码版本依据，不代表 NuGet 当前最新版本。
+
+SDK 项目必须设置 `UseWPF=true`，现代 .NET 使用 Windows TFM，例如 `net8.0-windows`；不要为接入控件擅自改变已有目标框架。旧 .NET Framework 项目沿用已有项目格式。添加引用可使用 `dotnet add <项目.csproj> package HandyControl --version <已确认版本>`，尖括号为待替换参数。
+
+## 应用资源
+
+将下面的字典合并到现有 `Application.Resources`，保留应用已有资源。先加载皮肤，再加载控件主题。不要引用 HandyControlDemo 的主题文件，它们包含示例工程专用资源。
+
+```xml
+<Application.Resources>
+    <ResourceDictionary>
+        <ResourceDictionary.MergedDictionaries>
+            <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml"/>
+            <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/Theme.xaml"/>
+        </ResourceDictionary.MergedDictionaries>
+    </ResourceDictionary>
+</Application.Resources>
+```
+
+在视图根元素声明：
+
+```xml
+xmlns:hc="https://handyorg.github.io/handycontrol"
+```
+
+例如在已有窗口中：
+
+```xml
+<StackPanel Margin="24">
+    <TextBox hc:InfoElement.Placeholder="名称"
+             Style="{StaticResource TextBoxExtend}"
+             Text="{Binding Name, UpdateSourceTrigger=PropertyChanged}"/>
+    <hc:NumericUpDown Margin="0,12,0,0" Minimum="0" Maximum="100"
+                      Increment="1" Value="{Binding Quantity, Mode=TwoWay}"/>
+    <Button Margin="0,12,0,0" Content="保存" Command="{Binding SaveCommand}"
+            Style="{StaticResource ButtonPrimary}"/>
+</StackPanel>
+```
+
+Name、Quantity 和 SaveCommand 由使用方 DataContext 提供，变化通知采用项目已有机制。不要为了示例额外引入 MVVM 框架。
+
+## 类型、绑定与模板
+
+- `Button`、`DataGrid` 等可直接使用原生 WPF 类型配合样式，不要凭名称创造 `hc:Button` 或 `hc:DataGrid`。
+- `hc:TextBox`、`hc:ComboBox`、`hc:Window` 等确实存在，但与原生类型功能不同。C# 同名类型用全名或 alias。
+- `InfoElement`、`TitleElement`、`BorderElement`、`IconElement` 等是附加属性宿主；是否有效取决于实际模板。查 `Controls/Attach` 和 `Themes/Styles`，不能凭其他厂商 API 猜测属性。
+- 事件参数不都使用 WPF 的 `OldValue` / `NewValue`；例如 NumericUpDown.ValueChanged 使用 `FunctionEventArgs<double>.Info`。
+- 自定义模板保留源码 `TemplatePart` 声明的 `PART_*`，并确认模板需要的命令绑定和资源。
+
+## 验证与排错
+
+先构建使用方项目，例如 `dotnet build <项目.csproj> -f <目标框架>`。本库多目标项目应显式选定目标框架，不为文档改动无差别构建全部历史框架。
+
+构建通过后，在 Windows 上打开实际窗口，检查资源加载、初始值、绑定更新、空数据、边界和销毁后的事件订阅。编译成功不能证明动态资源与绑定在运行时有效。
+
+| 症状 | 检查位置 |
+|---|---|
+| 找不到 hc 类型 | 包引用、TFM、XAML 命名空间、AssemblyInfo.XmlnsDefinition、类型是否属于 Avalonia |
+| 控件无模板或资源未找到 | App.xaml 的皮肤/主题顺序、重复字典、资源键大小写、Style.TargetType |
+| ViewModel 没有更新 | DataContext、绑定错误输出、Mode、UpdateSourceTrigger、属性变化通知 |
+| Dialog 不显示 | 活动窗口、AdornerDecorator，或 token 对应的 DialogContainer |
+| Growl 不显示/显示错窗口 | 宿主 Panel、GrowlParent/Token、调用范围和 Dispatcher |
+
+## 源码依据
+
+路径均相对于 HandyControl 仓库根目录。在仓库外可以访问对应链接；对已发布版本应切换到匹配 tag 或提交，避免把 master 新成员用于旧包。
+
+- [快速开始](https://github.com/HandyOrg/HandyControl/blob/master/doc/source/handycontrol/quick_start/index.md)
+- [WPF 项目](https://github.com/HandyOrg/HandyControl/blob/master/src/Net_GE45/HandyControl_Net_GE45/HandyControl_Net_GE45.csproj)
+- [命名空间映射](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Properties/AssemblyInfo.cs)
+- [官方 Demo 资源配置](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControlDemo_Shared/App.xaml)
diff --git a/skills/templates/native-styles.md b/skills/templates/native-styles.md
new file mode 100644
index 00000000..4358872b
--- /dev/null
+++ b/skills/templates/native-styles.md
@@ -0,0 +1,19 @@
+# 原生 WPF 控件样式
+
+这里处理 `System.Windows.Controls` 的原生类型。需要扩展控件功能时才选 `HandyControl.Controls` 下的类型。先按实际 CLR 类型选择样式，不能将一个同名扩展类型的样式套在原生类型上。
+
+```xml
+<StackPanel>
+    <Button Content="保存" Style="{StaticResource ButtonPrimary}"
+            Command="{Binding SaveCommand}"/>
+    <TextBox Margin="0,12,0,0" Style="{StaticResource TextBoxExtend}"
+             hc:InfoElement.Title="用户名" hc:InfoElement.Placeholder="请输入用户名"
+             Text="{Binding UserName, UpdateSourceTrigger=PropertyChanged}"/>
+</StackPanel>
+```
+
+片段依赖 App.xaml 的皮肤和主题字典、hc 命名空间，以及使用方 DataContext。原生 PasswordBox 不提供可直接按 TextBox 方式绑定的 Text 属性；需要密码绑定时按实际控件方案实现。
+
+附加属性来自 `Controls/Attach`：检查 InfoElement、TitleElement、BorderElement、IconElement 等的 Get/Set 方法和对应模板的使用位置。设置附加属性不代表任意模板都会展示它。
+
+下面的显式 Style 键从本仓库各原生控件样式源文件生成；不是所有键都适用于控件本身（例如某些键针对子元素），使用前在源文件核对 TargetType。隐式样式和 BasedOn 链不在本清单展开。
diff --git a/skills/templates/styling.md b/skills/templates/styling.md
new file mode 100644
index 00000000..fb1919ed
--- /dev/null
+++ b/skills/templates/styling.md
@@ -0,0 +1,41 @@
+# 皮肤、主题与资源
+
+## 静态字典方案
+
+`SkinDefault.xaml`、`SkinDark.xaml`、`SkinViolet.xaml` 是皮肤字典；`Theme.xaml` 提供控件主题。先合并一个皮肤，再合并主题，应用自己的覆盖资源置于其后。通过 `DynamicResource` 引用需要随皮肤变化的颜色和画刷，例如 `PrimaryBrush`、`RegionBrush`；显式样式键通常用 `StaticResource`。
+
+```xml
+<ResourceDictionary.MergedDictionaries>
+    <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/SkinDark.xaml"/>
+    <ResourceDictionary Source="pack://application:,,,/HandyControl;component/Themes/Theme.xaml"/>
+</ResourceDictionary.MergedDictionaries>
+```
+
+这是现有 ResourceDictionary 内的片段，不应额外嵌套 Application.Resources。运行时更换静态皮肤时替换由应用持有的那一个皮肤字典，保留其他字典和顺序，不清空全部 MergedDictionaries。
+
+## Theme 对象方案
+
+当前源码还提供 `HandyControl.Themes.Theme : ResourceDictionary`，其 `Skin` 为 `HandyControl.Data.SkinType`；可以用 Theme 对象管理皮肤。采用此方案时先读取 `Themes/Theme.cs` 的构造和更新逻辑，避免同时再加载一套静态主题字典。
+
+```xml
+<ResourceDictionary.MergedDictionaries>
+    <hc:Theme Skin="Dark"/>
+</ResourceDictionary.MergedDictionaries>
+```
+
+`hc` 对应 `https://handyorg.github.io/handycontrol`。修改 Theme 实例的 Skin 需要保留对该实例的引用；自动跟随系统、强调色等能力以实际版本的 Theme 源码属性为准。
+
+## 调整外观
+
+先找到控件对应的 `Themes/Styles/<控件>.xaml`，核对 x:Key、TargetType、BasedOn 和 TemplateBinding。能通过公开属性或附加属性完成的改动优先使用这些接口；确需重写模板时保留必需的 PART_* 名称。
+
+本仓库 `Themes/Theme.xaml` 由 `XamlCombine.exe` 和 `Theme_GE45.txt` / `Theme_40.txt` 合并。修改相应样式源文件及必要的清单，再按项目构建流程生成；不要把合并文件当作唯一维护入口。使用方项目通常只需要覆盖自己的资源。
+
+先检查工作区已有修改，尤其颜色和主题文件，避免覆盖用户的定制。验证浅色、深色切换时检查文本对比度、禁用态、弹出层及局部资源覆盖；无法运行 UI 时说明限制。
+
+## 源码依据
+
+- [Theme 实现](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Theme.cs)
+- [皮肤枚举](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Data/Enum/SkinType.cs)
+- [样式源目录](https://github.com/HandyOrg/HandyControl/tree/master/src/Shared/HandyControl_Shared/Themes/Styles)
+- [主题合并清单](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Theme_GE45.txt)