跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
浏览器与自动化

interface-affordances

Fix unclear interaction cues, hidden actions, weak hit targets, or mismatches between a control’s appearance and behavior.

kemiljk · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add kemiljk/skills --skill interface-affordances

技能说明


name: interface-affordances description: "Fix unclear interaction cues, hidden actions, weak hit targets, or mismatches between a control’s appearance and behavior." license: MIT

Interface Affordances

Affordances make possible actions perceptible. If people cannot tell what they can do, the interaction is incomplete even when the code works.

Defaults

  1. Visual cues must match real behaviour.
  2. Critical actions cannot depend on hover alone.
  3. Hit targets and spacing should match the input method.
  4. State changes should explain themselves (pressed, selected, expanded, disabled, loading).
  5. Decorative motion must not impersonate an affordance.

Prefer / Reject

PreferReject
Persistent cues for primary actionsHover-only discovery of essential controls
Clear pressed/selected/expanded statesIdentical resting and active styles
Cursor/keyboard/touch-appropriate targetsTiny click areas with large visual icons
Disabled styles that also disable behaviourGreyed-out controls that still fire handlers
Labels that name the actionIcon-only controls with no accessible name

Checks by input mode

  • Pointer: hover can enrich, not gate, essential actions.
  • Touch: provide visible tap targets and avoid hover-dependent UI.
  • Keyboard: focus styles are part of the affordance, not an afterthought.
  • AT: names, roles, and states expose the same possibilities the visuals claim.

Review checklist

  • Can a new user tell what is interactive?
  • Does every interactive element have a perceptible state change?
  • Are essential actions visible without hover?
  • Do icons have names?
  • Do disabled and loading states look and behave disabled/loading?
  • Could reduced-motion or touch users still discover the action?

Source essays

  • On affordances
  • Ten principles for product delight
  • On reduced motion