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

smartui-skill — скилл для Claude Code: что делает и установка

Скилл настраивает визуальные регрессионные тесты SmartUI для сравнения скриншотов. Подходит для проверки страниц и компонентов в разных браузерах и viewport.

MIT 237 установок ★ 393 обновлён 2026-10-13

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

Что делает smartui-skill

smartui-skill генерирует конфигурации SmartUI для визуального тестирования. Он помогает подключить сравнение скриншотов к Playwright, Selenium, Cypress и Puppeteer, а также настроить запуск через CLI или Storybook. Поддерживаются JavaScript, TypeScript и Java.

Скилл создаёт smartui.config.json с браузерами, viewport и ожиданием рендера, затем запускает тесты через npx smartui exec. Первый запуск формирует базовые изображения, следующие сравнивают их с новой версией, а различия проходят проверку в панели SmartUI. Для CLI нужен PROJECT_TOKEN, а облачному Selenium или Playwright также нужны LT_USERNAME и LT_ACCESS_KEY.

Для установки через Claude Code выполните команду npx skills add LambdaTest/agent-skills --skill smartui-skill -a claude-code; файл появится в ~/.claude/skills/smartui-skill/SKILL.md. Без PROJECT_TOKEN CLI-подход не сможет пройти облачную аутентификацию.

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

  • сравнить скриншоты страницы с базовой версией
  • проверить интерфейс в нескольких браузерах и viewport
  • запустить визуальные тесты Playwright через SmartUI
  • настроить снимки компонентов Storybook
  • проверить и утвердить визуальные различия

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

  • Настрой визуальные регрессионные тесты SmartUI для текущего проекта на Playwright.
  • Создай smartui.config.json для Chrome, Firefox и Safari с несколькими viewport.
  • Запусти Storybook через SmartUI и сравни снимки компонентов.

Как установить smartui-skill

1Через Skills CLI (Vercel)

npx skills add LambdaTest/agent-skills --skill smartui-skill -a claude-code

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

~/.claude/skills/smartui-skill/SKILL.md

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

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

Вопросы о smartui-skill

Как установить smartui-skill в Claude Code?

Выполните npx skills add LambdaTest/agent-skills --skill smartui-skill -a claude-code, затем используйте файл ~/.claude/skills/smartui-skill/SKILL.md.

Что делает smartui-skill?

Он создаёт конфигурации SmartUI для визуального сравнения скриншотов и запускает тесты с Playwright, Selenium, Cypress или Puppeteer. Результаты сравниваются с базовыми изображениями.

Что нужно для запуска SmartUI через CLI?

Для CLI-подхода задайте переменную PROJECT_TOKEN. Для облачного Selenium или Playwright дополнительно используются LT_USERNAME и LT_ACCESS_KEY.

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

SKILL.md · MIT
---
name: smartui-skill
description: >
  Generates SmartUI visual regression test configurations for screenshot
  comparison on TestMu AI cloud. Framework-agnostic — works with Playwright,
  Selenium, Cypress, Puppeteer. Use when user mentions "SmartUI", "visual
  regression", "screenshot comparison", "visual testing". Triggers on:
  "SmartUI", "visual regression", "screenshot comparison", "pixel diff",
  "visual testing LambdaTest".
languages:
  - JavaScript
  - TypeScript
  - Java
category: visual-testing
license: MIT
metadata:
  author: TestMu AI
  version: "1.0"
---

# SmartUI Visual Regression Skill

## Core Patterns

### Playwright + SmartUI SDK

```javascript
const { chromium } = require('playwright');
const { smartuiSnapshot } = require('@lambdatest/smartui-cli');

(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();

  await page.goto('https://example.com');
  await smartuiSnapshot(page, 'Homepage');

  await page.goto('https://example.com/login');
  await smartuiSnapshot(page, 'Login Page');

  await browser.close();
})();
```

### Selenium + SmartUI

```java
// Take SmartUI screenshot
((JavascriptExecutor) driver).executeScript(
    "smartui.takeScreenshot=Login Page"
);
```

### CLI Execution

```bash
# Install
npm install @lambdatest/smartui-cli@latest --save-dev

# Configure
npx smartui config:create smartui.config.json

# Execute
npx smartui exec -- node test.js
# or with Playwright
npx smartui exec -- npx playwright test
```

### smartui.config.json

```json
{
  "web": {
    "browsers": ["chrome", "firefox", "safari"],
    "viewports": [[1920, 1080], [1366, 768], [375, 812]]
  },
  "waitForPageRender": 5000,
  "waitForTimeout": 1000
}
```

### SmartUI with Storybook

```bash
npx smartui storybook http://localhost:6006 --config smartui.config.json
```

### Approval Workflow

1. First run creates baseline screenshots
2. Subsequent runs compare against baseline
3. Differences highlighted in dashboard
4. Approve/reject changes in LambdaTest SmartUI dashboard
5. Approved screenshots become new baseline

### Anti-Patterns

| Bad | Good | Why |
|-----|------|-----|
| No viewport config | Multiple viewports | Responsive issues |
| No wait for render | `waitForPageRender` | Incomplete screenshots |
| Screenshot everything | Key pages/components | Noise reduction |
| No approval process | Review diffs in dashboard | Catch regressions |

### Cloud Authentication

Set environment variables:

```bash
export PROJECT_TOKEN="your-smartui-project-token"   # From SmartUI dashboard
export LT_USERNAME="your-username"                   # For Selenium/Playwright cloud
export LT_ACCESS_KEY="your-access-key"               # For Selenium/Playwright cloud
```

**CLI approach** (uses `PROJECT_TOKEN`):
```bash
npx smartui exec -- npx playwright test
```

**Selenium Cloud approach** (uses `LT_USERNAME`/`LT_ACCESS_KEY`):
```java
// Capabilities include SmartUI options
HashMap<String, Object> ltOptions = new HashMap<>();
ltOptions.put("user", System.getenv("LT_USERNAME"));
ltOptions.put("accessKey", System.getenv("LT_ACCESS_KEY"));
ltOptions.put("build", "SmartUI Build");
ltOptions.put("smartUI.project", "My SmartUI Project");
ChromeOptions options = new ChromeOptions();
options.setCapability("LT:Options", ltOptions);
WebDriver driver = new RemoteWebDriver(
    new URL("https://hub.lambdatest.com/wd/hub"), options);
```

## Quick Reference

| Task | Command |
|------|---------|
| Install | `npm install @lambdatest/smartui-cli@latest` |
| Init config | `npx smartui config:create smartui.config.json` |
| Run | `npx smartui exec -- <test command>` |
| Storybook | `npx smartui storybook <url>` |
| Dashboard | `https://smartui.lambdatest.com` |

## Deep Patterns

For advanced patterns, debugging guides, CI/CD integration, and best practices,
see `reference/playbook.md`.

© TestMu AI · MIT · LambdaTest/agent-skills

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

Все скиллы по теме «Тесты и QA» →
triaging-visual-review-runs PostHog Скилл triaging-visual-review-runs разбирает падения визуальных проверок PostHog Visual Review в PR и помогает отделить реальные регрессии скриншотов от флакующих тестов Storybook и Playwright. CX Codex +1 398установок playwright-visual-testing manutej Скилл playwright-visual-testing помогает проверять веб-интерфейсы через Playwright MCP: делать снимки страниц, проходить пользовательские сценарии и искать визуальные изменения. CX Codex +1 1 400установок browser-qa affaan-m Скилл browser-qa гоняет живой интерфейс через браузерный MCP: ошибки в консоли, Core Web Vitals, формы, скриншоты на трёх ширинах и axe-core. Выносит вердикт SHIP или DO NOT SHIP. CX Codex +1 6 900установок frontend-visual-qa daymade Скилл frontend-visual-qa для Claude Code проверяет отрисованный интерфейс в браузере и проходит пользовательские сценарии. Запускается для визуального аудита сайтов, дашбордов и других уже собранных интерфейсов. CX Codex +1 664установок threejs-qa-release majidmanzarpour Скилл threejs-qa-release для Claude Code проверяет Three.js-игры перед выпуском. Он запускает плейтесты, визуальные проверки и собирает риски релиза. CX Codex +1 4 000установок screenshot bobmatnyc Скилл screenshot для Claude Code помогает проверять изменения интерфейса по скриншотам на desktop, tablet и mobile. Оформляет результаты UI-проверки для pull request. CX Codex +1 396установок

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

Весь набор →
puppeteer-skill Генерирует Puppeteer-скрипты для браузерной автоматизации, скрейпинга и PDF. Срабатывает на упоминание Puppeteer, headless Chrome, page.goto, scrape. CX Codex +1 247установок testng-skill Генерирует Java-тесты для TestNG с группами, наборами данных и параллельным запуском. Настраивает тестовые suite и слушателей. CX Codex +1 243установок codeception-skill Генерирует приёмочные, функциональные и модульные BDD-тесты Codeception на PHP. Автоматизирует тестирование пользовательских сценариев и веб-страниц. CX Codex +1 243установок flutter-testing-skill Скилл flutter-testing-skill генерирует виджет-тесты, интеграционные тесты и golden-тесты для Flutter на Dart. Запускает локально или на реальных устройствах через TestMu AI облако. CX Codex +1 242установок jasmine-skill Генерирует тесты на Jasmine для JavaScript и TypeScript. BDD-стиль, спаи для моков, поддержка асинхронного кода — автоматически создаст describe, it, expect и spy. CX Codex +1 237установок mocha-skill Генерирует тесты Mocha для JavaScript и TypeScript с проверками Chai и моками Sinon. Охватывает модульное тестирование. CX Codex +1 235установок unittest-skill Генерирует тесты на встроенном фреймворке Python unittest с TestCase, setUp/tearDown и методами проверки. Срабатывает, когда вы упоминаете unittest, TestCase или self.assertEqual. CX Codex +1 235установок espresso-skill Скилл помогает писать UI-тесты Android-приложений на Espresso для Kotlin или Java. Используйте его, чтобы проверить действия на экране и ожидаемое состояние интерфейса. CX Codex +1 234установок

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

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