Home
Softono
a

ashutos1997

Professional software vendor delivering innovative solutions on the Softono platform. Specialized in both open-source and proprietary software development.

Total Products
1

Software by ashutos1997

claude-design-auditor-skill
Open Source

claude-design-auditor-skill

[๐Ÿ‡ฐ๐Ÿ‡ท ํ•œ๊ตญ์–ด ๋ฒ„์ „ โ†’](./README_KR.md) # ๐ŸŽจ Design Auditor โ€” Claude Skill A Claude skill that audits designs against **19 professional design categories** โ€” built for developers, non-designers, and anyone who wants expert design validation without needing to know the rules themselves. Works with **Figma files** (via Figma MCP), **code** (HTML/CSS/React/Vue), **screenshots**, **wireframes**, and written descriptions. Supports **English and Korean**. Compatible with **Claude**, **Manus**, and other agents that support SKILL.md-based skills. --- ## What It Does Drop in a Figma link, paste your CSS, upload a screenshot, or share a wireframe โ€” Design Auditor checks your work against 19 categories of design rules and gives you: - A **score out of 100** with per-category breakdown (with mini bar chart per row) - A separate **Accessibility Score** (WCAG coverage across Cat 2, 6, 7, 15, 16) - A separate **Ethics Score** (dark patterns and manipulative design across Cat 18) - A separate **Usability Score** (Cat 19 โ€” H1/H2/H3/H6/H7/H10, with Nielsen cross-reference for H4/H5/H8/H9) - A **๐Ÿšซ Blocker tier** for legal/compliance violations (WCAG AA, GDPR, PECR) โ€” separate from Critical issues - Issues ranked by severity (๐Ÿšซ Blocker / ๐Ÿ”ด Critical / ๐ŸŸก Warning / ๐ŸŸข Tip) - **Color blindness context** โ€” every failing color pair annotated with the affected blindness type - **SVG accessibility checks** โ€” decorative vs. meaningful SVG patterns, aria-hidden, role="img" - **Design System detection** โ€” MUI, Chakra, shadcn/ui, Ant Design, Radix, Bootstrap (system-specific fixes) - **Figma Auto Layout scan** โ€” detects frames using manual positioning where Auto Layout should be used - **Plain-language explanations** of *why* each rule matters - **"Teach Me" mode** โ€” explains the design principles behind your top 3 issues, not just the fixes - An **Issue Priority Matrix** โ€” every issue plotted by effort vs. impact - Before/after code diffs when fixing issues in HTML/CSS/React/Vue - Direct fixes in your **Figma file** via Figma MCP - **Figma Code Connect** โ€” detects design-to-code mapping gaps (`get_code_connect_suggestions`) - **Wireframe to Spec** โ€” converts wireframes into annotated dev-ready specs - **Visual audit report** exportable to Canva for stakeholder sharing - **Developer handoff report** โ€” CSS spec table, a11y checklist, critical fixes - **Export report as Markdown** โ€” ready for Notion, GitHub, Linear, or Jira --- ## The 19 Audit Categories | # | Category | What It Checks | |---|---|---| | 1 | **Typography** | Hierarchy, font count, size, line height, contrast | | 2 | **Color & Contrast** | WCAG ratios, semantic color use, palette consistency | | 3 | **Spacing & Layout** | 8-point grid, proximity, alignment, whitespace | | 4 | **Visual Hierarchy** | Primary action clarity, reading patterns, size/contrast mapping | | 5 | **Consistency** | Component reuse, icon families, corner radius, interaction states | | 6 | **Accessibility (A11y / WCAG)** | Touch targets, focus states, alt text, form labels, reading order | | 7 | **Forms & Inputs** | Labels, sizing, validation timing, error placement, submit states | | 8 | **Motion & Animation** | Purpose, duration, easing, reduced-motion support | | 9 | **Dark Mode** | Not just inverted, surface elevation, saturation, icon legibility | | 10 | **Responsive & Adaptive** | Breakpoints, overflow, touch targets, type scaling | | 11 | **Loading, Empty & Error States** | Skeletons, empty state anatomy, error levels, success confirmation, Peak-End Rule, Goal Gradient progress checks | | 12 | **Content & Microcopy** | Button labels, error messages, tone consistency, terminology | | 13 | **Internationalization & RTL** | Text expansion, RTL mirroring, locale-aware formatting, font support | | 14 | **Elevation & Shadows** | Shadow scale, elevation hierarchy, dark mode depth | | 15 | **Iconography** | Icon families, optical sizing, touch targets, meaning consistency | | 16 | **Navigation Patterns** | Tabs, breadcrumbs, back buttons, mobile nav, active states | | 17 | **Design Tokens & Variables** | Semantic naming, hardcoded values, dark mode token swapping | | 18 | **Ethical Design & Dark Patterns** | Confirmshaming, false urgency, pre-checked consent, CTA hierarchy inversion, privacy zuckering, hidden costs, decoy pricing, manipulative anchoring, and 17 more manipulative patterns across 6 groups โ€” including a Regulatory Compliance Baseline (cookie consent, subscription disclosure, privacy at collection, cancellation policy, age gates, accessibility legal status) | | 19 | **Nielsen's 10 Usability Heuristics Rules** | Nielsen's 10 Usability Heuristics are the most widely used framework for evaluating interface usability. They were developed by Jakob Nielsen and are grounded in decades of usability research | --- ## Who It's For - **Developers** building UIs who don't have a design background - **Designers** who want a fast second opinion or WCAG check - **Teams** using Figma MCP or VS Code who want design validation in their workflow - **Product managers and founders** who want to ship ethical, accessible products - **Anyone** who's ever wondered "does this look right?" --- ## How to Install 1. Download [`design-auditor.skill`](../../releases/latest) from the releases page 2. Go to [Claude.ai](https://claude.ai) โ†’ **Customize** โ†’ **Skills** 3. Click **Upload skill** and select the file 4. Done โ€” the skill is now active in your conversations --- ## How to Use Once installed, just talk to Claude naturally: **English:** ``` "Check my design" โ†’ choose scope (full / quick / custom), then audit "Is this accessible?" โ†’ accessibility-focused audit "Review my form" โ†’ partial audit, relevant categories only "Does this follow WCAG?" โ†’ contrast & a11y audit "Check my Figma file: [link]" โ†’ Figma MCP audit "Any dark patterns here?" โ†’ ethics audit "Wireframe to spec" โ†’ annotated dev-ready spec from wireframe ``` **Korean:** ``` "๋””์ž์ธ ๊ฒ€ํ† ํ•ด์ค˜" โ†’ ์ „์ฒด ๊ฐ์‚ฌ "์ ‘๊ทผ์„ฑ ํ™•์ธํ•ด์ค˜" โ†’ ์ ‘๊ทผ์„ฑ ์ค‘์‹ฌ ๊ฐ์‚ฌ "๋‚ด ๋””์ž์ธ ๊ดœ์ฐฎ์•„ ๋ณด์—ฌ?" โ†’ ์ „์ฒด ๊ฐ์‚ฌ "UI ๊ฒ€ํ† ํ•ด์ค˜" โ†’ ์ „์ฒด ๊ฐ์‚ฌ "์ƒ‰์ƒ ๋Œ€๋น„ ํ™•์ธํ•ด์ค˜" โ†’ ์ƒ‰์ƒ ๋ฐ ์ ‘๊ทผ์„ฑ ๊ฐ์‚ฌ "์™€์ด์–ดํ”„๋ ˆ์ž„ ์ŠคํŽ™ ์ถœ๋ ฅํ•ด์ค˜" โ†’ ์™€์ด์–ดํ”„๋ ˆ์ž„ ์ŠคํŽ™ ๋ชจ๋“œ ``` --- ## Example Output ``` ## ๐Ÿ” Design Audit Report **Input:** Checkout flow ยท 3 frames **Type:** Figma MCP **Confidence:** ๐ŸŸข High **Component health:** 71% coverage ยท 2 detached instances ยท 8 unnamed layers **Code Connect:** 8 components mapped ยท 3 unmapped ### Overall Score: 62/100 100 โˆ’ (1 ร— ๐Ÿšซ 12) โˆ’ (2 ร— ๐Ÿ”ด 8) โˆ’ (4 ร— ๐ŸŸก 4) โˆ’ (2 ร— ๐ŸŸข 1) = 62/100 A legal compliance failure and contrast issues are the main drag. ### Accessibility Score: 55/100 โ€” significant gaps โš ๏ธ Contains legal compliance failures ### Ethics Score: 85/100 โ€” minor concerns ### ๐Ÿšซ Blockers (โˆ’12pts each) - **Text contrast failure** โ€” #aaa on white = 2.3:1 โ†’ Fix: use #595959 (7:1) Legal basis: WCAG 2.1 SC 1.4.3 ### ๐Ÿ”ด Critical Issues (โˆ’8pts each) - **Missing form labels** โ€” placeholder-only inputs lose label on type โ†’ Fix: add <label> above each input. ### ๐ŸŸก Warnings (โˆ’4pts each) - **Off-grid spacing** โ€” padding: 13px โ†’ Fix: use 12px or 16px - **CTA hierarchy inversion** โ€” "Accept all" primary, "Reject all" grey text โ†’ Fix: equivalent visual weight (GDPR requirement) ``` --- ## Skill Structure ``` design-auditor/ โ”œโ”€โ”€ SKILL.md โ€” Main skill instructions (19 categories) โ””โ”€โ”€ references/ โ”œโ”€โ”€ typography.md โ€” Font rules, sizing, hierarchy, type scale algorithm โ”œโ”€โ”€ color.md โ€” WCAG luminance formula, contrast, palette guidance โ”œโ”€โ”€ spacing.md โ€” 8-point grid, layout, proximity, code checks โ”œโ”€โ”€ corner-radius.md โ€” Nested radius rule, scale, pill shapes, code checks โ”œโ”€โ”€ elevation.md โ€” Shadow scale, elevation hierarchy, code shadow audit โ”œโ”€โ”€ iconography.md โ€” Icon families, sizing, touch targets โ”œโ”€โ”€ navigation.md โ€” Tabs, breadcrumbs, back buttons, mobile nav, code checks โ”œโ”€โ”€ tokens.md โ€” Design tokens, semantic naming, dark mode architecture โ”œโ”€โ”€ figma-mcp.md โ€” Figma MCP workflow, Code Connect, page structure, safe editing โ”œโ”€โ”€ heuristics.md โ€” Nielsen's 10 Usability Heuristics: H1/H2/H3/H6/H7/H10 gap coverage โ”œโ”€โ”€ states.md โ€” Loading, empty, error, success states + code checks โ”œโ”€โ”€ microcopy.md โ€” Button labels, errors, tone, per-role audit guide โ”œโ”€โ”€ animation.md โ€” Easing curves, duration scales, reduced motion, code checks โ”œโ”€โ”€ i18n.md โ€” RTL support, locale formatting, i18n โ””โ”€โ”€ ethics.md โ€” Dark patterns, ethical design, persuasion vs manipulation ``` --- ## Changelog ### v1.2.13 **Regulatory Compliance Baseline added to Cat 18.** **New: Regulatory Compliance Baseline (Cat 18 Group F)** 6 cross-jurisdiction UI-detectable compliance checks โ€” applicable across EU, US, UK, Canada, Brazil, Australia. ๐Ÿšซ Blocker when a legal requirement is clearly absent, ๐ŸŸก Warning when ambiguous. Each includes a code signal and a caveat that this is a UI signal layer, not a legal audit. Full Korean translations throughout. - **Cookie & consent banner** โ€” GDPR, PECR, CCPA: banner presence, Reject All at equal prominence to Accept All, granular consent categories - **Subscription & auto-renewal disclosure** โ€” FTC, CMA, EU Consumer Rights: renewal frequency, amount, and cancellation method visible before confirmation - **Privacy at point of collection** โ€” GDPR Art. 13, CCPA, PIPEDA: policy link or "why we need this" near sensitive input fields - **Right of withdrawal / cancellation policy** โ€” EU CRD, UK CRA, FTC: policy link visible near final checkout CTA - **Age gate for restricted content** โ€” COPPA, GDPR Art. 8, UK Age-Appropriate Design Code: verification mechanism before restricted content - **Accessibility legal baseline** โ€” ADA/Section 508 (US), EAA (EU โ€” mandatory June 2025), PSBAR (UK), DDA (Australia), AODA (Canada): Cat 6 Blockers carry legal weight ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.12 **Behavioural patterns from nudges.fyi, bug fixes, and visual report improvements.** **New: 5 behavioural pattern additions** - **Overchoice Paradox โ†’ Cat 4** โ€” 4+ equal-weight sibling actions with no primary โ†’ ๐ŸŸก; 6+ โ†’ ๐Ÿ”ด. Exempt: lists, nav menus, data tables - **Peak-End Rule โ†’ Cat 11** โ€” audits success/completion screens for memorability: named action, next step, positive visual signal, auto-redirect timing - **Goal Gradient Theory โ†’ Cat 11** โ€” detects multi-step flows with no progress bar, static fill bars, missing step totals, and `aria-valuenow` gaps - **Decoy Pricing โ†’ Cat 18 Group A** โ€” 3-column pricing with one tier strictly dominated on every axis - **Manipulative Anchoring โ†’ Cat 18 Group D** โ€” `text-decoration: line-through` / `.was-price` / `.rrp` patterns near current price elements **Bug fixes** - Cat 18 pattern count updated: 20 โ†’ 22 (both READMEs) - Cat 6 SVG `<use>`: added `xlink:href` legacy check alongside `href` - Cat 19 H1 "Multi-step progress" cross-references new Cat 11 Goal Gradient checks to avoid double-flagging - Scores panel: Ethics Score formula caveat added โ€” `๐Ÿ”ด โˆ’15 ยท ๐ŸŸก โˆ’7 ยท ๐ŸŸข 0`, distinct from standard formula - `heuristics.md` separator in skill structure: `-` โ†’ `โ€”` - README Cat 11 row updated to mention Peak-End Rule and Goal Gradient **Visual report improvements** - Radar chart: binary purple/red โ†’ three-colour scale โ€” purple (8โ€“10) ยท amber (6โ€“7) ยท red (โ‰ค 5) - Radar chart: fallback to Score by Category table when Visualizer unavailable (EN + KR) - Issue Priority Matrix: Korean axis labels added โ€” `์ˆ˜์ • ๋‚œ์ด๋„` (x) ยท `๊ฐœ์„  ํšจ๊ณผ` (y) - Score by Category table: score band footnote โ€” `โ‰ฅ 8 โœ… ยท 5โ€“7 ๐ŸŸก ยท โ‰ค 4 ๐Ÿ”ด` (EN + KR) - Re-audit delta: before/after bar pair rendered via Visualizer with colour-coded delta badge - Teach Me mode: 3-card Visualizer layout after lessons, each card clickable via `sendPrompt()` ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.11 **Code parity, design system detection, accessibility improvements, and bug fixes.** - **Code superpowers** โ€” added `๐Ÿ“‹ Code input:` blocks to Cat 4 (Visual Hierarchy), Cat 5 (Consistency), Cat 11 (States), Cat 12 (Microcopy), Cat 14 (Elevation), Cat 15 (Iconography) โ€” completing all 19 categories - **Design System detection** โ€” auto-detects MUI, Chakra UI, shadcn/ui, Ant Design, Radix, Bootstrap; system-specific issue types and fix paths - **Color blindness context** โ€” every failing color pair annotated with affected blindness type (Deuteranopia, Protanopia, Tritanopia) - **SVG accessibility** โ€” decorative `aria-hidden`, meaningful `role="img"` + `<title>`, icon-button label checks across Cat 6 and Cat 15 - **Figma Auto Layout scan** โ€” detects frames using manual positioning where Auto Layout should be used; shown in report header - **Accessibility Score** โ€” expanded from Cat 2/6/7/16 to Cat 2/6/7/**15**/16 (Cat 15 SVG checks are WCAG legal violations) - **Nielsen cross-reference** โ€” H4/H5/H8/H9 mapped in scores panel to Cat 5/7/4/11โ€“12 - **"Teach Me" mode** โ€” explains design principles behind top 3 issues (beginner + expert depth, full Korean) - **Scoring formula** โ€” Blockers now explicit: `100 โˆ’ (blockers ร— 12) โˆ’ (criticals ร— 8) โˆ’ (warnings ร— 4) โˆ’ (tips ร— 1)` - **Dev Handoff Report** โ€” added missing ๐ŸŸข Tips section; Korean translation included - **Output** โ€” mini bar column in Score by Category table; Design System + Auto Layout rows in report header; Cat 9 `color-scheme` meta tag check - **Bug fixes** โ€” category count "17" โ†’ "19" throughout; Cat 18/19 numbering corrected; `i19n.md` โ†’ `i18n.md`; Korean README category count corrected ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.10 **Dev Handoff Report, Wireframe to Spec โ€” restructured. Korean coverage for both.** **Dev Handoff Report restructured:** - `โ”โ”โ”` dividers between all sections for consistent visual separation - Blockers separated into their own section (`๐Ÿšซ BLOCKERS โ€” fix before any other work`) above Critical Fixes โ€” previously grouped together - All four scores in the metadata table: Overall, A11y, Ethics, Usability (with conditional notes for Ethics and Usability) - Code Connect mapping table included in template - Consistent `โ”โ”โ”`-wrapped footer **Wireframe to Spec restructured:** - All 8 sections now have `โ”โ”โ”` dividers with emoji headers (๐Ÿ“ ๐Ÿ“ ๐Ÿ”ค ๐Ÿงฉ โœ๏ธ ๐Ÿ–ฑ๏ธ โ™ฟ โ“) - Context notes moved into section headers directly after each `โ”โ”โ”` block, instead of scattered inline **Korean support added for both:** - Dev Handoff Report โ€” Korean note block: title, all 6 field labels, all 7 section headers, all 12 table column headers, footer - Wireframe to Spec โ€” bilingual footer lines + Korean note block: title, field labels, all 8 section headers with context notes, table column headers **README:** - v1.0.0โ€“v1.2.4 changelog entries collapsed into a `<details>` block ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.9 **Korean language coverage โ€” full audit pass** Audited all changes made since v1.2.4 for missing Korean support and filled every gap found. **SKILL.md gaps fixed:** - **Category 19 checklist** โ€” All 19 heuristic checklist items now have bilingual labels (e.g. "Async button feedback / ๋น„๋™๊ธฐ ๋ฒ„ํŠผ ํ”ผ๋“œ๋ฐฑ") - **Category 19 triggers** โ€” Korean trigger phrases added: "ํœด๋ฆฌ์Šคํ‹ฑ ๊ฒ€ํ† ", "๋‹์Šจ ๊ฐ์‚ฌ", "์‚ฌ์šฉ์„ฑ ํœด๋ฆฌ์Šคํ‹ฑ", "H1/H2/H6 ํ™•์ธ" - **Usability Score bands** โ€” All four bands now bilingual: "Heuristically sound / ์‚ฌ์šฉ์„ฑ ๊ธฐ์ค€ ์ถฉ์กฑ", "Minor gaps / ์‚ฌ์†Œํ•œ ์‚ฌ์šฉ์„ฑ ๋ฌธ์ œ", etc. - **Usability Score note in report** โ€” Korean version: "H4(์ผ๊ด€์„ฑ), H5(์˜ค๋ฅ˜ ์˜ˆ๋ฐฉ), H8(๋ฏธ์  ๋””์ž์ธ), H9(์˜ค๋ฅ˜ ๋ณต๊ตฌ)๋Š” ๊ฐ๊ฐ Cat 5, 7, 4, 11/12์—์„œ ๋‹ค๋ฃน๋‹ˆ๋‹ค." - **URL report header** โ€” Korean format added for all URL-type audits (๋ผ์ด๋ธŒ URL, ์‹ ๋ขฐ๋„, ์ œํ•œ์‚ฌํ•ญ) - **Wireframe spec fidelity line** โ€” Korean added: "๊ฐ’์€ ๊ถŒ์žฅ์‚ฌํ•ญ์ด๋ฉฐ ์‹ค์ธก๊ฐ’์ด ์•„๋‹™๋‹ˆ๋‹ค" **`heuristics.md` Korean support added:** - **Korean terminology table** โ€” 22 key UX terms with Korean equivalents (์‚ฌ์šฉ์„ฑ ํœด๋ฆฌ์Šคํ‹ฑ, ๋กœ๋”ฉ ์ƒํƒœ, ์ง„ํ–‰ ํ‘œ์‹œ๊ธฐ, ์˜จ๋ณด๋”ฉ, ์ผ๊ด„ ์ž‘์—…, etc.) - **Korean severity labels** โ€” ๐Ÿšซ ์ฐจ๋‹จ ยท ๐Ÿ”ด ์‹ฌ๊ฐ ยท ๐ŸŸก ๊ฒฝ๊ณ  ยท ๐ŸŸข ํŒ - **Korean heuristic note** โ€” Standard report note translated - **Usability Score bands** โ€” All four bands bilingual in the ref file - **Quick Reference Checklist** โ€” All 19 checklist items translated (e.g. "๋น„๋™๊ธฐ ์ž‘์—… ๋ฒ„ํŠผ์— ๋กœ๋”ฉ ์ƒํƒœ ์žˆ์Œ", "ํŒŒ๊ดด์  ์ž‘์—…์— ํ™•์ธ ๋Œ€ํ™”์ƒ์ž ์žˆ์Œ") ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.8 **Heuristics.md coverage โ€” no loose ends.** - Scope declaration (H4/H5/H8/H9 explicitly excluded with reasons) - Usability Score model with bands - H1 gaps โ€” async button loading state, form success confirmation, multi-step progress indicator - H2 โ€” jargon/error code detection, icon meaning mismatch, locale-aware date/number formats - H3 gaps โ€” modal close mechanism, flow back navigation, destructive action confirmation - H6 โ€” icon-only nav, disappearing floating labels, dropdown selection visibility - H7 โ€” keyboard shortcut hints, bulk action support, preference persistence - H10 โ€” helper text on complex fields, actionable error messages, contextual tooltips, onboarding guidance - Quick reference checklist covering all 6 heuristics Every entry has: definition, why it matters, Figma detection, code detection, severity, fix, and context note. ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.7 **URL inputs โ€” full support added** The skill now recognises and audits from any URL type, not just Figma links. | URL Type | Confidence | How it's handled | |---|---|---| | Live website (`https://...`) | ๐ŸŸก Medium | `web_fetch`, login handling, multi-page offer | | Vercel / Netlify preview | ๐ŸŸก Medium | Same as live website | | GitHub file URL | ๐ŸŸข High | Converts to raw URL, full code audit | | GitHub repo URL | ๐ŸŸก Medium | Browses key files, scope selector widget | | CodeSandbox / StackBlitz | ๐ŸŸกโ€“๐ŸŸข | Source if accessible, preview fallback | | CodePen | ๐ŸŸก Medium | Debug URL fetch, source extraction | | Storybook | ๐ŸŸก Medium | Component/variant detection from URL path | Each URL type has a dedicated spec: how to fetch, what confidence to set, what limitations to declare in the report header, how to handle login walls, and what to offer the user after the audit. GitHub file URLs get full ๐ŸŸข High confidence โ€” raw source is treated identically to pasted code. All other URL types get ๐ŸŸก Medium with explicit limitation notes in the report header. **Agent compliance โ€” mandatory output enforcement** Following reports of third-party agents (e.g. TRAE Solo) producing free-form UX reviews instead of scored reports, two mandatory enforcement notices were added: - `โš ๏ธ OUTPUT FORMAT IS MANDATORY โ€” DO NOT DEVIATE` at the top of Step 2 - `โš ๏ธ MANDATORY โ€” ALL AGENTS โ€” NO EXCEPTIONS` at the top of the Strict Output Template Both explicitly prohibit substituting a generic critique for the scored report. Skipping the score is never acceptable โ€” agents must estimate and flag with ๐ŸŸก Medium confidence if uncertain. **Input widget updated** โ€” "Live URL" and "GitHub URL" added as input type options alongside Figma, Screenshot, and Code. **All version stamps updated** โ€” report footers now correctly show v1.2.7. ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.6 **Wireframe to Spec mode** New output mode alongside the standard audit. When a wireframe is detected (greyscale, box placeholders, skeleton fidelity), the skill offers Spec mode before running a scored audit. Produces a structured design specification: Layout & Dimensions, Spacing, Typography, Components Required (with states), Copy Placeholders, Interaction Notes, Accessibility Requirements, and an Open Questions section that surfaces gaps the wireframe doesn't answer. - No score or severity labels โ€” Spec mode annotates, it doesn't audit - Estimated values clearly flagged with `~` prefix - Uses Figma layer data when available; falls back to standard defaults from reference files - Output as downloadable `.md` file - Auto-detected from wireframe input; also available in "What next?" widget post-audit - Triggers on: "wireframe to spec", "annotate my wireframe", "turn this wireframe into a spec", "spec out this design" **Canva visual audit report** After any audit, "Export to Canva" generates a visual report card in Canva โ€” score rings, issue summary, top 3 fixes, positives. Stakeholder-friendly format for sharing with non-technical audiences. Separate from the full technical Markdown export. **Trigger vocabulary expanded** Wireframe-specific trigger phrases added to YAML description. Stale version stamps in report templates fixed (were showing v1.2.2). ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.5 **Figma MCP โ€” three new tools integrated** - **`get_code_connect_suggestions`** โ€” AI-suggested Figmaโ†’code component mappings. Enriches Cat 5 and Cat 17. Flags unmapped components. Adds Code Connect line to report header. - **`get_code_connect_map`** โ€” confirmed mappings, powers the handoff table - **`create_design_system_rules`** โ€” generates enforcement rules for the repo, offered post-audit when token/component health is poor. Always requires explicit confirmation. **Scoring calibration โ€” Blocker tier** | Severity | Deduction | Basis | |---|---|---| | ๐Ÿšซ Blocker | โˆ’12pts | Legal/compliance โ€” WCAG AA, GDPR, PECR | | ๐Ÿ”ด Critical | โˆ’8pts | Usability failure | | ๐ŸŸก Warning | โˆ’4pts | Degrades experience | | ๐ŸŸข Tip | โˆ’1pt | Polish | Blocker examples: contrast below 4.5:1 (SC 1.4.3), keyboard-inaccessible element (SC 2.1.1), missing alt (SC 1.1.1), pre-checked marketing consent (GDPR), skip link missing (SC 2.4.1). Accessibility Score updated: Blockers use โˆ’12. Any Blocker appends "โš ๏ธ Contains legal compliance failures". **Trigger vocabulary expanded** โ€” 15+ new phrases: "is this GDPR compliant", "check my onboarding", "review my checkout", "is this manipulative", "any dark patterns here", "is my form accessible", and more. ------------------------------------------------------------------------------------------------------------------------------------------ <details> <summary><strong>v1.0.0โ€“v1.2.4</strong> โ€” earlier versions</summary> ### v1.2.4 **New: Category 19 โ€” Ethical Design & Dark Patterns** 20 manipulative patterns across 5 groups: Deceptive Interface, Coercive Flows, Consent & Privacy, False Urgency & Scarcity, Emotional Manipulation. Ethics severity model: ๐Ÿ”ด Deceptive (โˆ’15pts) ยท ๐ŸŸก Questionable (โˆ’7pts) ยท ๐ŸŸข Noted (0pts). Ethics Score shown alongside Accessibility Score. New `ethics.md` reference file โ€” 877 lines with full pattern taxonomy, detection signals, and Ethical Persuasion reference. ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.3 Code parity complete โ€” all 17 categories now check from source code. - **Cat 3** โ€” off-grid detection, z-index audit, padding consistency, content margin, logical properties - **Cat 16** โ€” `<nav>` semantics, `aria-current`, skip link, tab vs nav misuse, keyboard handling, breadcrumb structure - **`spacing.md`, `navigation.md`, `animation.md`, `corner-radius.md`** โ€” all with full code-specific audit sections ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.2 - `get_design_pages` as mandatory F1.5 step โ€” file structure before auditing - Type Scale Stack triggers on every audit โ€” extracts font sizes directly from `get_design_context` - Component health metric in report header โ€” coverage %, detached instances, unnamed layers - 2-frame cross-check for consistency (Cat 5) - Microcopy reads every text node, classifies by role, cites exact text + node ID - Issue deduplication โ€” same root cause โ†’ one grouped entry - Framework detection + before/after code diffs for code input - Code superpowers added to Cat 6, 7, 8, 9, 10, 13, 17 - Standardised report template with fixed sections - Re-audit spec, Explain an issue depth, Developer Handoff Report template ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.1 - Scoring formula always shown in every report - Color contrast via design tokens โ€” `get_variable_defs` drives Cat 2 - `animation.md` added โ€” full Cat 8 reference - Figma fix loop partial failure recovery - Auto-layout ops and component instance caveat in `figma-mcp.md` ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.2.0 - 5 interactive audit widgets: Type Scale Stack, Contrast Checker, 8pt Grid Visualizer, States Coverage Map, Issue Priority Matrix - Smart defaults โ€” scope, stage, WCAG level inferred from request - Component-type detection and confidence scoring - Session progress tracker with sparkline - Full Korean coverage ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.1.5 - Figma Variables integration, audit goal context, WCAG level selector - Separate Accessibility Score, Developer handoff mode - Fix all Critical loop, bilingual widget labels ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.1.4 - Audit scope selector: Full / Quick / Custom - Partial audit mode, severity filter, Markdown export ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.1.3 - Figma MCP fallback, per-category scores, before/after diffs, re-audit delta ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.1.2 - Deterministic scoring formula, confidence level, strict output template ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.1.1 - Korean language support ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.1.0 - 17 categories: added Corner Radius, Elevation, Iconography, Navigation, Design Tokens ------------------------------------------------------------------------------------------------------------------------------------------ ### v1.0.0 - Initial release: 13 audit categories, 7 reference files ------------------------------------------------------------------------------------------------------------------------------------------ </details> ## Contributing Found a design rule that should be in here? Open an issue or PR. Areas that could use expansion: - UX flow analysis & information architecture - Data visualization & charts - Native mobile (iOS/Android) specific patterns - Print / PDF layout rules --- ## License MIT โ€” use it, fork it, build on it. --- *Built with [Claude](https://claude.ai) ยท Skill format by [Anthropic](https://anthropic.com)*

AI Tools Design Systems & Tokens
55 Github Stars