hf-ui-design

hf-ui-design is a skill for Claude Code from hujianbest/harness-flow. It costs 0 tokens per session (1,783 once invoked), scanned A, original, MIT.

A set of rules for designing and reviewing user interfaces, such as pages, components, and visual interactions.

In plain words
What is it for?
Use it when planning, implementing, or reviewing UI work, including keyboard access, visible focus, readable contrast, touch targets, and real-rendering checks.
Why use it?
It helps prevent missed loading, empty, error, disabled, success, and focus states, while keeping visual choices accessible and consistent.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the harness-flow plugin — 14 skills shipped together

Good fit Use it when planning, implementing, or reviewing UI work, including keyboard access, visible focus, readable contrast, touch targets, and real-rendering checks.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/hujianbest/harness-flow/hf-ui-design
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 hujianbest/harness-flow --skill hf-ui-design
Clone the repo
git clone --depth 1 https://github.com/hujianbest/harness-flow

Made for: Claude Code.

Or install harness-flow, the plugin that ships this one along with the rest of its 14 skills.

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 hf-ui-design

README.md
[![agentmods](https://agentmods.dev/badge/skills/hujianbest/harness-flow/hf-ui-design/github.svg)](https://agentmods.dev/skills/hujianbest/harness-flow/hf-ui-design)
Your own site
<a href="https://agentmods.dev/skills/hujianbest/harness-flow/hf-ui-design"><img src="https://agentmods.dev/badge/skills/hujianbest/harness-flow/hf-ui-design/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 hf-ui-design

Your own site · 80×15
<a href="https://agentmods.dev/skills/hujianbest/harness-flow/hf-ui-design"><img src="https://agentmods.dev/badge/skills/hujianbest/harness-flow/hf-ui-design.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,783 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. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.00000 $0.01783
Opus 5 $0.00000 $0.00892
Sonnet 5 $0.00000 $0.00357
Haiku 4.5 $0.00000 $0.00178

Measured 7d ago against content hash 938e9f9ec980, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

hf-ui-design 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 7d 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.

skills/hf-ui-design/SKILL.md · 103 lines

How it starts

The opening of the file, as written. The whole thing — 103 lines — stays where its author put it; the contents beside it link to each section on GitHub.

UI 设计

有 UI 的特性在 to-spec / implement / 代码评审时加载本技能。

加载

  • 绑定阶段: to-spec、implement、code-review
  • 触发条件: 特性包含用户界面(页面 / 组件 / 可视交互)

设计层(先于一切视觉工作执行)

本技能在进入具体 UI 工作前,必须先过设计层三件事:

1. 确定美学方向(禁止"默认模板脸")

  • 任何 UI 特性先选定单一明确的美学方向:editorial(编辑风)、swiss/极简、brutalist、retro-futuristic、dark luxury、soft/极简暖色、neo-brutalism、有机形态 等,选一个并写进 spec.md 的 UI 设计节。
  • 调用本合集的 ui-ux-pro-max 技能做风格与设计系统匹配(240+ 风格库、字体配对、UX 指南,含桌面),再调用 frontend-design 技能(官方版)做方向确认与真实排版配对(serif/sans/mono 的组合,拒绝只换一个无衬线字体)。
  • 方向一旦确定,后续阶段禁止漂移回通用 SaaS 模板;评审时以此方向为基准。

2. 用 taste 旋钮校准

  • taste-skillDESIGN_VARIANCE / MOTION_INTENSITY / VISUAL_DENSITY 三旋钮给出明确取值(默认 3/2/3,范围 1–5),写入 spec 或 DESIGN.md。
  • 动效只服务交互语义;装饰性动效一律拒绝。

3. DESIGN.md

  • 绿地项目(无既有设计系统 / 无 DESIGN.md)必须在 to-spec 阶段创建 DESIGN.md:一行品牌立场 + 色彩(含 OKLCH 推导)+ 字体配对 + 间距/圆角/阴影标尺 + 3 条以上禁止项。
  • 有既有 DESIGN.md 或设计系统时,先冷读再复用,禁止另起炉灶。
  • 生成与维护参考 references/design-rules.mdstitch-skill

规格阶段 (to-spec) 规则

spec.md 的实现决策 / 测试决策或专设的 UI 设计 一节须覆盖:

信息架构与交互先行

  • 先锁定页面结构、导航与内容分组,再进入组件与视觉细节
  • 每个关键交互至少覆盖 loading / empty / error 三态;高风险交互补齐 disabled / success / focus
  • 只绘制顺利路径视为不完整

视觉系统与令牌纪律

  • 有既有设计系统 / 品牌规范或 DESIGN.md 时,必须先冷读并复用
  • 颜色、字号、间距、圆角、阴影一律使用设计令牌,禁止硬编码字面量
  • DESIGN.md 或既有令牌文件时优先从中取值;没有时先在规格中命名令牌
  • 缺资产时用语义占位符,不自画 SVG、不自编正文

反 AI 粗制滥造审美(硬拒绝项)

除非用户在决策记录/ADR 中明确要求,否则拒绝:无理由的紫色渐变、Inter/Roboto 默认字体、带左侧彩条的圆角卡片式提示框、用 emoji 充当图标、无理由的发光效果、装饰性动效、大面积玻璃拟态、无法回指需求的分区/徽标,以及没有 CTA 的空状态。

可访问性底线

  • 正文对比度达到 WCAG AA;键盘可达且焦点可见;纯图标控件须有 aria-label;触控目标 ≥ 44×44px
  • 详见 references/ui-checklist.md

实现阶段 (implement) 规则

  • UI 相关票的测试覆盖交互三态可验证行为
  • 令牌纪律延续到代码;在重构步骤中清理硬编码
  • 按已确定的 DESIGN.md 与美学方向实现;色调、字体、间距全部来自令牌,不引入新的系统字体默认
  • 提请进入 code-review 阶段前,加载 references/ui-checklist.md 自查

视觉验证闭环(实现完成 + 评审时强制执行)

只有单元测试不构成 UI 验证。每个含 UI 的特性必须走:

  1. 真实渲染:启动应用并截图(Web 用浏览器截图,桌面用应用截图),覆盖主页面 + 至少一个三态。
  2. 截图评审:把截图交给评审,按 references/design-rules.md 的评审框架逐项过:
    • 方向一致性(是否回到"模板脸")
    • 排版节奏与字体配对是否成立
    • 间距层次、留白、对齐网格
    • 色彩对比与令牌使用
    • 空状态 / loading / error 是否可看
    • 平台规范(Web 或桌面各自的要求)
  3. 回修:评审发现视觉硬伤 → 返回实现阶段修复 → 重新截图复验,直到无方向漂移、无模板脸、无视觉硬伤。

Read the full file on GitHub · 103 lines

Files

What ships with it

2 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. 7d ago Changed · +44 lines 938e9f9ec980
  2. 11d ago First seen · 59 lines · 0 tokens per session scan A 813c9e6d3618

Subscribe to this mod's changes

hf-ui-design is a skill published in the GitHub repository hujianbest/harness-flow (53 stars, last pushed 10d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,783 tokens. 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-08-30.

Related

Other skills, from other repositories

chakra-ui-builder

Build responsive, accessible UI components and layouts using Chakra UI v3, install or configure Chakra UI in new and existing projects, and design scalable themes using tokens, semantic tokens, recipes, and slot recipes. Use this skill whenever a user asks to build, create, or generate any UI component, page, form…

chakra-ui/chakra-ui · 214 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

frontend-ui-dark-ts

Build dark-themed React applications using Tailwind CSS with custom theming, glassmorphism effects, and Framer Motion animations. Use when creating dashboards, admin panels, or data-rich interfaces with a refined dark aesthetic.

microsoft/skills · 48 tokens

reveal-hover-effect

Build cursor-following spotlight reveals that expose a second aligned image through a soft radial mask. Use for hover-to-color, before-and-after, x-ray, material, texture, product-detail, and illustrated hero effects where a desaturated or embossed base image should remain visible while another treatment follows an…

MengTo/Skills · 66 tokens

frontend-visual-qa

Audits already-rendered web, landing-page, HTML deck/slide, browser tool/game, dashboard/admin, design-system, and desktop UIs using real-browser or native-app journeys, inspected screenshots, DOM geometry, responsive or projection viewports, and a bundled Playwright sweep. Use after UI implementation to find…

daymade/claude-code-skills · 145 tokens

prototype-web

A clickable, high-fidelity web product prototype with navigation, a hero section, feature cards, steps, social proof, and optional pricing. It is designed to resemble a finished landing page while remaining a prototype.

nexu-io/html-anything · 24 tokens