reticlehq/reticle

design-system-compliance

Check that the UI you actually rendered uses the design system, by reading computed styles in the running app against the project's design tokens.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/reticlehq/reticle --skill design-system-compliance

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Does the rendered UI actually use the design system?

Reading the source tells you what the component asks for. It cannot tell you what the browser resolved: a token overridden three layers up, a hardcoded #3b82f6 that happens to look close, a dark-theme scope that never applied. That answer only exists in the running page.

Reticle reads computed styles in the live app and compares them against the project's tokens. Not installed? RETICLE_INSTALL_SOURCE=npx_skill npx @reticlehq/server@latest init, then the `install-and-verify` skill.

The check

reticle_snapshot({ sessionId, mode: "interactive" })
reticle_inspect({ sessionId, ref })

inspect returns a theme report per element:

FieldWhat it tells you
offThemethe headline. True when a set, opaque color matches no token in the palette: a violation worth fixing
colorTokens / backgroundTokensevery token whose resolved value is this color. Empty means off-palette
colorToken / backgroundTokenthe unambiguous match, or null when several tokens share the color. null here is an abstention, not a violation: read the plural field
tokenCounthow many tokens resolved under the active theme. `0` means the app declares no palette, and offTheme is never asserted: report that rather than a clean bill of health
themeScopethe theme active at capture (e.g. .dark), so two inspects taken minutes apart are comparable at all

Read tokenCount first. Zero tokens means there is nothing to comply with, and every "pass" below it is vacuous.

Beyond color: is the control actually usable?

The same call answers the questions a screenshot cannot:

  • occluded: covered by an overlay. It renders, and no user can click it.
  • box: 0×0 is present-but-invisible, the most common "it's there, I can see it in the DOM" bug.
  • styles.opacity / styles.cursor: the difference between disabled-looking and disabled.
  • source: { file, line }: where to go and fix it.

A design review that only compares colors passes a button nobody can press.

Animations

reticle_run({ tool: "reticle_animations", args: { sessionId } })

Returns running and recently completed animations with their targets and timing. Two things worth checking after any motion work: an animation you added that never appears here did not run, and one whose duration does not match the token is off-spec. Both look identical in a screenshot.

Report violations as locations, not opinions

For each element that failed, give the file:line from inspect and the specific fact: "background #3b82f6 matches no token; the palette has --color-primary at #2563eb". A design-review comment without a location is a task someone else has to redo.

What this is not

This checks compliance with the tokens the project declares. It is not an opinion about whether the design is good, and it is not an accessibility audit. Contrast ratios, focus order and screen-reader semantics are a different job, and claiming them here would be a false green of exactly the kind this repo exists to prevent.


Everything else, one page at a time: curl https://docs.reticle.sh/llms.txt. Design token check missing something you needed? reticle_feedback with kind: "gap".

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills
reticlehq
社区

reticle

Install, instrument and verify this running web app from the inside (DOM, network, routing, console and framework state) instead of screenshots or guessing. Drives one real flow end to end and returns a verdict with the file:line to fix. Use when the user asks to set up or install Reticle, when a user-facing change needs proving before you call it done, when a test passes but the UI is broken, or when the user types /reticle.

1小时安装量
1
GitHub Stars
1285
最近更新
10月30日
reticlehq
社区

audit-my-app

Sweep a whole running web app for what is broken, without writing a script or knowing the codebase. Clicks every reachable control and reports dead buttons, console errors, failed requests, and places where the API and the screen disagree. Use on an unfamiliar codebase, before a release, after a big merge or dependency bump, when the user asks for a smoke test or a health check, or when someone says "just check everything still works".

1小时安装量
1
GitHub Stars
900
最近更新
9月26日
reticlehq
社区

debug-broken-ui

Find out why something in a running web app does not work, when the console is empty and the code looks correct. Reads the click, the request, the store and the console together and returns the file:line to open. Use when a button does nothing, a form will not submit, data will not load, a page renders blank or stale, a modal will not close, or the user says "it's broken" and the code review says it is fine.

1小时安装量
1
GitHub Stars
900
最近更新
9月26日
reticlehq
社区

fix-what-i-pointed-at

Pick up the bugs a human flagged by pointing at them in the running app, each arriving with the element, the note they typed, and the source file and line. Use when the user says they marked or flagged something, when starting a session on an app someone has been clicking through, when a designer or PM has left feedback in the UI, or when the user describes a problem as "that button there" without saying which file.

1小时安装量
1
GitHub Stars
900
最近更新
9月26日