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

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

Генерирует E2E-тесты Detox для приложений на React Native на JavaScript и TypeScript. Помогает писать сценарии для эмуляторов и облака TestMu AI.

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

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

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

Скилл учит ассистента строить E2E-тесты на базе Detox для React Native. Фреймворк синхронизирует действия автоматически. Поэтому скилл исключает ручные тайм-ауты и вызовы задержек, опираясь на встроенные механизмы ожидания. Внутри собраны шаблоны поиска элементов по testID, тексту и native traits, а также команды управления устройством: перезагрузка бандла, свайпы, эмуляция GPS и блокировка URL-адресов.

Кроме типовых тестов скилл генерирует конфигурацию .detoxrc.js для сборок под iOS и Android. Для удалённых тестов описаны команды выгрузки APK и IPA в облако TestMu AI через REST API LambdaTest. Без заданных переменных LT_USERNAME и LT_ACCESS_KEY облачные запуски работать не будут.

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

  • написать сквозной тест авторизации с поиском элементов по testID
  • настроить конфигурационный файл .detoxrc.js для эмуляторов iOS и Android
  • подготовить curl-команды для запуска Espresso и XCUITest в TestMu AI
  • избавиться от нестабильных вызовов waitFor и ручных задержек в тестах

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

  • Напиши Detox-тест для экрана логина с проверкой ошибок валидации
  • Собери конфиг .detoxrc.js для симулятора iPhone 16 и эмулятора Pixel 7
  • Покажи команду для отправки тестового APK в облако LambdaTest

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о detox-skill

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

Выполните в терминале команду npx skills add LambdaTest/agent-skills --skill detox-skill -a claude-code. Также можно вручную сохранить файл в ~/.claude/skills/detox-skill/SKILL.md.

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

Скилл передаёт агенту правила написания gray-box тестов Detox для React Native. Он формирует корректные матчеры, проверки состояния элементов и сценарии без ручных задержек.

Что требуется для запуска тестов в облаке TestMu AI?

Нужны переменные окружения $LT_USERNAME и $LT_ACCESS_KEY для авторизации в API LambdaTest. Сгенерированные артефакты приложения и тестов передаются через curl перед запуском раннера.

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

SKILL.md · MIT
---
name: detox-skill
description: >
  Generates Detox E2E tests for React Native apps in JavaScript. Gray-box testing
  framework with automatic synchronization. Supports local simulators/emulators
  and TestMu AI cloud. Use when user mentions "Detox", "React Native test",
  "element(by.id())", "device.launchApp". Triggers on: "Detox", "React Native E2E",
  "React Native test", "element(by.id)", "device.launchApp".
languages:
  - JavaScript
  - TypeScript
category: mobile-testing
license: MIT
metadata:
  author: TestMu AI
  version: "1.0"
---

# Detox Automation Skill

You are a senior React Native QA engineer specializing in Detox.

## Core Patterns

### Basic Test

```javascript
describe('Login', () => {
  beforeAll(async () => {
    await device.launchApp();
  });

  beforeEach(async () => {
    await device.reloadReactNative();
  });

  it('should login with valid credentials', async () => {
    await element(by.id('emailInput')).typeText('[email protected]');
    await element(by.id('passwordInput')).typeText('password123');
    await element(by.id('loginButton')).tap();
    await expect(element(by.id('dashboardTitle'))).toBeVisible();
    await expect(element(by.text('Welcome'))).toBeVisible();
  });

  it('should show error for invalid credentials', async () => {
    await element(by.id('emailInput')).typeText('[email protected]');
    await element(by.id('passwordInput')).typeText('wrong');
    await element(by.id('loginButton')).tap();
    await expect(element(by.id('errorMessage'))).toBeVisible();
  });
});
```

### Matchers (Finding Elements)

```javascript
element(by.id('uniqueId'))                    // testID prop (best)
element(by.text('Login'))                      // Text content
element(by.label('Submit'))                    // Accessibility label
element(by.type('RCTTextInput'))              // Native type
element(by.traits(['button']))                 // iOS traits

// Combined
element(by.id('list').withDescendant(by.text('Item 1')))
element(by.id('item').withAncestor(by.id('list')))

// At index (multiple matches)
element(by.text('Delete')).atIndex(0)
```

### Actions

```javascript
await element(by.id('btn')).tap();
await element(by.id('btn')).longPress();
await element(by.id('btn')).multiTap(3);
await element(by.id('input')).typeText('hello');
await element(by.id('input')).replaceText('new text');
await element(by.id('input')).clearText();
await element(by.id('scrollView')).scroll(200, 'down');
await element(by.id('scrollView')).scrollTo('bottom');
await element(by.id('item')).swipe('left', 'fast');
await element(by.id('input')).tapReturnKey();
```

### Expectations

```javascript
await expect(element(by.id('title'))).toBeVisible();
await expect(element(by.id('title'))).not.toBeVisible();
await expect(element(by.id('title'))).toExist();
await expect(element(by.id('title'))).toHaveText('Welcome');
await expect(element(by.id('toggle'))).toHaveToggleValue(true);
await expect(element(by.id('input'))).toHaveValue('hello');
```

### Device Control

```javascript
await device.launchApp({ newInstance: true });
await device.reloadReactNative();
await device.sendToHome();
await device.terminateApp();
await device.installApp();
await device.shake();                       // Shake gesture
await device.setLocation(37.7749, -122.4194); // GPS
await device.setURLBlacklist(['.*cdn.example.*']); // Block URLs
```

### Anti-Patterns

| Bad | Good | Why |
|-----|------|-----|
| `waitFor().withTimeout()` everywhere | Trust Detox auto-sync | Detox waits automatically |
| No `testID` on components | Add `testID` prop | Stable selectors |
| `device.launchApp()` in every test | `device.reloadReactNative()` | Faster |
| Manual delays | Detox synchronization | Built-in waiting |

### .detoxrc.js Configuration

```javascript
module.exports = {
  testRunner: { args: { config: 'e2e/jest.config.js' } },
  apps: {
    'ios.debug': {
      type: 'ios.app',
      binaryPath: 'ios/build/MyApp.app',
      build: 'xcodebuild -workspace ios/MyApp.xcworkspace -scheme MyApp -configuration Debug -sdk iphonesimulator -derivedDataPath ios/build',
    },
    'android.debug': {
      type: 'android.apk',
      binaryPath: 'android/app/build/outputs/apk/debug/app-debug.apk',
      build: 'cd android && ./gradlew assembleDebug assembleAndroidTest -DtestBuildType=debug',
      reversePorts: [8081],
    },
  },
  devices: {
    simulator: { type: 'ios.simulator', device: { type: 'iPhone 16' } },
    emulator: { type: 'android.emulator', device: { avdName: 'Pixel_7_API_34' } },
  },
  configurations: {
    'ios.sim.debug': { device: 'simulator', app: 'ios.debug' },
    'android.emu.debug': { device: 'emulator', app: 'android.debug' },
  },
};
```

## Cloud Execution on TestMu AI

Detox generates native test runners (Espresso for Android, XCUITest for iOS). Run on TestMu AI cloud by uploading the built artifacts and triggering a framework build.

### Android (Espresso) Cloud Run

```bash
# 1. Build the app and test APKs
detox build --configuration android.emu.debug

# 2. Upload app APK
curl -u "$LT_USERNAME:$LT_ACCESS_KEY" \
  -X POST "https://manual-api.lambdatest.com/app/upload/realDevice" \
  -F "appFile=@android/app/build/outputs/apk/debug/app-debug.apk" \
  -F "name=DetoxApp"
# Response: {"app_url": "lt://APP_ID", ...}

# 3. Upload test APK
curl -u "$LT_USERNAME:$LT_ACCESS_KEY" \
  -X POST "https://manual-api.lambdatest.com/app/upload/realDevice" \
  -F "appFile=@android/app/build/outputs/apk/androidTest/debug/app-debug-androidTest.apk" \
  -F "name=DetoxTestSuite"
# Response: {"app_url": "lt://TEST_SUITE_ID", ...}

# 4. Trigger Espresso build
curl -X POST "https://mobile-api.lambdatest.com/framework/v1/espresso/build" \
  -H "Authorization: Basic <BASE64_AUTH>" \
  -H "Content-Type: application/json" \
  -d '{
    "app": "lt://APP_ID",
    "testSuite": "lt://TEST_SUITE_ID",
    "device": ["Galaxy S21 5G-12", "Pixel 6-12"],
    "build": "Detox-Android",
    "deviceLog": true,
    "video": true
  }'
```

### iOS (XCUITest) Cloud Run

```bash
# 1. Build the iOS app and test runner
detox build --configuration ios.sim.release

# 2. Create .ipa from the build artifacts, then upload
curl -u "$LT_USERNAME:$LT_ACCESS_KEY" \
  -X POST "https://manual-api.lambdatest.com/app/upload/realDevice" \
  -F "[email protected]" -F "name=DetoxApp"

# 3. Upload test runner .ipa
curl -u "$LT_USERNAME:$LT_ACCESS_KEY" \
  -X POST "https://manual-api.lambdatest.com/app/upload/realDevice" \
  -F "[email protected]" -F "name=DetoxTestSuite"

# 4. Trigger XCUITest build
curl -X POST "https://mobile-api.lambdatest.com/framework/v1/xcui/build" \
  -H "Authorization: Basic <BASE64_AUTH>" \
  -H "Content-Type: application/json" \
  -d '{
    "app": "lt://APP_ID",
    "testSuite": "lt://TEST_SUITE_ID",
    "device": ["iPhone 14-16", "iPhone 13-15"],
    "build": "Detox-iOS",
    "devicelog": true,
    "video": true
  }'
```

## Quick Reference

| Task | Command |
|------|---------|
| Build iOS | `detox build --configuration ios.sim.debug` |
| Test iOS | `detox test --configuration ios.sim.debug` |
| Build Android | `detox build --configuration android.emu.debug` |
| Test Android | `detox test --configuration android.emu.debug` |
| Specific test | `detox test --configuration ios.sim.debug e2e/login.test.js` |
| Record video | `detox test --record-videos all` |
| Take screenshot | `await device.takeScreenshot('login-page')` |

## Setup

```bash
npm install detox --save-dev
npm install jest jest-circus --save-dev
detox init
```

## React Native Component Setup

```jsx
// Add testID to components for Detox
<TextInput testID="emailInput" placeholder="Email" />
<TextInput testID="passwordInput" placeholder="Password" secureTextEntry />
<Button testID="loginButton" title="Login" onPress={handleLogin} />
<Text testID="errorMessage">{error}</Text>
```

## Deep Patterns

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

© TestMu AI · MIT · LambdaTest/agent-skills

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

Все скиллы по теме «Тесты и QA» →
detox sanjeed5 Задаёт стандарты E2E-тестирования на Detox в React Native: требует паттерн Page Object Model и селекторы по testID без произвольных пауз через sleep. CX Codex +1 ★ 3 589звёзд репо typescript-expo-jest-detox-cursorrules-prompt-file PatrickJS Правило typescript-expo-jest-detox-cursorrules-prompt-file для Cursor задаёт стандарты разработки на TypeScript, React Native и Expo для генерации мобильного UI. CX Codex +1 ★ 41 178звёзд репо limrun-detox-testing limrun-inc Скилл limrun-detox-testing помогает настроить, запустить и отладить тесты Detox на удалённых симуляторах Limrun iOS. Пригодится при пробросе туннелей к медиатору и инжекции рантайма в приложение. CX Codex +1 45 300установок react-native-testing pluginagentmarketplace Скилл react-native-testing по тестированию React Native: настройка Jest, тесты компонентов и хуков через Testing Library, моки нативных модулей и E2E-сценарии на Detox. CX Codex +1 113установок maestro-e2e raphaelbarbosaqwerty Скилл maestro-e2e для написания и отладки E2E-тестов на Maestro: логины, регистрация, навигация, диалоги разрешений. Работает с iOS, Android, Flutter, React Native и вебом. CX Codex +1 543установок mobile-app-testing aj-geddes Скилл mobile-app-testing задаёт правила тестирования приложений для iOS и Android. Помогает писать юнит-, UI- и интеграционные тесты с Jest, Detox, Espresso и XCTest. CX Codex +1 834установок

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

Весь набор →
cucumber-skill Создаёт сценарии Cucumber на Gherkin и связанные step definitions. Он описывает поведение приложения через BDD-сценарии. CX Codex +1 283установок webdriverio-skill Скилл генерирует E2E-тесты WebdriverIO на JavaScript или TypeScript. Подходит для локального запуска и облака TestMu AI. CX Codex +1 265установок cypress-skill Генерирует production-grade E2E и component-тесты на JavaScript или TypeScript. Работает локально и в облаке TestMu AI, понимает команды Cypress и сразу пишет тесты с правильными селекторами и перехватом сети. CX Codex +1 264установок robot-framework-skill Скилл robot-framework-skill для Claude Code пишет .robot-тесты на Python в keyword-driven синтаксисе: браузерные — на SeleniumLibrary, API — на RequestsLibrary. Превращает описанный словами сценарий в тест. CX Codex +1 253установок hyperexecute-skill Скилл настраивает запуск тестов через HyperExecute: создаёт YAML, проверяет конфигурацию, запускает задания и помогает разбирать сбои. CX Codex +1 250установок xcuitest-skill Генерирует UI-тесты на XCUITest для iOS и iPadOS приложений. Работает с локальными симуляторами Xcode и облачными устройствами TestMu AI — выбирает целевую платформу автоматически. CX Codex +1 248установок puppeteer-skill Генерирует Puppeteer-скрипты для браузерной автоматизации, скрейпинга и PDF. Срабатывает на упоминание Puppeteer, headless Chrome, page.goto, scrape. CX Codex +1 247установок testng-skill Генерирует Java-тесты для TestNG с группами, наборами данных и параллельным запуском. Настраивает тестовые suite и слушателей. CX Codex +1 243установок

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

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