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

snapshot-test-refactorer — скилл для Claude Code: как установить

Скилл snapshot-test-refactorer для Claude Code превращает громоздкие снимки разметки в точечные проверки поведения и данных. Заменяет хрупкие проверки, падающие при малейшем изменении пробелов или вёрстки.

MIT 228 установок ★ 64 обновлён 2026-01-12

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

Что делает snapshot-test-refactorer

Скилл помогает разобрать тяжёлые тесты со снимками DOM и ответов API на понятные ассерты. Вместо сплошного toMatchSnapshot() для всего компонента агент переводит проверки на селекторы библиотеки тестирования вроде getByRole или getByText. Это разделяет проверку интерфейса и логики приложения.

В инструкциях описаны приёмы для нестабильных данных: выделение toMatchInlineSnapshot для обозримого JSON, сериализаторы для удаления временных меток вроде createdAt, а также вынос проверки внешнего вида в скриншотные тесты Playwright.

Тест, завязанный на снимок всего DOM-дерева, ломается от любого изменения разметки без реального бага в логике.

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

  • Заменить монолитный снимок компонента точечными проверками поведения
  • Вырезать нестабильные поля вроде временных меток через сериализатор
  • Сократить снимки ответов API до критических полей и схемы
  • Перевести тесты внешнего вида на скриншоты Playwright

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

  • Перепиши тест в UserProfile.test.tsx: замени снимок разметки на проверку видимости имени и кнопок
  • Настрой сериализатор для toMatchInlineSnapshot, чтобы тест игнорировал createdAt и updatedAt
  • Разбей тест со снимком ответа API на проверку схемы через toMatchObject

Как установить snapshot-test-refactorer

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill snapshot-test-refactorer -a claude-code

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

~/.claude/skills/snapshot-test-refactorer/SKILL.md

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

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

Вопросы о snapshot-test-refactorer

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

Выполните команду npx skills add patricio0312rev/skills --skill snapshot-test-refactorer -a claude-code.

Что делает snapshot-test-refactorer?

Он помогает агенту находить хрупкие снепшот-тесты и переписывать их на проверки поведения, встроенные инлайн-снимки и контроль структуры данных.

В каких случаях скилл рекомендует оставить снепшоты?

Снимки остаются оправданными для стабильных контрактов: текстов ошибок, экспортируемого JSON и наборов ключей API, которые редко меняются.

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

SKILL.md · MIT
---
name: snapshot-test-refactorer
description: Refactors brittle snapshot tests into resilient, focused assertions. Provides strategies for reducing snapshot size, extracting meaningful assertions, and maintaining snapshots. Use for "snapshot testing", "snapshot refactoring", "brittle tests", or "assertion improvement".
---

# Snapshot Test Refactorer

Replace brittle snapshots with meaningful, maintainable assertions.

## Problems with Snapshot Tests

```typescript
// ❌ Bad: Full component snapshot
test("renders UserProfile", () => {
  const { container } = render(<UserProfile user={mockUser} />);
  expect(container).toMatchSnapshot();
});

// Problems:
// 1. Fails on any change (even whitespace)
// 2. No clear intent
// 3. Hard to review diffs
// 4. Doesn't test behavior
// 5. Implementation coupled
```

## Refactoring Strategy

```typescript
// ✅ Good: Specific assertions
test("renders UserProfile with user data", () => {
  render(<UserProfile user={mockUser} />);

  // Test what matters
  expect(screen.getByText(mockUser.name)).toBeInTheDocument();
  expect(screen.getByText(mockUser.email)).toBeInTheDocument();
  expect(screen.getByRole("img")).toHaveAttribute("src", mockUser.avatar);
});

test("shows edit button for own profile", () => {
  render(<UserProfile user={mockUser} isOwnProfile={true} />);

  expect(
    screen.getByRole("button", { name: "Edit Profile" })
  ).toBeInTheDocument();
});

test("hides edit button for other profiles", () => {
  render(<UserProfile user={mockUser} isOwnProfile={false} />);

  expect(
    screen.queryByRole("button", { name: "Edit Profile" })
  ).not.toBeInTheDocument();
});
```

## Inline Snapshots for Data

```typescript
// ❌ Bad: External snapshot file
test("formats user data", () => {
  const result = formatUser(mockUser);
  expect(result).toMatchSnapshot();
});

// ✅ Good: Inline snapshot (visible in code)
test("formats user data", () => {
  const result = formatUser(mockUser);
  expect(result).toMatchInlineSnapshot(`
    {
      "displayName": "John Doe",
      "initials": "JD",
      "memberSince": "2020-01-01",
    }
  `);
});
```

## Partial Snapshots

```typescript
// ❌ Bad: Snapshot entire API response
test("fetches user", async () => {
  const response = await api.getUser("123");
  expect(response).toMatchSnapshot();
});

// ✅ Good: Test important parts
test("fetches user with required fields", async () => {
  const response = await api.getUser("123");

  expect(response).toMatchObject({
    id: "123",
    email: expect.stringContaining("@"),
    role: expect.any(String),
  });

  // Snapshot only stable, important data
  expect({
    name: response.name,
    role: response.role,
  }).toMatchInlineSnapshot(`
    {
      "name": "John Doe",
      "role": "USER",
    }
  `);
});
```

## Serializer for Unstable Data

```typescript
// Remove unstable fields before snapshot
expect.addSnapshotSerializer({
  test: (val) => val && typeof val === "object" && "createdAt" in val,
  serialize: (val) => {
    const { createdAt, updatedAt, ...rest } = val;
    return JSON.stringify(rest, null, 2);
  },
});

// Now timestamps won't break tests
test("creates user", async () => {
  const user = await createUser({ name: "Test" });

  expect(user).toMatchInlineSnapshot(`
    {
      "id": "123",
      "name": "Test",
      "role": "USER"
    }
  `);
  // createdAt automatically removed
});
```

## Snapshot Trimming Strategy

```typescript
// Before: 500 line snapshot
expect(component).toMatchSnapshot();

// After: Focus on critical parts
const criticalElements = {
  header: screen.getByRole("banner").textContent,
  mainAction: screen.getByRole("button", { name: /submit/i }).textContent,
  errorMessage: screen.queryByRole("alert")?.textContent,
};

expect(criticalElements).toMatchInlineSnapshot(`
  {
    "errorMessage": null,
    "header": "Welcome",
    "mainAction": "Submit",
  }
`);
```

## Visual Regression Alternative

```typescript
// Instead of DOM snapshot, use visual regression
test("Profile component appearance", async ({ page }) => {
  await page.goto("/profile");

  // Visual snapshot (Playwright)
  await expect(page).toHaveScreenshot("profile.png", {
    maxDiffPixels: 100,
  });
});
```

## When Snapshots Are Acceptable

```typescript
// ✅ OK: Error messages (rarely change)
test("validates email format", () => {
  const errors = validateEmail("invalid");
  expect(errors).toMatchInlineSnapshot(`
    [
      "Email must contain @",
      "Email must contain domain",
    ]
  `);
});

// ✅ OK: API response structure (stable contract)
test("user API response structure", async () => {
  const response = await api.getUser("123");

  expect(Object.keys(response).sort()).toMatchInlineSnapshot(`
    [
      "createdAt",
      "email",
      "id",
      "name",
      "role",
      "updatedAt",
    ]
  `);
});

// ✅ OK: Serialized data format
test("exports user to JSON", () => {
  const json = exportUserToJSON(user);
  expect(json).toMatchInlineSnapshot(`
    {
      "email": "[email protected]",
      "name": "John Doe",
      "version": "1.0",
    }
  `);
});
```

## Refactoring Process

```markdown
# Snapshot Refactoring Checklist

For each snapshot test, ask:

1. **What is being tested?**

   - If unclear → Replace with specific assertions

2. **Does it test behavior or implementation?**

   - Implementation → Refactor to behavior test

3. **How often does this change?**

   - Frequently → Use targeted assertions
   - Rarely → Snapshot OK

4. **Can I describe what should pass/fail?**

   - No → Snapshot is too broad

5. **Would a visual test be better?**
   - UI appearance → Use screenshot testing

## Refactoring Steps

1. Run snapshot test, let it fail
2. Look at the diff
3. Extract what actually matters
4. Write assertion for that specific thing
5. Delete snapshot
6. Repeat for next snapshot
```

## Example Refactoring

```typescript
// ❌ Before: Brittle 200-line snapshot
test("renders dashboard", () => {
  const { container } = render(<Dashboard user={user} />);
  expect(container).toMatchSnapshot();
});

// ✅ After: Multiple focused tests
describe("Dashboard", () => {
  test("displays welcome message with user name", () => {
    render(<Dashboard user={user} />);
    expect(screen.getByText(`Welcome back, ${user.name}!`)).toBeInTheDocument();
  });

  test("shows user stats", () => {
    render(<Dashboard user={user} stats={mockStats} />);

    expect(screen.getByText(`${mockStats.orders} orders`)).toBeInTheDocument();
    expect(screen.getByText(`$${mockStats.revenue}`)).toBeInTheDocument();
  });

  test("displays quick actions", () => {
    render(<Dashboard user={user} />);

    expect(
      screen.getByRole("button", { name: "New Order" })
    ).toBeInTheDocument();
    expect(
      screen.getByRole("button", { name: "View Reports" })
    ).toBeInTheDocument();
  });

  test("shows empty state when no recent activity", () => {
    render(<Dashboard user={user} recentActivity={[]} />);

    expect(screen.getByText("No recent activity")).toBeInTheDocument();
  });
});
```

## Automated Conversion Script

```typescript
// scripts/convert-snapshots.ts
import * as fs from "fs";
import * as path from "path";

function convertSnapshotToAssertions(testFile: string): string {
  let content = fs.readFileSync(testFile, "utf-8");

  // Replace toMatchSnapshot() with specific assertions
  content = content.replace(
    /expect\((.+?)\)\.toMatchSnapshot\(\)/g,
    (match, element) => {
      return `// TODO: Replace with specific assertions
// expect(${element}).to... `;
    }
  );

  return content;
}
```

## Maintenance Strategy

```markdown
# Snapshot Maintenance Guidelines

## When to Update Snapshots

✅ **Update when:**

- Intentional design change
- New feature added
- Bug fix that changes output
- Refactoring that changes structure

❌ **Don't update when:**

- "Jest said to update"
- Test is failing
- Don't understand the change
- Too lazy to investigate

## Review Process

1. Run `jest -u` to update
2. Review EVERY changed snapshot
3. Verify change is intentional
4. If unsure, ask for review
5. Consider if assertion would be better

## Reduce Snapshot Size

- Use `.toMatchObject()` for partial matches
- Extract only relevant data
- Use serializers to remove noise
- Consider inline snapshots
```

## Best Practices

1. **Inline snapshots**: More visible and reviewable
2. **Small snapshots**: Snapshot only what matters
3. **Stable data**: Remove timestamps, IDs
4. **Clear intent**: Test name explains what's captured
5. **Visual regression**: For UI appearance
6. **Regular review**: Quarterly snapshot audit
7. **Specific assertions**: Prefer over snapshots

## Output Checklist

- [ ] Brittle snapshots identified
- [ ] Refactored to specific assertions
- [ ] Inline snapshots where appropriate
- [ ] Unstable data removed (serializers)
- [ ] Partial snapshots for data structures
- [ ] Visual regression for UI
- [ ] Maintenance guidelines documented
- [ ] Review process established

© patricio0312rev · MIT · patricio0312rev/skills

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

Все скиллы по теме «Тесты и QA» →
test-audit mblode Скилл test-audit для Claude Code, Cursor, Codex и других агентов, который вырезает малоценные тесты из сьюта до заданной цели, сохраняя покрытие. Запускается как точечный аудит папки или кампания на весь репозиторий с числовым таргетом. CX Codex +1 283установок test-automation-expert curiositech Скилл test-automation-expert для Claude Code помогает выстроить стратегию тестирования, определить покрытие, выбрать фреймворк и отладить флаки-тесты. CX Codex +1 212установок qe-test-generation proffesor-for-testing Скилл qe-test-generation для Claude Code создаёт тесты для нового и изменённого кода, включая проверки инвариантов и контрактов. Помогает находить пробелы в покрытии и переносить тесты между фреймворками. CX Codex +1 142установок qe-test-execution proffesor-for-testing Скилл qe-test-execution для запуска тестов в Jest, Vitest и Playwright с параллелизацией через aqe, умным отбором по diff и автоповтором упавших проверок. CX Codex +1 122установок test-detect davila7 Скилл test-detect определяет тестовый фреймворк в проекте и запускает подходящую проверку. Он также находит тесты для файла и создаёт базовые тесты. CX Codex +1 56установок test-gen alirezarezvani Команда test-gen пишет тесты к готовому коду: юнит-тесты функций, компонентные, интеграционные, e2e и тесты API. Фреймворк и порог покрытия задаются флагами. CX Codex +1 ★ 788звёзд репо

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

Весь набор →
rag-pipeline-builder Скилл rag-pipeline-builder проектирует RAG-пайплайн для ассистента по документам: чанкинг, метаданные, гибридный поиск, реранкинг и план оценки качества. CX Codex +1 251установок preview-environments-builder Скилл preview-environments-builder генерирует пайплайны временных окружений для каждого пулл-реквеста с автоматическим развёртыванием, уникальным адресом и удалением ресурсов после закрытия PR. CX Codex +1 250установок load-test-scenario-builder Скилл load-test-scenario-builder проектирует сценарии нагрузочного тестирования, готовит k6-скрипты, профили трафика и критерии успеха для проверки пропускной способности. CX Codex +1 236установок graphql-schema-designer Скилл graphql-schema-designer для Claude Code помогает спроектировать GraphQL API с типами, запросами, мутациями, подписками и резолверами. Включается по запросам о схеме, настройке GraphQL или Apollo Server. CX Codex +1 230установок test-data-factory-builder Скилл test-data-factory-builder для Claude Code создаёт фабрики и билдеры тестовых данных. Подключается к запросам на генерацию фикстур, тестовых сущностей и связанных записей. CX Codex +1 229установок terraform-module-builder Скилл terraform-module-builder помогает проектировать переиспользуемые модули Terraform с валидацией входных переменных, outputs и структурой каталогов. CX Codex +1 229установок performance-budget-setter Скилл performance-budget-setter для Claude Code помогает задать бюджеты для бандлов, API, запросов к базе и времени рендера. Бюджеты фиксируют для проверки метрик в CI и мониторинге. CX Codex +1 228установок doc-to-vector-dataset-generator Скилл doc-to-vector-dataset-generator для Claude Code превращает документы в очищенные JSONL-чанки для embeddings и vector search. Готовит данные для поиска по документам. CX Codex +1 227установок

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

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