ux-design-laws

ux-design-laws is a skill for Codex from BuildrAI/Buildr. It costs 82 tokens per session (1,137 once invoked), scanned A, original, MIT.

A skill for designing or reviewing user interfaces and interaction flows using practical psychology-based design principles. It focuses on user goals, information structure, feedback, accessibility, safety, and ways to verify proposed changes.

In plain words
What is it for?
Use it to plan or review screens, navigation, input flows, feedback states, information hierarchy, and competing interface designs.
Why use it?
It separates observable interface problems from assumptions and helps prioritise blocked tasks, serious misunderstandings, and hard-to-recover errors over cosmetic changes.

Skill for Codex

Written for Codex: agents/openai.yaml present.

Good fit Use it to plan or review screens, navigation, input flows, feedback states, information hierarchy, and competing interface designs.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/buildrai/buildr/ux-design-laws
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add BuildrAI/Buildr --skill ux-design-laws
Clone the repo
git clone --depth 1 https://github.com/BuildrAI/Buildr

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ux-design-laws

README.md
[![agentmods](https://agentmods.dev/badge/skills/buildrai/buildr/ux-design-laws/github.svg)](https://agentmods.dev/skills/buildrai/buildr/ux-design-laws)
Your own site
<a href="https://agentmods.dev/skills/buildrai/buildr/ux-design-laws"><img src="https://agentmods.dev/badge/skills/buildrai/buildr/ux-design-laws/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ux-design-laws

Your own site · 80×15
<a href="https://agentmods.dev/skills/buildrai/buildr/ux-design-laws"><img src="https://agentmods.dev/badge/skills/buildrai/buildr/ux-design-laws.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 82 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,137 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00082 $0.01137
Opus 5 $0.00041 $0.00568
Sonnet 5 $0.00016 $0.00227
Haiku 4.5 $0.00008 $0.00114

Measured 3d ago against content hash 553bd301687d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

ux-design-laws scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

projects/product/services/buildr/resources/workspace/skills/buildr/ux-design-laws/SKILL.md · 78 lines

What it actually says

用户体验设计法则

把用户体验法则当作发现问题和比较方案的启发式工具,不把法则名称当作设计结论。目标是帮助用户更可靠、更轻松地完成真实任务。

1. 建立设计现场

先确认当前工作属于哪一种:

  • 设计:从目标和约束形成信息架构、页面结构或交互方案。
  • 审查:从截图、原型、页面、代码或操作路径中发现问题。
  • 权衡:比较多个方案,解释哪些用户收益与代价不同。

读取用户提供的真实材料;存在代码、现有页面或设计系统时先调查当前事实。至少明确主要用户、首要任务、使用环境、平台与输入方式。缺少的信息不会改变方向时作显式假设并继续;会改变核心流程、安全、权限或不可逆结果时再询问。

2. 选择相关法则

先读 法则索引,根据当前界面的可观察信号选择一至两个相关分组,再读取对应参考文件。不要为了展示完整而套用全部法则。

每次只引用真正改变判断的法则。法则互相支持时合并为一个建议;法则产生不同方向时显式说明权衡。

3. 形成建议

按以下顺序判断:

  1. 用户明确目标、业务事实与授权边界。
  2. 安全、隐私、无障碍与结果可逆性。
  3. 首要任务能否正确完成。
  4. 用户已有心智模型与产品现有一致性。
  5. 理解成本、操作效率与错误恢复。
  6. 审美、愉悦和品牌表达。

法则只能支持建议,不能覆盖更高优先级的事实。把观察与推断分开,不把个人偏好包装成心理学结论,不声称某条法则必然提高转化率或满意度。

对每个重要问题给出:

  • 证据:页面、流程或输入中的具体观察。
  • 影响:它怎样阻碍主要用户完成首要任务。
  • 法则:一至三条直接相关法则及其作用方向。
  • 建议:具体到层级、位置、文案、状态或交互的变化。
  • 权衡:收益、代价、例外和可能引入的新问题。
  • 验证:可观察的任务结果、用户行为或产品指标。

优先处理阻断任务、造成严重误解或不可恢复错误的问题;其次处理高频任务的效率与理解;最后处理愉悦和视觉润色。默认给出最重要的三至五项,不用低价值建议淹没用户。

4. 约束与停止条件

  • 法则是启发式原则,不替代真实用户研究、可用性测试、无障碍标准、平台规范或领域安全要求。
  • 进度、稀缺、等待和视觉强调必须表达真实状态;避免虚假进度、制造焦虑、隐藏退出或诱导用户作出非自愿选择。
  • 对现有界面做审查时只报告证据可支持的问题。看不到交互状态、响应时间或真实用户行为时,将结论标为待验证。
  • 用户只要求分析或审查时停在建议,不生成原型、不修改代码。用户明确要求产出原型或实现时,把本技能的结果作为设计输入交给相应能力。

5. 输出格式

先给一句结论,再按优先级列建议。每项使用紧凑格式:

[优先级] 问题或机会
证据:...
影响:...
依据:<中文名称(English Name)>
建议:...
权衡:...
验证:...

设计模式还应给出核心流程与关键状态;审查模式应区分已观察事实和待验证假设;权衡模式应说明推荐方案及不选其他方案的具体原因。

Files

What ships with it

7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 78 lines · 82 tokens per session scan A 553bd301687d

Subscribe to this mod's changes

ux-design-laws is a skill published in the GitHub repository BuildrAI/Buildr (24 stars, last pushed 2d ago), licensed MIT. It adds 82 tokens to every session and 1,137 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-07.

Related

Other skills, from other repositories

webgl-holographic-foil

A self-contained WebGL2 hero: thin-film interference over a crushed-foil surface whose palette shifts with the viewing angle; move the cursor to tilt the film.

nexu-io/open-design · 41 tokens

html-ppt-hermes-cyber-terminal

OpenDesign + BYOK: choosing and wiring your own model, hands-on — cost, quality, and the routing decision. Built as a decision-grade AI literacy deck for engineers, IT, applied-AI teams.

nexu-io/open-design · 53 tokens

html-ppt-taste-brutalist

16:9 HTML deck in tactical-telemetry / CRT-terminal taste. Deactivated-CRT charcoal slides, white-phosphor monospace, hazard-red accent, scanline overlay, ASCII syntax, density over decoration. Distilled from Leonxlnx/taste-skill brutalist-skill (Tactical Telemetry mode).

nexu-io/open-design · 78 tokens

visual-ralph

Visual Ralph orchestration for frontend UI from generated references, static references, or live URL targets, using $ralph with built-in visual verdict and pixel-diff evidence until the implementation matches and leaves a reproducible design system.

Yeachan-Heo/oh-my-codex · 50 tokens

accessibility

Consolidated accessibility skill entrypoint for WCAG 2.2, ARIA Authoring Practices, cognitive accessibility, Section 508, EN 301 549, design intent verification, and the Accessibility Planner workflow.

microsoft/hve-core · 47 tokens

make-resume

A Chinese-language tool for creating editable HTML resumes that can be changed in a browser and printed to PDF. It uses available resume templates when they are installed and otherwise provides a simpler fallback.

Hisn00w/ASu-skills · 86 tokens