SKILL

ui-principles

Interaction judgment for interfaces: start from the decisions, reduce effort, act next to the object, one gesture per decision, only valid choices, truthful async state, local waits, preserved user edits, undo and drafts, one vocabulary, stable layout and complete states, host conventions and focus, and long labels. Pull when designing or reviewing how a screen or a control behaves, or when choosing between two UI options.

Target: Design & content creation. Automatically collected · unverified.

Excerpt from the author’s documentation

Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.

Read the original English text

Topics in the source

  • UI principles
  • Working to them
  • Start from the decisions
  • Reduce effort, reveal depth on demand
  • Act next to the object
  • One gesture commits one decision
  • Expose only valid choices
  • Keep async results truthful

These principles decide what goes on a screen, how it behaves and how it looks. They are a standard to decide by rather than a checklist to cite. They come from tools a person uses repeatedly, such as an editor or an admin screen, so a first visit to a website bends some of them, and each section says where. Visual identity is the design direction's business, and these principles never override it. Designing. Start from the decisions, then compose from that list rather than from the screens that already exist. Checking. One gesture per decision, only valid choices and local waits are the ones a plausible control breaks silently, so exercise them before calling a screen done. Reviewing. A finding names the observed behaviour, where it happens and the principle it breaks, because a principle's name alone is not evidence. Conflict. Choose one principle, name the one given up, and record the tradeoff. Before any layout, list the decisions a person makes on this surface and how often each happens. The frequent decision gets the most direct, visible gesture, and a rare edit stays available out of the way. On a website, a first visit's decisions come before repeat actions: does this perso

This is an excerpt. Refer to the complete source and its current requirements.

Source repository
avi2d/skills
Source file
library/interface/references/ui-principles/SKILL.md
Fixed revision
d69fea27d853cb55ebbbeb7e87b37bff4d40ccf6
Read the complete original documentation ↗

Requirements

  • Only the author’s Skill metadata is included. Read the full instructions to check dependencies, licensing and conditions of use.

A small first task

先阅读原作者说明,再决定是否在自己的 AI 工具中使用。

Instructions for your AI tool

Author documentation is not live verification by this site. Without evidence, we do not mark a resource as compatible, safe or free.

Sources and evidence

This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.

Author: avi2d/skills · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-11T22:01:41.758Z.

Categories are inferred from names, descriptions and paths. They do not establish compatibility.

License and attribution

MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.

Original license ↗

Synchronization, copying and user-reported success do not mark a resource as runtime-tested.

Limitations and notes

  • Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.