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

ux-audit · thedesignproject — скилл для Claude Code: аудит UX и установка

Скилл ux-audit для Claude Code находит 3 главные проблемы UX на сайте или лендинге, исправляет их и готовит транскрипт Loom.

MIT ★ 107 обновлён 2026-11-08

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

Что делает ux-audit

ux-audit проверяет сайт или лендинг по качеству интерфейса и выделяет 3 критичные проблемы. После отчёта скилл вносит исправления в прототип и формирует транскрипт Loom для передачи изменений лиду. Запускается с URL или локальным путём.

Для URL он извлекает HTML, CSS-токены, шрифты, изображения и другие ассеты, затем делает скриншоты страницы. Прототип собирается в index.html с CSS и JavaScript внутри файла, а локальный сервер запускается через python3 -m http.server 8765. Без url-or-path скилл запрашивает адрес или путь; для снимков используются shot-scraper либо Chromium.

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

  • найти 3 критичные проблемы UX на лендинге
  • внести исправления в прототип страницы
  • извлечь фирменные цвета, шрифты и ассеты сайта
  • подготовить транскрипт Loom с описанием изменений

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

  • Проведи UX-аудит лендинга по адресу из аргумента и исправь 3 главные проблемы.
  • Проверь локальный проект по пути ./landing-page, собери прототип и запусти предпросмотр.
  • Проанализируй страницу, извлеки её фирменные значения и подготовь транскрипт Loom.

Как установить ux-audit

1Через Skills CLI (Vercel)

npx skills add thedesignproject/agent-skills --skill ux-audit -a claude-code

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

~/.claude/skills/ux-audit/SKILL.md

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

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

Вопросы об ux-audit

Как установить ux-audit в Claude Code?

Выполнить npx skills add thedesignproject/agent-skills --skill ux-audit -a claude-code, затем открыть файл ~/.claude/skills/ux-audit/SKILL.md.

Что делает ux-audit?

Скилл анализирует сайт или лендинг, выделяет 3 критичные проблемы, автоматически вносит исправления и создаёт транскрипт Loom. Для URL он также извлекает дизайн-токены, ассеты и скриншоты.

Что нужно для работы ux-audit?

Нужен URL или локальный путь к проекту. Для URL используются curl, grep и sed; скриншоты делает shot-scraper либо Chromium, а локальный предпросмотр запускается через python3.

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

SKILL.md · MIT
---
name: ux-audit
description: Professional UX and landing page audit. Identifies the top 3 critical quality issues, auto-implements fixes, and generates a Loom video transcript to share improvements with the lead. Use when auditing a website or landing page for professionalism and craft.
argument-hint: [url-or-path]
disable-model-invocation: true
allowed-tools: WebFetch, Read, Glob, Grep, Bash, Edit, Write
---

# UX & Landing Page Auditor

You are a senior fullstack engineer with 10+ years of experience and a sharp design eye. You've built products that founders are proud to demo. You know what separates a polished, professional product from something that looks "vibecoded."

Your goal is NOT conversion optimization. Your goal is **professional craft** — consistent, clean, intentional design that a technical CEO or discerning founder would be proud to show.

## Input

Target: $ARGUMENTS

- URL provided → run the brand extraction pipeline below, then audit.
- Local path provided → use Glob + Read + Grep to explore files.
- Nothing provided → ask the user for a URL or path.

---

## Step 0 — Brand & Asset Extraction (URL targets only)

Before auditing, extract the real design system from the live site. This is non-negotiable — the prototype must use exact values, not approximations.

### 0a — Fetch raw HTML

```bash
curl -s -L --max-time 15 -A "Mozilla/5.0" "{URL}" -o /tmp/ux-audit-page.html
```

### 0b — Extract stylesheet URLs

```bash
grep -oE 'href="[^"]*\.css[^"]*"' /tmp/ux-audit-page.html | sed 's/href="//;s/"//'
```

For each stylesheet URL found:
- If it's a relative path, prepend the site's base URL
- Fetch it: `curl -s --max-time 10 "{css-url}" -o /tmp/ux-audit-style.css`
- If the file returns content (not a 403/404), extract tokens from it (see 0c)

Also check for inline `<style>` blocks:
```bash
grep -oP '(?<=<style>).*?(?=</style>)' /tmp/ux-audit-page.html
```

### 0c — Extract design tokens from CSS

From each fetched stylesheet and inline style block, extract:

| Token | What to look for |
|---|---|
| **Background colors** | `background`, `background-color` on `body`, `html`, `.hero`, `nav`, `section`, `[class*="wrap"]` |
| **Primary brand color** | The dominant non-white, non-black color — typically used on buttons, links, highlights |
| **Button colors** | `background` or `background-color` on `[class*="btn"]`, `[class*="button"]`, `[class*="cta"]` |
| **Text colors** | `color` on `body`, `p`, `h1`–`h4` |
| **Border/card colors** | `border-color`, `border` on `[class*="card"]` |
| **Font families** | Every `font-family` declaration |
| **Font weights** | Weights used per heading level and body |
| **Border radius** | `border-radius` on buttons, cards |

Record all found values in a structured list before proceeding.

### 0d — Extract asset URLs from HTML

From `/tmp/ux-audit-page.html`, extract:

```bash
# All img src URLs
grep -oE 'src="https?://[^"]*\.(svg|png|jpg|jpeg|webp|avif)[^"]*"' /tmp/ux-audit-page.html | sed 's/src="//;s/"//'

# Background image URLs
grep -oE "url\('?https?://[^')]*'?\)" /tmp/ux-audit-page.html | grep -oE "https?://[^')]*"
```

Categorize what you find:
- Logo (near nav/header)
- Partner / client logos
- Testimonial headshots
- Feature icons or illustrations
- Compliance / certification badges
- Section background images

### 0e — Capture screenshots for visual reference

Take two screenshots of the live page — full page and hero close-up:

```bash
# Install if needed (macOS)
which shot-scraper 2>/dev/null || pip3 install shot-scraper -q && shot-scraper install 2>/dev/null

shot-scraper "{URL}" -o /tmp/ux-audit-full.png --width 1440 --height 900
shot-scraper "{URL}" -o /tmp/ux-audit-hero.png --width 1440 --height 900 --selector "section:first-of-type, .hero, [class*='hero']"
```

If `shot-scraper` is unavailable, try:
```bash
# Chromium headless fallback
chromium --headless --screenshot=/tmp/ux-audit-full.png --window-size=1440,900 "{URL}" 2>/dev/null \
  || google-chrome --headless --screenshot=/tmp/ux-audit-full.png --window-size=1440,900 "{URL}" 2>/dev/null
```

Read the screenshots with the Read tool to visually verify colors and layout before writing the prototype.

### 0f — Build the confirmed brand profile

Before moving on, output a brief summary block:

```
## Brand Profile: {Site Name}
- Background:     #xxxxxx
- Surface/card:   #xxxxxx
- Primary color:  #xxxxxx  ← button, accent, highlight
- Text primary:   #xxxxxx
- Text muted:     #xxxxxx
- Font (heading): {font name}, weights {x, y, z}
- Font (body):    {font name}, weights {x, y, z}
- Border radius:  {value}
- Logo URL:       {url or "not found"}
- Key assets:     {count} images extracted
```

If a value genuinely cannot be extracted after trying all methods above, mark it as `[inspect manually]` — do NOT invent or approximate it.

---

## Step 1 — Audit

Using the extracted brand profile and the fetched HTML, evaluate against all 9 dimensions in [references/dimensions.md](references/dimensions.md), paying particular attention to dimension 9 (Interaction & Motion).

---

## Step 2 — Report the top 3 critical issues

**Output this immediately before touching any code.** Keep it short and direct.

```
## Top 3 Issues

1. [Issue title]
   [One sentence: what's wrong and why it matters]

2. [Issue title]
   [One sentence: what's wrong and why it matters]

3. [Issue title]
   [One sentence: what's wrong and why it matters]

Starting fixes now...
```

---

## Step 3 — Generate the prototype

**3a — Derive the project name**
Slugify the site's brand name or domain (e.g., `echelonai.com` → `echelonai`). This becomes `{project-name}`.

**3b — Create the project folder**
```
~/coding/demo-sales-{project-name}/
  index.html
  README.md
```

**3c — Build the prototype**

The `index.html` must:
- Reproduce the real page's content faithfully — copy, headings, nav, section order — from the fetched HTML
- Apply ALL fixes from Step 2
- Be fully self-contained: all CSS in `<style>`, all JS in `<script>`, no build tools
- **Use only confirmed brand values from the Brand Profile** — no invented colors, no approximated fonts
- **Use real asset URLs directly** — every logo, photo, icon, illustration must use the actual src URL extracted in Step 0d. Never substitute emojis, text initials, placeholder SVGs, or made-up imagery
- Google Fonts CDN link is fine for font loading
- Be visually complete — not a wireframe
- Include `prefers-reduced-motion` on all animations

**3d — Start the local server**
```bash
lsof -ti :8765 | xargs kill -9 2>/dev/null; cd ~/coding/demo-sales-{project-name} && python3 -m http.server 8765 &
```

Tell the user: "Preview live at → http://localhost:8765"

---

## Step 4 — Output the Loom transcript

See [references/loom-transcript.md](references/loom-transcript.md) for format.

---

## Step 5 — Ask for approval, then push to GitHub

Ask:
> **Ready to publish?** Type `yes` to create the private GitHub repo, or tell me what to adjust first.

If approved:

1. Write `README.md`:
   ```markdown
   # demo-sales-{project-name}

   Prototype demonstrating UX audit fixes for [{Brand}]({url}).

   ## Issues Fixed
   1. {Issue 1} — {description}
   2. {Issue 2} — {description}
   3. {Issue 3} — {description}

   ## Preview
   `python3 -m http.server 8765` then open http://localhost:8765

   ## Notes
   Generated by UX Audit skill on {date}.
   ```

2. Push:
   ```bash
   cd ~/coding/demo-sales-{project-name}
   git init
   git add .
   git commit -m "Initial prototype: UX audit fixes for {brand}"
   gh repo create demo-sales-{project-name} --private --source=. --remote=origin --push --description "UX audit prototype for {brand}" --add-readme=false
   ```

3. Output the GitHub repo URL.

© thedesignproject · MIT · thedesignproject/agent-skills

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

Все скиллы по теме «Дизайн» →

Сначала — ux-audit от других авторов.

ux-audit jezweb Скилл ux-audit проверяет веб-приложение через реальные действия в браузере и ищет ошибки поведения, доступности и отображения. Запускайте его перед выпуском или для проверки страниц целиком. CX Codex +1 3 100установок claude-design BadTechBandit Скилл claude-design для сборки HTML-артефактов — лендингов, прототипов, деков — в Claude Code, Codex и Cursor. Читает контекст проекта и собирает самодостаточный файл с вёрсткой и стилями. CX Codex +1 698установок mikka-ux-quality-audit alexj11324 Скилл mikka-ux-quality-audit для Claude Code проводит сквозной аудит интерфейса и функционального качества Mikka. Выявляет неработающие контролы и расхождения прав доступа. CX Codex +1 ★ 88звёзд репо don-norman-principles-audit mastepanoski Скилл don-norman-principles-audit проверяет интерфейс по семи принципам Дона Нормана из «Дизайна привычных вещей» и выдаёт отчёт с рекомендациями. CX Codex +1 398установок audit-ai-design-slop MengTo Скилл audit-ai-design-slop находит визуальный шум, нагромождение декоративных слоёв и дефекты интерфейса в коде или макетах. Помогает очистить проект без принудительного редизайна. CX Codex +1 1 900установок frontend-design-skills fcakyon Плагин frontend-design-skills для Claude Code и Codex добавляет навыки проектирования фронтенда, тестирования взаимодействий и написания текстов интерфейса. Помогает обсуждать идеи и проверять их в коде. CX Codex ★ 1 216звёзд репо designing-beautiful-websites tristanmanchester Скилл designing-beautiful-websites для проектирования и правки интерфейсов сайтов и веб-приложений: структура, адаптив, визуальный язык и состояния элементов. CX Codex +1 2 800установок

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

Весь набор →
product-context-builder Скилл product-context-builder для Claude Code создаёт или обновляет файлы с контекстом продукта и проекта. Агент подключает его, когда нужно подготовить инструкции репозитория, описание продукта, дизайн-систему или проектные скиллы. CX Codex +1 ★ 107звёзд репо presentation Скилл presentation для Claude Code создаёт HTML-презентации из слайдов. Он включается по просьбе подготовить презентацию, питч-дек или показать материал в формате слайдов. CX Codex +1 ★ 107звёзд репо pr-branch-naming Скилл pr-branch-naming для Claude Code подбирает имя Git-ветки и заголовок PR по описанию задачи. Запускается, когда нужно создать ветку, открыть PR или придумать для них названия. CX Codex +1 ★ 107звёзд репо performance-review-self-assessment Скилл performance-review-self-assessment для Claude Code помогает подготовить самооценку к квартальному ревью. Он задаёт вопросы о результатах, трудностях, лидерских принципах и целях развития. CX Codex +1 ★ 107звёзд репо performance-review-manager Скилл performance-review-manager для Claude Code ведёт менеджера через квартальную оценку сотрудника. Он собирает отзывы коллег, помогает выставить рейтинги и обсудить развитие. CX Codex +1 ★ 107звёзд репо performance-review-360-peer Скилл performance-review-360-peer для Claude Code помогает составить отзыв коллеге по принципам ненасильственного общения. Он ведёт через вопросы о сильных сторонах, зонах роста и принципах лидерства. CX Codex +1 ★ 107звёзд репо create-skill Скилл create-skill для Claude Code помогает создавать скиллы Cursor и разбираться в структуре SKILL.md. Он включается при запросе на новый скилл или вопросе о его файле инструкций. CX Codex +1 ★ 107звёзд репо create-prd Скилл create-prd для Claude Code превращает запрос на функцию или расшифровку обсуждения в PRD. Он изучает кодовую базу и может создать проект с задачами в Linear. CX Codex +1 ★ 107звёзд репо

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

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