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

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

Скилл prowler-test-ui задаёт правила E2E-тестирования интерфейса Prowler на Playwright. Пригодится при написании и правке тестов в каталоге ui/tests.

Apache-2.0 ★ 15 302 обновлён 2026-10-25

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

Что делает prowler-test-ui

Скилл регламентирует структуру тестов веб-интерфейса Prowler. Для каждой фичи в каталоге ui/tests/{page-name}/ создаются три файла: Page Object класс {page-name}-page.ts, тесты {page-name}.spec.ts и обязательный файл документации {page-name}.md. Тестовые идентификаторы формата @PROV-E2E-001 в коде должны строго совпадать с записями в Markdown-файле, иначе доработка не считается завершённой.

Внутри заложены готовые базовые классы и строгие правила ожидания. Инструкция запрещает использовать networkidle и waitForTimeout, подменяя их явными проверками toBeVisible(), методами verifyPageLoaded() или ожиданием адреса через waitForURL(). Проверки редиректов и URL выносятся внутрь методов пейдж-объекта verifyOn{PageName}Page(), а не пишутся прямо в теле теста.

Перед написанием кода тестов инструкция предписывает исследовать страницы через Playwright MCP: снять снапшот DOM, проверить селекторы и реальное поведение форм. Без поддержки MCP-инструментов Playwright в окружении этот этап придётся пропускать вручную.

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

  • оформить Page Object по структуре репозитория Prowler UI
  • синхронизировать теги тест-кейсов между spec.ts и документацией .md
  • избавиться от нестабильных ожиданий networkidle в тестах Playwright
  • написать тесты создания провайдеров или запуска сканирований

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

  • Напиши E2E-тест для страницы добавления провайдера по стандартам Prowler
  • Обнови ui/tests/scans/scans.spec.ts и синхронизируй проверки в scans.md
  • Создай Page Object для формы входа с методом проверки редиректа

Как установить prowler-test-ui

1Через Skills CLI (Vercel)

npx skills add prowler-cloud/prowler --skill prowler-test-ui -a claude-code

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

~/.claude/skills/prowler-test-ui/SKILL.md

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

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

Вопросы о prowler-test-ui

Как установить prowler-test-ui в Claude Code?

Выполните команду npx skills add prowler-cloud/prowler --skill prowler-test-ui -a claude-code в терминале.

Что делает этот скилл?

Он направляет ИИ-агента при написании E2E-тестов Playwright для интерфейса Prowler: следит за структурой каталогов, обязательным наличием .md-описания и запрещает хрупкие тайм-ауты.

Почему скилл запрещает networkidle?

Ожидание networkidle приводит к падению тестов из-за фонового поллинга и активных соединений WebSockets в интерфейсе Prowler.

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

SKILL.md · Apache-2.0
---
name: prowler-test-ui
description: >
  E2E testing patterns for Prowler UI (Playwright).
  Trigger: When writing Playwright E2E tests under ui/tests in the Prowler UI (Prowler-specific base page/helpers, tags, flows).
license: Apache-2.0
metadata:
  author: prowler-cloud
  version: "1.0"
  scope: [root, ui]
  auto_invoke:
    - "Writing Prowler UI E2E tests"
    - "Working with Prowler UI test helpers/pages"
allowed-tools: Read, Edit, Write, Glob, Grep, Bash, WebFetch, WebSearch, Task
---

> **Generic Patterns**: For base Playwright patterns (Page Object Model, selectors, helpers), see the `playwright` skill.
> This skill covers **Prowler-specific** conventions only.

## Prowler UI Test Structure

```text
ui/tests/
├── base-page.ts              # Prowler-specific base page
├── helpers.ts                # Prowler test utilities
└── {page-name}/
    ├── {page-name}-page.ts   # Page Object Model
    ├── {page-name}.spec.ts   # ALL tests (single file per feature)
    └── {page-name}.md        # Test documentation (MANDATORY - sync with spec.ts)
```

---

## MANDATORY Checklist (Create or Modify Tests)

**⚠️ ALWAYS verify BEFORE completing any E2E task:**

### When CREATING new tests
- [ ] `{page-name}-page.ts` - Page Object created/updated
- [ ] `{page-name}.spec.ts` - Tests added with correct tags (@TEST-ID)
- [ ] `{page-name}.md` - Documentation created with ALL test cases
- [ ] Test IDs in `.md` match tags in `.spec.ts`

### When MODIFYING existing tests
- [ ] `{page-name}.md` MUST be updated if:
  - Test cases were added/removed
  - Test flow changed (steps)
  - Preconditions or expected results changed
  - Tags or priorities changed
- [ ] Test IDs synchronized between `.md` and `.spec.ts`

### Quick validation
```bash
# Verify .md exists for each test folder
ls ui/tests/{feature}/{feature}.md

# Verify test IDs match
grep -o "@[A-Z]*-E2E-[0-9]*" ui/tests/{feature}/{feature}.spec.ts | sort -u
grep -o "\`[A-Z]*-E2E-[0-9]*\`" ui/tests/{feature}/{feature}.md | sort -u
```

> [!IMPORTANT]
> ❌ An E2E change is NOT considered complete without updating the corresponding `.md` file.

---

## MCP Workflow - CRITICAL

**⚠️ MANDATORY: If Playwright MCP tools are available, ALWAYS use them BEFORE creating tests.**

1. **Navigate** to target page
2. **Take snapshot** to see actual DOM structure
3. **Interact** with forms/elements to verify real flow
4. **Document actual selectors** from snapshots
5. **Only then** write test code

**Why**: Prevents tests based on assumptions. Real exploration = stable tests.

---

## Wait Strategies (CRITICAL)

**⚠️ NEVER use `networkidle` - it causes flaky tests!**

| Strategy | Use Case |
|----------|----------|
| ❌ `networkidle` | NEVER - flaky with polling/WebSockets |
| ⚠️ `load` | Only when absolutely necessary |
| ✅ `expect(element).toBeVisible()` | PREFERRED - wait for specific UI state |
| ✅ `page.waitForURL()` | Wait for navigation |
| ✅ `pageObject.verifyPageLoaded()` | BEST - encapsulated verification |

**GOOD:**
```typescript
await homePage.verifyPageLoaded();
await expect(page).toHaveURL("/dashboard");
await expect(page.getByRole("heading", { name: "Overview" })).toBeVisible();
```

**BAD:**
```typescript
await page.waitForLoadState("networkidle"); // ❌ FLAKY
await page.waitForTimeout(2000);            // ❌ ARBITRARY WAIT
```

---

## Prowler Base Page

```typescript
import { Page, Locator, expect } from "@playwright/test";

export class BasePage {
  constructor(protected page: Page) {}

  async goto(path: string): Promise<void> {
    await this.page.goto(path);
    // Child classes should override verifyPageLoaded() to wait for specific elements
  }

  // Override in child classes to wait for page-specific elements
  async verifyPageLoaded(): Promise<void> {
    await expect(this.page.locator("main")).toBeVisible();
  }

  // Prowler-specific: notification handling
  async waitForNotification(): Promise<Locator> {
    const notification = this.page.locator('[role="status"]');
    await notification.waitFor({ state: "visible" });
    return notification;
  }

  async verifyNotificationMessage(message: string): Promise<void> {
    const notification = await this.waitForNotification();
    await expect(notification).toContainText(message);
  }
}
```

---

## Page Navigation Verification Pattern

**⚠️ URL assertions belong in Page Objects, NOT in tests!**

When verifying redirects or page navigation, create dedicated methods in the target Page Object:

```typescript
// ✅ GOOD - In SignInPage
async verifyOnSignInPage(): Promise<void> {
  await expect(this.page).toHaveURL(/\/sign-in/);
  await expect(this.pageTitle).toBeVisible();
}

// ✅ GOOD - In test
await homePage.goto();  // Try to access protected route
await signInPage.verifyOnSignInPage();  // Verify redirect

// ❌ BAD - Direct assertions in test
await homePage.goto();
await expect(page).toHaveURL(/\/sign-in/);  // Should be in Page Object
await expect(page.getByText("Sign in")).toBeVisible();
```

**Naming convention:** `verifyOn{PageName}Page()` for redirect verification methods.

---

## Prowler-Specific Pages

### Providers Page

```typescript
import { BasePage } from "../base-page";

export class ProvidersPage extends BasePage {
  readonly addButton = this.page.getByRole("button", { name: "Add Provider" });
  readonly providerTable = this.page.getByRole("table");

  async goto(): Promise<void> {
    await super.goto("/providers");
  }

  async addProvider(type: string, alias: string): Promise<void> {
    await this.addButton.click();
    await this.page.getByLabel("Provider Type").selectOption(type);
    await this.page.getByLabel("Alias").fill(alias);
    await this.page.getByRole("button", { name: "Create" }).click();
  }
}
```

### Scans Page

```typescript
export class ScansPage extends BasePage {
  readonly newScanButton = this.page.getByRole("button", { name: "New Scan" });
  readonly scanTable = this.page.getByRole("table");

  async goto(): Promise<void> {
    await super.goto("/scans");
  }

  async startScan(providerAlias: string): Promise<void> {
    await this.newScanButton.click();
    await this.page.getByRole("combobox", { name: "Provider" }).click();
    await this.page.getByRole("option", { name: providerAlias }).click();
    await this.page.getByRole("button", { name: "Start Scan" }).click();
  }
}
```

---

## Test Tags for Prowler

```typescript
test("Provider CRUD operations",
  { tag: ["@critical", "@e2e", "@providers", "@PROV-E2E-001"] },
  async ({ page }) => {
    // ...
  }
);
```

| Category | Tags |
|----------|------|
| Priority | `@critical`, `@high`, `@medium`, `@low` |
| Type | `@e2e`, `@smoke`, `@regression` |
| Feature | `@providers`, `@scans`, `@findings`, `@compliance`, `@signin`, `@signup` |
| Test ID | `@PROV-E2E-001`, `@SCAN-E2E-002` |

---

## Prowler Test Documentation Template

**Keep under 60 lines. Focus on flow, preconditions, expected results only.**

```markdown
### E2E Tests: {Feature Name}

**Suite ID:** `{SUITE-ID}`
**Feature:** {Feature description}

---

## Test Case: `{TEST-ID}` - {Test case title}

**Priority:** `{critical|high|medium|low}`
**Tags:** @e2e, @{feature-name}

**Preconditions:**
- {Prerequisites}

### Flow Steps:
1. {Step}
2. {Step}

### Expected Result:
- {Outcome}

### Key Verification Points:
- {Assertion}
```

---

## Commands

```bash
cd ui && pnpm run test:e2e                              # All tests
cd ui && pnpm run test:e2e tests/providers/             # Specific folder
cd ui && pnpm run test:e2e --grep "provider"            # By pattern
cd ui && pnpm run test:e2e:ui                           # With UI
cd ui && pnpm run test:e2e:debug                        # Debug mode
cd ui && pnpm run test:e2e:headed                       # See browser
cd ui && pnpm run test:e2e:report                       # Generate report
```

## Resources

- **Documentation**: See [references/](references/) for links to local developer guide

© prowler-cloud · Apache-2.0 · prowler-cloud/prowler

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

Все скиллы по теме «Тесты и QA» →
recording-browser-flow-as-test spencerpauly Скилл recording-browser-flow-as-test записывает действия в браузере через MCP и превращает их в E2E-тест Playwright с надёжными селекторами accessibility tree. CX Codex +1 451установок e2e-test-builder patricio0312rev Скилл e2e-test-builder генерирует сквозные браузерные тесты для Playwright и Cypress с паттерном Page Object, фикстурами и селекторами по ролям. CX Codex +1 273установок playwright-test open-metadata Скилл playwright-test создаёт стабильные E2E-тесты Playwright по стандартам OpenMetadata с валидацией через API, проверкой прав ролей и запуском линтера. CX Codex +1 ★ 15 831звёзд репо momentic-test momentic-ai Скилл momentic-test для Claude Code создаёт и запускает тесты Momentic для браузера, Android и iOS. Он работает с YAML-файлами тестов и модулей. CX Codex +1 68 600установок e2e-testing platform-team Скилл e2e-testing задаёт шаблоны E2E-тестирования на Playwright для веб-приложений на React и Python. Помогает строить надёжные сквозные сценарии и Page Objects. CX Codex +1 1 600установок playwright-cursor-rules Mindrally Скилл учит агента писать end-to-end тесты на Playwright по стандартам QA-автоматизации: стабильные локаторы, изоляция, параллельный запуск. CX Codex +1 738установок

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

Весь набор →
django-drf Скилл django-drf для быстрого создания REST API на Django с ViewSet'ами, сериализаторами и фильтрами по стандартам Prowler. Подключайте, когда пишете endpoints с RLS, JSON:API и OpenAPI документацией. CX Codex +1 484установок prowler-ci Скилл prowler-ci помогает разбираться с падениями проверок GitHub Actions и правилами пулл-реквестов в репозитории Prowler. CX Codex +1 ★ 15 302звёзд репо prowler-changelog Скилл prowler-changelog ведёт записи в CHANGELOG для компонентов Prowler через фрагменты changelog.d. Пригодится при подготовке PR и изменениях в UI, API, SDK или MCP Server. CX Codex +1 ★ 15 302звёзд репо prowler-docs Скилл prowler-docs для Claude Code задаёт стиль и структуру документации Prowler: голос бренда, Title Case, MDX-блоки и правила для терминов. Используется при написании гайдов и release notes. CX Codex +1 ★ 15 302звёзд репо prowler-compliance-review Скилл prowler-compliance-review проверяет пулреквесты с фреймворками комплаенса в репозитории Prowler. Находит синтаксические ошибки JSON, дубликаты ID и пропущенные проверки. CX Codex +1 ★ 15 302звёзд репо jsonapi Проверяет API-эндпоинты и ответы на соответствие JSON:API v1.1. Нужен при создании, изменении и ревью API. CX Codex +1 ★ 15 302звёзд репо prowler-compliance Скилл prowler-compliance ведёт compliance-фреймворки Prowler от создания JSON до синхронизации с каталогом-первоисточником и ревизии привязки чеков к требованиям. CX Codex +1 ★ 15 302звёзд репо prowler-sdk-check Скилл prowler-sdk-check для Claude Code, Codex, Cursor и других IDE помогает писать проверки безопасности Prowler по архитектурным паттернам SDK. CX Codex +1 ★ 15 302звёзд репо

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

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