Web Interface Guidelines Reviewer
vercel-labs/openreview
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…
Accessibility guide for Mobazha following WCAG 2.1 AA standards including color contrast, reduced motion, ARIA patterns, keyboard navigation, focus management, and screen reader testing.
$ npx skills add mobazha/mobazha-unified --skill a11y-guide -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install mobazha/mobazha-unified a11y-guide --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/a11y-guide .claude/skills/a11y-guide && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "a11y-guide" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/a11y-guide into .claude/skills/a11y-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-guide", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/a11y-guideType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add mobazha/mobazha-unified --skill a11y-guide -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install mobazha/mobazha-unified a11y-guide --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.cursor/skills/a11y-guide .agents/skills/a11y-guide && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "a11y-guide" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/a11y-guide into .agents/skills/a11y-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-guide", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mobazha/mobazha-unified --skill a11y-guide -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install mobazha/mobazha-unified a11y-guide --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.cursor/skills/a11y-guide .cursor/skills/a11y-guide && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "a11y-guide" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/a11y-guide into .cursor/skills/a11y-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-guide", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/mobazha/mobazha-unified.git --path .cursor/skills/a11y-guide--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add mobazha/mobazha-unified --skill a11y-guide -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install mobazha/mobazha-unified a11y-guide --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.cursor/skills/a11y-guide .gemini/skills/a11y-guide && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "a11y-guide" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/a11y-guide into .gemini/skills/a11y-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-guide", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install mobazha/mobazha-unified a11y-guideInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add mobazha/mobazha-unified --skill a11y-guide -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .github/skills && cp -r skills-src/.cursor/skills/a11y-guide .github/skills/a11y-guide && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "a11y-guide" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/a11y-guide into .github/skills/a11y-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-guide", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mobazha/mobazha-unified --skill a11y-guide -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install mobazha/mobazha-unified a11y-guide --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.cursor/skills/a11y-guide .opencode/skills/a11y-guide && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "a11y-guide" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/a11y-guide into .opencode/skills/a11y-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "a11y-guide", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
a11y-guideAccessibility guide for Mobazha following WCAG 2.1 AA standards including color contrast, reduced motion, ARIA patterns, keyboard navigation, focus management, and screen reader testing.
A11y Guide is an agent skill from mobazha/mobazha-unified. Accessibility guide for Mobazha following WCAG 2.1 AA standards including color contrast, reduced motion, ARIA patterns, keyboard navigation, focus management, and screen reader testing. Use when building accessible components or reviewing accessibility, "无障碍", "可访问性", "a11y", "ARIA", "键盘导航", "屏幕阅读器", "对比度".
Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Frontend & Design, covering Accessibility. The repository describes itself as: Open-source commerce frontend for storefronts, marketplaces, checkout, and seller management. The licence is MPL-2.0.
Read from SKILL.md and the folder at commit 156c699. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
pnpmFrom the folder's file list and the shell code blocks in SKILL.md.
Links to these hosts (documentation or services it may open):
webaim.orgFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
A11y Guide loads about 1.4k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 143 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from mobazha/mobazha-unified at commit 156c699, republished under its MPL-2.0 licence (© mobazha). 143 words, ~1,379 tokens.
.claude/skills/a11y-guide/SKILL.md (or your agent's skills folder).Mobazha 项目的 WCAG 2.1 AA 无障碍标准和最佳实践。
| 内容类型 | 最低对比度 | 说明 |
|---|---|---|
| 正文(< 18px) | 4.5:1 | 正文、描述、标签 |
| 大文字(>= 18px bold 或 >= 24px) | 3:1 | 标题、大号文字 |
| UI 控件和图形 | 3:1 | 按钮边框、图标、输入框边框 |
| 装饰性元素 | 无要求 | 纯装饰、已禁用控件 |
// ✅ 好:muted-foreground 在大多数主题下对比度足够
<p className="text-muted-foreground">辅助文字</p>
// ⚠️ 注意:透明度过低可能不满足对比度
<p className="text-muted-foreground/50">这可能对比度不够</p>
// → 改为 text-muted-foreground/70 或测试实际对比度
// ❌ 差:浅色背景上的浅色文字
<p className="text-primary/30">这几乎看不清</p>// Tailwind 方式
<div className="animate-fade-in motion-reduce:animate-none">
<button className="transition-all duration-200 motion-reduce:transition-none">
// CSS 全局降级(globals.css 中添加)
@media (prefers-reduced-motion: reduce) {
*, *::before, *::after {
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.01ms !important;
scroll-behavior: auto !important;
}
}例外:加载指示器(spinner)不需要降级,因为是功能性动画。
项目已通过主题系统的 system 模式支持,无需额外处理。
// Radix Dialog 自动处理:
// - role="dialog"
// - aria-modal="true"
// - 焦点陷阱
// - Escape 关闭
// 需要手动确保:
<DialogTitle>标题必须存在</DialogTitle>
<DialogDescription className="sr-only">
无视觉描述时用 sr-only 隐藏
</DialogDescription>// Radix Tabs 自动处理 role="tablist" / "tab" / "tabpanel"
// 键盘:Arrow 切换、Enter/Space 选择// 重要通知
<div role="alert" aria-live="assertive">
操作失败:网络错误
</div>
// 非紧急通知
<div role="status" aria-live="polite">
已添加到购物车
</div>// ✅ 必须有 aria-label
<button aria-label="关闭" onClick={onClose}>
<X className="w-4 h-4" />
</button>
// ✅ 或使用 sr-only
<button onClick={onClose}>
<X className="w-4 h-4" />
<span className="sr-only">关闭</span>
</button>// 有信息量的图片
<img alt="红色运动鞋侧面图" src="..." />
// 纯装饰图片
<img alt="" role="presentation" src="..." /><button className="focus-visible:ring-2 focus-visible:ring-primary focus-visible:ring-offset-2">
<input className="focus:ring-2 focus:ring-primary focus:border-primary"><button>/<a>)必须添加 role 和 tabIndex:<div
role="button"
tabIndex={0}
onClick={handleClick}
onKeyDown={(e) => {
if (e.key === 'Enter' || e.key === ' ') {
e.preventDefault();
handleClick();
}
}}
>| 场景 | 操作 |
|---|---|
| Dialog 打开 | 焦点移到 Dialog 内第一个可聚焦元素(Radix 自动处理) |
| Dialog 关闭 | 焦点返回触发元素(Radix 自动处理) |
| 路由切换 | 焦点移到页面主内容区域(需手动处理) |
| 元素删除 | 焦点移到前一个或后一个元素 |
| Toast 出现 | 不抢夺焦点(aria-live 通知即可) |
// 在 layout 或路由变化时
useEffect(() => {
// 将焦点移到主内容区域
const main = document.getElementById('main-content');
if (main) {
main.focus({ preventScroll: true });
}
}, [pathname]);
// 主内容区域
<main id="main-content" tabIndex={-1} className="outline-none">
{children}
</main>;// 放在 <body> 最前面
<a
href="#main-content"
className="sr-only focus:not-sr-only focus:fixed focus:top-4 focus:left-4 focus:z-[9999] focus:bg-background focus:px-4 focus:py-2 focus:rounded-md focus:shadow-lg"
>
跳转到主内容
</a>// 仅屏幕阅读器可见
<span className="sr-only">购物车中有 3 件商品</span>
// 对屏幕阅读器隐藏(纯装饰)
<div aria-hidden="true">🎉</div>// 购物车数量变化
<span aria-live="polite" className="sr-only">
购物车已更新,当前 {count} 件商品
</span>
// 加载状态
<div aria-busy={isLoading} aria-live="polite">
{isLoading ? '加载中...' : content}
</div>// Playwright a11y 测试
import AxeBuilder from '@axe-core/playwright';
test('首页无障碍检查', async ({ page }) => {
await page.goto('/');
const results = await new AxeBuilder({ page }).withTags(['wcag2a', 'wcag2aa']).analyze();
expect(results.violations).toEqual([]);
});# 安装
pnpm --filter @mobazha/web add -D @axe-core/playwrightmotion-reduce: 降级?aria-label 或 sr-only 文本?<label> 或 aria-label?focus-visible:ring-2)?role="button" 和键盘事件?aria-live 通知?© mobazha, MPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .cursor/skills/a11y-guide of mobazha/mobazha-unified.
Open the folder on GitHubat commit 156c699
A11y Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| A11y Guide this skillmobazha/mobazha-unified | 165 | — | ~1.4k | Automated safety check: Pass | MPL-2.0 | |
| Web Interface Guidelines Reviewervercel-labs/openreview | 1.7k | 97 repos | ~308 | Automated safety check: Pass | None | |
| Accessibility Reviewmarkmead/hyperui | 12k | 1 repos | ~1.1k | Automated safety check: Pass | MIT | |
| Web Animation DesignbaptisteArno/typebot.io | 11k | 2 repos | ~2.7k | Automated safety check: Pass | Custom licence | |
| Accessibility Fixeribelick/ui-skills | 9.6k | 4 repos | ~1.2k | Automated safety check: Pass | MIT | |
| Wcag Audit PatternsvmDeshpande/ai-agent-automation | 178 | 11 repos | ~610 | Automated safety check: Pass | Apache-2.0 |
vercel-labs/openreview
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…
markmead/hyperui
Run a WCAG 2.1 AA accessibility audit on a design or page. An agent skill from markmead/hyperui.
baptisteArno/typebot.io
Guides easing, timing and animation choices for UI motion, based on a web animation course, and reviews existing animations in a before-and-after table.
ibelick/ui-skills
Audits and fixes HTML accessibility problems such as ARIA labels, keyboard navigation, focus management, contrast and form errors with minimal changes.
vmDeshpande/ai-agent-automation
Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance.
ibelick/ui-skills
Applies a fixed set of UI rules for stack, components, interaction, animation, typography and layout, or reviews a file against them with concrete fixes.
mobazha/mobazha-unified
Look up Mobazha backend API endpoints, request/response formats, and field mappings.
mobazha/mobazha-unified
Review code for quality, architecture consistency, and adherence to Mobazha project standards using confidence-based filtering.
mobazha/mobazha-unified
Simplify and refine recently written code for clarity, consistency, and maintainability while preserving all functionality.
mobazha/mobazha-unified
Generate commit messages and run pre-commit validation following Mobazha conventions.
mobazha/mobazha-unified
Create and modify UI components following Mobazha conventions including directory structure, spacing standards, accessibility, and testing.
mobazha/mobazha-unified
Troubleshooting handbook for common issues in Mobazha development including build errors, Matrix connection issues, wallet problems, and performance debugging.
Categories
Accessibility guide for Mobazha following WCAG 2.1 AA standards including color contrast, reduced motion, ARIA patterns, keyboard navigation, focus management, and screen reader testing. A11y Guide is an agent skill from mobazha/mobazha-unified.1 AA standards including color contrast, reduced motion, ARIA patterns, keyboard navigation, focus management, and screen reader testing.
A11y Guide fits situations like: building accessible components; reviewing accessibility.
Run `npx skills add mobazha/mobazha-unified --skill a11y-guide -a claude-code`. Or copy the skill folder (.cursor/skills/a11y-guide in mobazha/mobazha-unified) into .claude/skills/a11y-guide in your project. Claude Code loads it when a task matches its description.
Run `npx skills add mobazha/mobazha-unified --skill a11y-guide -a codex`. Or copy the skill folder (.cursor/skills/a11y-guide in mobazha/mobazha-unified) into .agents/skills/a11y-guide in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mobazha/mobazha-unified --skill a11y-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/a11y-guide, .gemini/skills/a11y-guide, .github/skills/a11y-guide and .opencode/skills/a11y-guide in your project.
Going by SKILL.md and its folder, A11y Guide needs the command-line tools its instructions call (pnpm).
SKILL.md names 1 domain. As links in the text: webaim.org. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
A11y Guide is published under the MPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with A11y Guide: Web Interface Guidelines Reviewer (vercel-labs/openreview, 1.7k stars), Accessibility Review (markmead/hyperui, 12k stars), Web Animation Design (baptisteArno/typebot.io, 11k stars) and Accessibility Fixer (ibelick/ui-skills, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
mobazha (a GitHub organization) maintains it in mobazha/mobazha-unified, which has 165 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 3, 2026.
Source: mobazha/mobazha-unified on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.