Agent-Skills.md

Agent Skills: UX Polish Skill

Apply a focused UI polish pass while preserving behavior, design system consistency, accessibility, and WorkflowSkills docs.

UncategorizedID: LaizyIO/WorkflowSkills/ux-polish

Repository

LaizyIO/WorkflowSkills
LaizyIO

Install this agent skill to your local

pnpm dlx add-skill https://github.com/LaizyIO/WorkflowSkills/tree/HEAD/ux-polish

Skill Files

Browse the full folder contents for ux-polish.

Download Skill

Loading file tree…

ux-polish/SKILL.md

Skill Metadata

Name
ux-polish
Description
Apply a focused UI polish pass while preserving behavior, design system consistency, accessibility, and WorkflowSkills docs.

UX Polish Skill

WorkflowSkills Project Context

Before acting, resolve project documentation roots:

  1. Look for a [DOC]-* directory at project root.
  2. If found, set DOC_ROOT to that directory and UX_DOCS_ROOT to [DOC]-*/11-UX-DesignOps.
  3. If [DOC]-* is absent, stop and ask to initialize project documentation first; never write persistent UX documentation to docs/obsidian.
  4. Read DESIGN.md, related UX docs, and current code.

Goal

Improve visual quality, clarity, interaction feedback, and consistency without changing business behavior.

Process

  1. Identify the target surface and current issue.
  2. Read components, tokens, CSS variables, Tailwind config, theme files, and Storybook if present.
  3. Make focused changes to spacing, hierarchy, alignment, states, typography, contrast, and motion.
  4. Preserve behavior, data flow, APIs, validation, and routing.
  5. Update UX_DOCS_ROOT/09-Debt/Visual_Debt.md and related screen/component docs.
  6. Run or trigger ux-visual-verification.

Rules

  • Keep changes small and reviewable.
  • Use existing tokens and components.
  • Do not create one-off styling unless documented as a deliberate exception.
  • Do not use generic AI visual patterns without product rationale.
  • Visual verification is mandatory for UI changes.