smartui-skill — скилл для Claude Code: что делает и установка
Скилл настраивает визуальные регрессионные тесты SmartUI для сравнения скриншотов. Подходит для проверки страниц и компонентов в разных браузерах и viewport.
MIT 237 установок ★ 393 обновлён 2026-10-13
npx skills add LambdaTest/agent-skills --skill smartui-skill -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/smartui-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/smartui-skill/
1Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill smartui-skill -a codex2Вручную: положить файлы
.agents/skills/smartui-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill smartui-skill -a cursor2Вручную: положить файлы
.cursor/skills/smartui-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install LambdaTest/agent-skills smartui-skill2Вручную: положить файлы
.github/skills/smartui-skill/SKILL.md1Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill smartui-skill -a gemini-cli2Командой платформы
gemini skills install https://github.com/LambdaTest/agent-skills --path smartui-skillВручную: положить файлы
.devin/skills/smartui-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill smartui-skill -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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