К основному содержанию
скилл CX Codex

experience-design-validate — скилл для Claude Code: аудит интерфейса

Скилл experience-design-validate проводит визуальный аудит интерфейса по скриншотам или URL и составляет отчёт по пяти критериям качества. Пригодится на дизайн-ревью перед релизом.

Apache-2.0 220 установок ★ 1 183 обновлён 2026-10-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add forcedotcom/sf-skills --skill experience-design-validate -a claude-code
Открыть на GitHub

Что делает experience-design-validate

Скилл анализирует готовый визуальный слой программы по скриншотам, макетам Figma или страницам в браузере. Оценка строится по пяти параметрам: полезность, понятность, надёжность, цельность и проработанность деталей. Исходный код разметки или стилей здесь не проверяется — фокус сосредоточен только на видимых решениях.

Без готовых пикселей проверка не начнётся: скилл требует скриншоты в форматах вроде .png или .webp, ссылку для открытия в браузере или кадры из Figma. Если визуальных артефактов нет, запуск завершится со статусом INSUFFICIENT_VISUAL_EVIDENCE.

Инструмент не проверяет соответствие стандартам доступности WCAG и дизайн-токенам SLDS. Для доступности разработчики рекомендуют experience-accessibility-validate, а для проверки токенов — design-systems-slds-validate.

Какие задачи решает

  • провести визуальный аудит интерфейса по скриншотам
  • сравнить два варианта макета перед передачей в разработку
  • выявить перегруженные или несогласованные зоны на экране
  • составить отчёт о визуальном качестве перед дизайн-чеком

Примеры запросов агенту

  • Проверь скриншот layout.png и составь отчёт о визуальном качестве
  • Сравни визуальную иерархию на двух макетах: variant-a.png и variant-b.png
  • Оцени состояние формы на экране screen.png по пяти критериям

Как установить experience-design-validate

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill experience-design-validate -a claude-code

2Вручную: положить файлы

~/.claude/skills/experience-design-validate/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/experience-design-validate/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об experience-design-validate

Как установить experience-design-validate в Claude Code?

Выполните команду npx skills add forcedotcom/sf-skills --skill experience-design-validate -a claude-code.

Что делает experience-design-validate?

Скилл оценивает визуальное исполнение интерфейса по готовым изображениям и формирует отчёт с оценками по пяти шкалам качества.

Подходит ли скилл для проверки доступности по WCAG?

Нет, аудит касается только видимого слоя. Для проверки доступности и экранных дикторов предназначен скилл experience-accessibility-validate.

Исходный текст

SKILL.md · Apache-2.0
---
name: experience-design-validate
description: "Use this skill to run a visual-craft audit of a rendered UI and produce an evidence-grounded Craft Report across Useful, Usable, Reliable, Coherent, and Well-Crafted. Invoke it for craft audits, visual critiques, design comparisons, felt-quality reviews, or visual-craft readiness checks on screenshots (.png, .jpg, .jpeg, .webp, .gif), Figma frames, rendered prototypes, and live URLs. Do not use it for source-code review, SLDS compliance (use design-systems-slds-validate), or accessibility compliance (use experience-accessibility-validate)."
metadata:
  version: "1.0"
  domains: ["Experience", "Design Systems"]
  relatedSkills:
    - "design-systems-slds-validate"
    - "experience-accessibility-validate"
    - "experience-lwc-generate"
    - "experience-lwc-security-validate"
---

# Experience Design Validate

Evaluate the visual craft of rendered software: what the eye sees and the felt quality those visible decisions create. Judge relationships, hierarchy, restraint, consistency, and care rather than CSS, tokens, or implementation technique.

This is a **visual-craft-only** audit. It does not establish WCAG conformance, keyboard or screen-reader support, behavioral usability, implementation quality, or production release readiness. Route accessibility compliance to `experience-accessibility-validate` and SLDS compliance to `design-systems-slds-validate`.

## Use and boundaries

Use this skill to:

- Critique visual craft at a design checkpoint.
- Explain why a rendered design feels considered, cramped, calm, fragmented, or delightful.
- Compare the craft of two or more designs solving the same brief.
- Identify design moves that would lift a visible experience from good to great.

Do not use this skill for:

- Implementation or code review. For LWC generation or security review, use `experience-lwc-generate` or `experience-lwc-security-validate` as appropriate.
- Accessibility compliance, including WCAG, screen-reader, keyboard, or focus-order validation. Use `experience-accessibility-validate`.
- SLDS design-token compliance. Use `design-systems-slds-validate`.
- Claims about real-user behavior. Recommend a usability study when impact depends on behavior rather than visible evidence.

## Visual evidence contract

Rendered pixels are mandatory. Prefer screenshots because they preserve the exact evidence reviewed.

1. **Screenshots:** use supplied full-page or region captures directly.
2. **Live URL:** if browser capability is available, open the URL, exercise only the relevant paths, capture screenshots, and retain the URL and viewport as evidence. Otherwise ask for screenshots.
3. **Figma:** if Figma capability is available, fetch or export the named rendered frames. Treat a frame as static unless prototype behavior is actually exercised. Otherwise ask for frame exports or screenshots.
4. **Screen recording or interactive prototype:** inspect observable transitions and capture representative frames when tooling supports it.
5. **Source code, design descriptions, or inaccessible links:** do not infer the rendered result. Render with available capability; otherwise request screenshots.

If no rendered pixels are available:

- **Interactive run:** ask the user for screenshots or another rendered artifact and pause the audit.
- **Non-interactive run:** return status `INSUFFICIENT_VISUAL_EVIDENCE` with a short statement of the missing artifact. Do not score, assign a verdict, create findings, or imply readiness.

### Evidence modes

Declare one mode before analysis:

| Mode | What it can support | What it cannot support |
|---|---|---|
| `STATIC_VISUAL` | Visible hierarchy, spacing, typography, color, density, composition, consistency, and the visible treatment of the captured moment | Interaction behavior, transitions between states, responsive adaptation beyond captured viewports, latency, runtime performance, or unseen states |
| `MULTI_VIEW_STATIC` | Static visual evidence across supplied screens, states, or viewport captures, including cross-screen coherence | The behavior connecting captures, timing, input response, runtime performance, or states not shown |
| `DYNAMIC_VISUAL` | Static qualities plus behavior directly exercised or recorded: interaction feedback, transitions, state changes, and perceived performance | Unexercised paths, unrecorded states, accessibility compliance, or measured performance beyond what was observed |

A static screenshot of a loading, error, or empty state supports critique of that state's **visible treatment only**. It does not substantiate state coverage, transition behavior, or performance. Never lower a score because an unobserved state or behavior was not supplied; mark that coverage `INSUFFICIENT_EVIDENCE` instead.

## Five dimensions

| Dimension | Felt question |
|---|---|
| **Useful** | Does the visible content earn the space and attention it occupies? |
| **Usable** | Does the visible hierarchy and affordance make the intended path feel obvious? |
| **Reliable** | Do the observed states and feedback make the experience feel predictable? |
| **Coherent** | Does the visible experience feel made by one team with one taste? |
| **Well-Crafted** | Does the visible design feel precise, considered, and delightful? |

Use a 1-10 score only when the available evidence adequately covers a dimension. Use `INSUFFICIENT_EVIDENCE` when an applicable dimension cannot be supported. Use `N/A` only when the dimension or topic genuinely does not apply, never merely because evidence is missing.

Read `references/scoring-rubric.md` for scoring anchors, verdict rules, severity definitions, and the complete report contract.

## Craft lens

Ask whether the rendered experience feels:

- **Breathable:** space structures the composition and gives the eye room.
- **Approachable:** the intended path is visually obvious without explanation.
- **Inviting:** visible states encourage exploration rather than present dead ends.
- **Considered:** repeated decisions form a system rather than an accumulation.
- **Quiet:** hierarchy is calm; few elements compete to be primary.
- **Delightful:** detail and personality are purposeful, not ornamental noise.
- **Confident:** the design has a point of view and avoids unnecessary hedging.

## Audit workflow

Follow this order:

1. Establish the evidence mode and inventory every supplied or captured artifact.
2. If no rendered pixels exist, follow the insufficient-visual-evidence behavior and stop.
3. Look before consulting rules. Record up to three honest first impressions for each design.
4. Build the coverage and relevance ledger. For every dimension and reference topic, record `SCORED`, `N/A`, or `INSUFFICIENT_EVIDENCE`, the evidence mode, and a concise reason.
5. Load `references/craft.md`, `references/scoring-rubric.md`, and `references/visual-system.md`. Load only conditional references whose topic is both relevant and observable in the evidence mode.
6. Score only supported dimensions. Select the **highest anchor whose applicable, observable criteria are fully supported**; use an odd score only when evidence clearly exceeds that anchor without fully supporting the next.
7. Write findings. Cap findings at five per dimension and deduplicate cross-dimensional root causes.
8. Write the Craft Report, including the ledger and evidence limitations.

## Progressive disclosure

Always load:

- `references/scoring-rubric.md`: scoring, coverage, severity, verdict, and report schema.
- `references/craft.md`: felt qualities of considered work.
- `references/visual-system.md`: visible layout, typography, color, and surfaces.

Load only when relevant **and observable**:

| Reference | Evidence needed |
|---|---|
| `references/components.md` | Visible buttons, inputs, modals, lists, tables, or feedback components |
| `references/navigation.md` | Visible navigation, tabs, breadcrumbs, search, or wayfinding |
| `references/responsive.md` | Captures from multiple viewports or directly exercised resizing |
| `references/forms-flows.md` | Multiple visible steps or directly exercised form behavior |
| `references/data.md` | Visible charts, dashboards, metrics, filters, results, or tables |
| `references/records.md` | Visible records, detail pages, status, metadata, or collaboration |
| `references/ai.md` | Visible AI, agent, chat, citations, or model output |
| `references/trust.md` | Visible auth, privacy, consent, permissions, or destructive settings |
| `references/usability.md` | Visible task structure; do not infer behavioral usability |
| `references/interaction.md` | `DYNAMIC_VISUAL` evidence of interaction or motion |
| `references/state.md` | `DYNAMIC_VISUAL` state transitions; static state captures support appearance only |
| `references/performance.md` | `DYNAMIC_VISUAL` evidence of timing, latency, or layout stability |

## Finding voice

Speak at the felt level and anchor claims to visible evidence.

Good: "The toolbar feels overworked; too many controls compete for attention, so the eye cannot find the primary action."

Wrong scope: "Three button classes use inconsistent spacing tokens." That belongs in implementation or SLDS review.

Each finding must include `severity`, `primary_dimension`, optional `related_dimensions`, `location`, `problem`, `why_it_weakens_craft`, `what_better_looks_like`, and `fix`. When one problem appears in three or more places, create one finding with a count and representative location.

## Comparative audits

Audit each design independently with the same evidence requirements and rubric. The report must include:

- Per-design evidence mode, coverage ledger, first impressions, dimension scores, evidence, and gap to the next supported level.
- A side-by-side comparison table that preserves `N/A` and `INSUFFICIENT_EVIDENCE` rather than forcing numeric comparisons.
- A result of `A_HIGHER_CRAFT`, `B_HIGHER_CRAFT`, `TIE`, or `MIXED`. Use `MIXED` when leadership varies by dimension or evidence coverage prevents an overall ranking.
- Differentiating dimensions, concrete craft moves each design makes better, and improvements each could borrow without copying.

Do not crown a winner when the evidence supports a tie or mixed outcome.

## Output

If the user explicitly supplies an output path, write there exactly; that path overrides the naming convention. Otherwise use `YYYY-MM-DD-<target-slug>-craft-audit-<VERDICT>.md`, with uppercase `PASS`, `WARN`, `FAIL`, or `LIMITED`.

The report must make its scope explicit: verdicts and readiness implications cover **visual craft only**, not accessibility, functional correctness, measured performance, or production release approval.

Recommendations and cross-cutting patterns each contain **zero to five** items. Include only evidence-backed, useful entries; never add filler to reach a quota. End with the fix prompt defined in `references/scoring-rubric.md` only when at least one actionable recommendation exists.

## Core principles

1. **Pixels first.** No rendered evidence means no visual-craft audit.
2. **Eye first, rules second.** Record first impressions before rubric analysis.
3. **Evidence bounds claims.** Unobserved behavior is unknown, not defective.
4. **Felt level, not implementation level.** Describe visual experience, not code.
5. **Teach while auditing.** Explain why each finding matters and what better feels like.
6. **Severity over volume.** A few sharp findings beat a padded checklist.

© forcedotcom · Apache-2.0 · forcedotcom/sf-skills

Похожие скиллы

Все скиллы по теме «Дизайн» →
frontend-design-review DauQuangThanh Скилл frontend-design-review проверяет интерфейсы на соответствие дизайн-системе, контрастность WCAG 2.1 AA и адаптивность. Пригодится перед вёрсткой макетов из Figma или Sketch. CX Codex +1 463установок edit-figma-design dominikmartn Скилл edit-figma-design для Claude Code создаёт и обновляет макеты Figma на основе текстовых описаний. Запускается при запросе на проектирование интерфейсов или внесение правок в существующие файлы. CX Codex +1 ★ 720звёзд репо ultimate-design-system-master ft.ia.br Скилл ultimate-design-system-master для Claude Code пошагово создаёт дизайн-системы, токены, компоненты и документацию через 10 генераторов. Проводит от брифа до кода экранов. CX Codex +1 ★ 141звёзд репо design-to-motion elayadesign Скилл design-to-motion для Claude Code превращает статичный макет в анимированную HTML-версию. Запускается по просьбе оживить экран, карточки, дашборд или макет из Figma. CX Codex +1 ★ 85звёзд репо ui-ux-designer Seth Hobson Субагент ui-ux-designer проектирует интерфейсы, вайрфреймы и дизайн-системы. Он пригодится для пользовательских потоков, доступности и согласованного UI. CX Codex 27 069установок design-is thedotmack Скилл design-is проверяет интерфейс по десяти принципам Дитера Рамса, выставляет баллы с доказательствами и готовит промпт для команды /make-plan. CX Codex +1 4 700установок

Из того же набора232

Весь набор →
experience-search-coordinate Скилл experience-search-coordinate координирует поиск статей, новостей и медиафайлов в Salesforce CMS. Он распределяет запросы на поиск структурированного контента и файлов по нужным каналам. CX Codex +1 275установок experience-lwc-legacy-migrate Скилл experience-lwc-legacy-migrate проверяет полноту миграции компонентов Aura в LWC и переводит внешние страницы Lightning Out Beta на Lightning Out 2.0 с OAuth PKCE. CX Codex +1 245установок platform-agenticsetup-categories-get Скилл platform-agenticsetup-categories-get получает категории Agentic Setup из подключённой Salesforce org через Connect API. Можно запросить и вложенные промпты. CX Codex +1 235установок experience-cms-content-render Скилл experience-cms-content-render для Claude Code, Codex, Cursor и других агентов, который встраивает готовый контент Salesforce CMS в React- или Angular-приложение uiBundle. CX Codex +1 226установок platform-role-hierarchy-apply Скилл platform-role-hierarchy-apply для Claude Code перестраивает иерархию ролей Salesforce по оргсхеме. Он подключается для пакетного изменения ролей, а перед отправкой показывает сводку операций для подтверждения администратора. CX Codex +1 178установок consumer-goods-promotion-bo-api-deploy Скилл consumer-goods-promotion-bo-api-deploy включает Promotion BO API в Salesforce Consumer Goods Cloud, создаёт и деплоит кастомный Workflow Step и проверяет весь путь через REST. CX Codex +1 160установок dx-org-snapshot-manage Скилл dx-org-snapshot-manage для Claude Code управляет снимками scratch-оргов Salesforce. Автоматизирует создание слепков данных и метаданных через командную строку sf. CX Codex +1 149установок agentforce-persona-generate Скилл agentforce-persona-generate для Claude Code и Codex проектирует образ ИИ-агента Salesforce Agentforce. Переводит брендбук в тон, границы поведения и готовый файл .agent. CX Codex +1 146установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой