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
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.