ui-fidelity-playbook SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

ui-fidelity-playbook from minleev5/devkeel is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add minleev5/devkeel/ui-fidelity-playbook@v1.0.3

Pins v1.0.3 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
minleev5/devkeel
Path
templates/skills/ui-fidelity-playbook/SKILL.md
Versions recorded
2
Latest version
v1.0.3, committed Sep 24, 2026
First version recorded
Sep 22, 2026
Size
5,243 bytes
Repository stars
6
License
MIT

按设计意图(设计稿/截图/线框/明确视觉参考)高保真实现 UI 的方法论。指导如何先探索项目约束、先对齐结构与交互再打磨细节、避免常见失真、提交前自验。适用"UI 还原""按设计稿还原""高保真对齐""还原度不够""交互与视觉对齐"等场景。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# UI Fidelity Playbook

当已有可参考的设计意图(设计稿/截图/线框/明确视觉参考)时,使用本 skill。

这个 skill 不是替代设计工具或设计获取流程,而是补充"如何更早把实现做对"的方法论。它既指导编码,也指导提交前自验,但不是事后 code review 流程。

## 何时使用

适用于以下场景:

- 参考设计意图(设计稿/截图/线框/明确视觉参考)实现页面、区块、组件或弹窗
- 需要高保真还原,而不是"差不多"
- 需要同时对齐视觉和交互
- 页面已经有实现,但还原度不足
- 用户反馈"和设计稿不一致""交互没对齐""布局节奏不对"

常见触发语句包括:

- "参考设计稿实现"
- "按设计稿还原"
- "高保真对齐"
- "交互也要按设计稿"
- "这个页面还原度不够"

## 何时不使用

以下场景不要使用本 skill:

- 完全没有设计事实(无设计稿/截图/线框/明确视觉参考,仅有口头需求)——这属于创造设计而非还原实现;如已安装设计类 skill(如 `ui-ux-pro-max` 等),可先用其产出设计意图,再回到本 skill 做高保真实现
- 任务主要是业务逻辑或接口联调
- 用户要的是纯 code review
- 用户要的是开放式设计讨论,而不是实现对齐

## 设计事实来源

无论设计意图来自 Figma、Sketch、截图、线框还是口头描述加草图,使用本 skill 前至少明确三件事:

1. 本轮参考的是什么来源
2. 已拿到哪些事实——结构/截图/资源/状态变体
3. 还缺什么

来源不同只是填这个契约的方式不同,方法论本身来源无关。不要在只有口头描述、没有任何可对照事实时直接套用本 skill——那属于创造设计,先产出设计意图再回来。

### 来源为 Figma 时的最佳实践

当来源是 Figma 时,用其 MCP 可拿到结构化程度最高的事实,效果最佳。推荐顺序:

1. 确认目标节点或页面
2. 获取 `get_design_context`
3. 获取 `get_screenshot`
4. 必要时获取子节点上下文和设计资源
5. 使用本 skill 指导实现、收敛与自验

来源不是 Figma 时,按上方最小契约自行获取可对照的视觉事实(截图/线框/资源等)。

## 编码前必须探索的内容

如果任务涉及任何项目相关约束,必须先探索当前仓库,而不是假设。

重点探索:

- 当前作用域 `AGENTS.md`
- 相关 `.harness/rules/`
- 路由入口与页面挂载方式
- 页面布局 ownership
- 宿主容器(host container)或上层壳子结构
- 设计系统、共享组件、样式约束
- 图片与资产规范
- 测试与运行时验证路径
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add minleev5/devkeel/ui-fidelity-playbook@sha256:95b17c2eb37a212d

The line at the top of this page pins the label v1.0.3, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ie3qd6rv4mghwhkj.svg)](https://markdownregistry.com/a/art_ie3qd6rv4mghwhkj)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Sep 22, 2026 and Sep 24, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
v1.0.3 latest2026-09-24 8bc6bbc 5,243 BA view · diff
v1.0.22026-09-22 123429c 5,243 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5243 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

minleev5/devkeel · 6 stars · license MIT · pushed 2026-10-26 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_ie3qd6rv4mghwhkj
GET https://markdownregistry.com/api/v1/resolve?ref=minleev5/devkeel/ui-fidelity-playbook
GET https://markdownregistry.com/api/v1/blob/95b17c2eb37a212d44e94d393c273aac602d7ec8f52ae27482710e9787d75724

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from minleev5/devkeel

brainstorming SKILL.md skill
minleev5/devkeel · .harness/skills/brainstorming/SKILL.md · 探索、比较、挑战或补全开发方案;按 Lite/Full 深度进行单题访谈,并在用户同意持久化后维护 OpenSpec Living brainstorm。
v9.1.1 · audit A · 6 stars
changelog SKILL.md skill
minleev5/devkeel · .harness/skills/changelog/SKILL.md · Use when 编辑 changelog、发布 CLI 或模板版本、或判断某项用户可见变更是否需要进入版本记录。
v3.0.0 · audit A · 6 stars
commit SKILL.md skill
minleev5/devkeel · .harness/skills/commit/SKILL.md · 用户明确选择 commit、push 或 MR/PR 后使用的原子交付流程。任务完成或归档本身不触发;在授权范围内完成交付目标及其必要动作。
v1.2.4 · audit A · 6 stars
doc-maintenance SKILL.md skill
minleev5/devkeel · .harness/skills/doc-maintenance/SKILL.md · CLI 文档维护与一致性检查流程
v1.2.0 · audit A · 6 stars
domain-init SKILL.md skill
minleev5/devkeel · .harness/skills/domain-init/SKILL.md · 对项目进行全盘扫描,识别领域类型和技术栈,通过多 subAgent 并行扫描多维度, 生成项目知识 docs 与专属 rules、skills 和 agents。使用「自动 baseline + 交互式增强」…
v2.1.0 · audit A · 6 stars
health-check SKILL.md skill
minleev5/devkeel · .harness/skills/health-check/SKILL.md · 一键检查项目代码健康度指标
v1.0.0 · audit A · 6 stars
instruction-maintenance SKILL.md skill
minleev5/devkeel · .harness/skills/instruction-maintenance/SKILL.md · 精简并校验 AGENTS.md、OpenSpec schema/instruction、OPSX commands、SKILL.md、prompt 与 artifact 模板。用于审查当前 diff…
v1.0.0 · audit A · 6 stars
jira-defect-orchestrator SKILL.md skill
minleev5/devkeel · .harness/skills/jira-defect-orchestrator/SKILL.md · 独立编排 Jira 缺陷的取证、修复、验证、回填与 MR 交付,按决策风险确认。适用于用户提供 Jira URL 或 issue key,要求结合运行日志、配置、只读业务数据和代码证据处理生产或测试环境缺陷;普通无 Jira…
v1.3.2 · audit A · 6 stars
new-subcommand SKILL.md skill
minleev5/devkeel · .harness/skills/new-subcommand/SKILL.md · 为 DevKeel CLI 新增子命令的标准开发流程
v1.0.0 · audit A · 6 stars
openspec-apply-change SKILL.md skill
minleev5/devkeel · .harness/skills/openspec-apply-change/SKILL.md · 按 OpenSpec 动态 apply instruction 实施 change tasks,并处理 DevKeel 收尾门禁。
v3.2 · audit A · 6 stars
openspec-archive-change SKILL.md skill
minleev5/devkeel · .harness/skills/openspec-archive-change/SKILL.md · 检查完成状态、评估 spec sync,并按 schema 收尾门禁归档 OpenSpec change。
v3.3 · audit A · 6 stars
openspec-bulk-archive-change SKILL.md skill
minleev5/devkeel · .harness/skills/openspec-bulk-archive-change/SKILL.md · 批量检查 spec 冲突,并按 schema 门禁归档用户明确选择的多个 OpenSpec changes。
v2.2 · audit A · 6 stars

Every file in minleev5/devkeel

Other files named ui-fidelity-playbook

ui-fidelity-playbook SKILL.md skill
minleev5/devkeel · .harness/skills/ui-fidelity-playbook/SKILL.md · 按设计意图(设计稿/截图/线框/明确视觉参考)高保真实现 UI 的方法论。指导如何先探索项目约束、先对齐结构与交互再打磨细节、避免常见失真、提交前自验。适用"UI 还原""按设计稿还原""高保真对齐""还原度不够""交互与视觉对齐"等场景。
v1.0.3 · audit A · 6 stars

Browse by kind, by grade A, or by owner.