design-ui-window
Redesign a XerahS Avalonia page, dialog, or tool window when visual changes are requested.
How do I install this agent skill?
npx skills add https://github.com/sharex/xerahs --skill design-ui-windowIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a professional Avalonia UI refactoring tool for the XerahS project (associated with the author sharex). It contains no malicious code, network requests, or attempts to access sensitive data, and it includes strict instructions to prevent modifications to application logic or bindings.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
Redesign a XerahS window or page
The target is the view the user names. Keep changes in that view plus any shared styles or resources that are genuinely needed for consistency. Do not change business logic, command bindings, or view-model public API. Do not remove controls unless they are provably redundant. Also follow avalonia-guidelines.
XerahS surface and theme rules
- Identify the host type first: PageView, SurfaceWindow, ordinary dialog/window, or transparent overlay. Overlays that are intentionally transparent keep no painted surface.
- Black areas or gutters usually mean an unpainted layout container is falling through to the Fluent host surface. Fix the first painted surface before restyling inner controls.
- For tool windows and dialogs, replace a transparent root
Grid/StackPanelwith outerMarginby a rootBorderwithBackground="{DynamicResource SolidBackgroundFillColorSecondaryBrush}"andPadding, then nest the layout inside it. Routed pages use the shared host defaults first and add local root painting only if a gutter still shows. - Use shared theme brushes (
SolidBackgroundFillColorSecondaryBrush,CardBackgroundFillColorDefaultBrush,CardStrokeColorDefaultBrush,TextFillColorPrimaryBrush,TextFillColorSecondaryBrush). Never hardcode dark colours. - The accent is the OS system accent through
SystemAccentColor/SystemAccentColorLight1/SystemAccentColorDark1insrc/desktop/app/XerahS.UI/Themes/ThemeResources.axaml. Never referenceShareX.Color.Accent.StartorShareX.Color.Accent.Endin new brushes. - Buttons are accent by default app-wide through
ThemeResources.axaml. Do not addClasses="accent". Use the opt-out classesNoAccent,SettingsRow,ColorSwatchButtonorDarkButtononly when a button truly needs a different look. Being a secondary action is not a reason to useNoAccent. - Button content is already centred by a universal style. Do not add
HorizontalContentAlignment/VerticalContentAlignmentto buttons. The exception isButton.SettingsRow, which already stretches. - Do not style scrollbar thumbs. XerahS keeps Fluent's neutral colours and disables auto-hide app-wide.
- If previews or control internals still render black after the root is fixed, or the same issue spans many windows, fix the shared theme/resource mapping instead of patching children one by one.
- During visual work keep
#ElementNamepaths on{Binding ...}. Never rewrite them to{ReflectionBinding ...}.
Workflow
- Inventory every control: type, purpose, binding, container, host type, and whether the first painted surface is explicit.
- Set the hierarchy: one visually dominant primary action, quieter secondary actions, grouped supporting options.
- Rework the layout on a consistent grid with shared spacing tokens. Remove ad hoc pixel values, dead zones, cramped areas, and redundant borders or labels.
- Standardise typography and control styling through shared styles. Extract repeated styling only when it reduces duplication.
- Check accessibility: accessible names, focus order that matches visual order, keyboard reach, hit-target size, and contrast.
- Build, then check the view at common sizes and DPI scales, with longer text, and with no runtime binding errors in the logs.
Report a short summary, the layout, style and accessibility changes, the files changed, and screenshots if available.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/sharex/xerahs/design-ui-window">View design-ui-window on skillZs</a>