consistency-auditor — Claude Code skill: what it does, how to install
consistency-auditor is a Claude Code skill that audits source code against a project Design Foundation to find visual inconsistencies. It flags duplicate literal colors and border-radius values.
MIT ★ 529 updated 2026-11-17
npx skills add ShuaiMXu/happyhands --skill consistency-auditor -a claude-codeWhat consistency-auditor does
The skill checks source code against approved Design Foundation entries to identify UI implementation discrepancies. Its deterministic handler scans for repeated hardcoded colors and literal border-radius declarations, citing exact files and values.
During the review, intentional variations are separated from accidental duplication. The logic favors mapping values back to existing tokens or components, suggesting a new design element only when the current system cannot accommodate the case. It avoids calculating arbitrary experience scores.
Auditing requires both product source code and a project Design Foundation. Assessing component equivalence or visual context still demands subsequent human evaluation.
What it helps with
- audit source code against approved Design Foundation tokens
- detect hardcoded colors and literal border-radius values
- identify accidental styling duplicates across UI files
- consolidate custom styling into existing design tokens
Example prompts for the agent
- Audit our frontend code against the Design Foundation
- Find hardcoded color literals and border-radius values in the UI
- Identify inconsistent styling and suggest approved design tokens
How to install consistency-auditor
1Skills CLI (Vercel)
npx skills add ShuaiMXu/happyhands --skill consistency-auditor -a claude-code2Manually: put the files in place
~/.claude/skills/consistency-auditor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/consistency-auditor/
1Skills CLI (Vercel)
npx skills add ShuaiMXu/happyhands --skill consistency-auditor -a codex2Manually: put the files in place
.agents/skills/consistency-auditor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ShuaiMXu/happyhands --skill consistency-auditor -a cursor2Manually: put the files in place
.cursor/skills/consistency-auditor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ShuaiMXu/happyhands skills/product-design/consistency-auditor2Manually: put the files in place
.github/skills/consistency-auditor/SKILL.md1Skills CLI (Vercel)
npx skills add ShuaiMXu/happyhands --skill consistency-auditor -a gemini-cli2Platform CLI
gemini skills install https://github.com/ShuaiMXu/happyhands --path skills/product-design/consistency-auditorManually: put the files in place
.devin/skills/consistency-auditor/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about consistency-auditor
How do I install consistency-auditor in Claude Code?
Run npx skills add ShuaiMXu/happyhands --skill consistency-auditor -a claude-code.
What does consistency-auditor do?
It audits source code against approved Design Foundation entries to pinpoint styling discrepancies, focusing on repeated raw colors and border-radius values.
What is required to run consistency-auditor?
The audit requires access to your product source code and a project Design Foundation.
Source text
SKILL.md · MIT
--- name: consistency-auditor description: Audit a product for visual and component inconsistencies when source code and a project Design Foundation are available. --- # Consistency Auditor Identify inconsistent implementations that increase user confusion or maintenance cost. Treat static frequency as a signal for review, not proof of a UX defect. - Compare implementation values with `approved` Foundation entries. - Cite every file and value used as evidence. - Separate deliberate variants from unexplained duplication. - Prefer consolidation into an existing approved token or component; propose a new artifact only when the existing system cannot express the need. - State confidence and uncertainty. Do not convert an arbitrary threshold into an Experience Score. The deterministic handler currently detects repeated literal colors and border-radius values. Component equivalence, visual context and intentional exceptions require later analysis.
© ShuaiMXu · MIT · ShuaiMXu/happyhands