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

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

Скилл mocking-assistant помогает создавать моки для API, сервисов и UI через MSW и Vitest: от фикстур данных до перехвата системного времени в тестах.

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

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

Что делает mocking-assistant

Скилл даёт готовые шаблоны мокирования на TypeScript для тестов в Node и браузере. Внутри собраны паттерны для MSW: настройка setupServer, обработчики http.get и http.post, задержки ответа и симуляция сетевых ошибок 404 или 500.

Кроме сетевых запросов шаблон показывает, как изолировать бизнес-логику без внешних зависимостей. Здесь есть структура фикстур, реализация мок-классов вроде MockPaymentService, подмена функций через vi.spyOn, переопределение системных часов vi.setSystemTime и изоляция модулей в vi.mock.

Шаблоны рассчитаны на связку Vitest и MSW, поэтому проект должен использовать именно их или аналогичный синтаксис.

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

  • настроить эмуляцию REST API через MSW для интеграционных тестов
  • создать изолированные фикстуры пользователей и товаров
  • замокировать системное время для проверки логики с датами
  • подменить внешние сервисы мок-классами без реальных вызовов

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

  • Настрой сервер MSW для тестирования компонента UserProfile с обработкой ошибки 500
  • Создай фикстуру каталога товаров и подключи её в обработчик http.get
  • Напиши тест с подменой системного времени через Vitest

Как установить mocking-assistant

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill mocking-assistant -a claude-code

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

~/.claude/skills/mocking-assistant/SKILL.md

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

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

Вопросы о mocking-assistant

Как установить mocking-assistant в Claude Code?

Выполните команду npx skills add patricio0312rev/skills --skill mocking-assistant -a claude-code. Файл скилла запишется в каталог ~/.claude/skills/mocking-assistant/SKILL.md.

Что делает скилл mocking-assistant?

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

Какие библиотеки требуются для этих моков?

Шаблоны используют msw версии с методом HttpResponse и тестовый фреймворк vitest.

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

SKILL.md · MIT
---
name: mocking-assistant
description: Creates stable mocks for APIs, services, and UI components using MSW (Mock Service Worker), fixture conventions, and example patterns. Use for "API mocking", "MSW", "test mocks", or "service mocking".
---

# Mocking Assistant

Create reliable mocks for APIs and services in tests.

## MSW API Mocking

```typescript
// mocks/handlers.ts
import { http, HttpResponse } from "msw";

export const handlers = [
  // GET endpoint
  http.get("/api/users/:id", ({ params }) => {
    const { id } = params;

    return HttpResponse.json({
      id,
      name: "John Doe",
      email: "[email protected]",
    });
  }),

  // POST endpoint
  http.post("/api/users", async ({ request }) => {
    const body = await request.json();

    return HttpResponse.json(
      {
        id: Math.random().toString(),
        ...body,
        createdAt: new Date().toISOString(),
      },
      { status: 201 }
    );
  }),

  // Error response
  http.get("/api/products/:id", ({ params }) => {
    const { id } = params;

    if (id === "404") {
      return HttpResponse.json({ error: "Product not found" }, { status: 404 });
    }

    return HttpResponse.json({
      id,
      name: "MacBook Pro",
      price: 2499.99,
    });
  }),

  // Delayed response
  http.get("/api/slow-endpoint", async () => {
    await delay(2000);
    return HttpResponse.json({ data: "Slow response" });
  }),
];
```

## MSW Setup

```typescript
// mocks/server.ts
import { setupServer } from "msw/node";
import { handlers } from "./handlers";

export const server = setupServer(...handlers);

// tests/setup.ts
import { beforeAll, afterEach, afterAll } from "vitest";
import { server } from "../mocks/server";

beforeAll(() => server.listen({ onUnhandledRequest: "error" }));
afterEach(() => server.resetHandlers());
afterAll(() => server.close());
```

## Fixture Conventions

```typescript
// mocks/fixtures/users.ts
export const userFixtures = {
  admin: {
    id: "1",
    email: "[email protected]",
    name: "Admin User",
    role: "ADMIN",
  },
  customer: {
    id: "2",
    email: "[email protected]",
    name: "Customer User",
    role: "USER",
  },
  guest: {
    id: "3",
    email: "[email protected]",
    name: "Guest User",
    role: "GUEST",
  },
};

// mocks/fixtures/products.ts
export const productFixtures = {
  laptop: {
    id: "100",
    name: "MacBook Pro",
    price: 2499.99,
    stock: 10,
    category: "Electronics",
  },
  phone: {
    id: "101",
    name: "iPhone 15",
    price: 999.99,
    stock: 50,
    category: "Electronics",
  },
  outOfStock: {
    id: "102",
    name: "Sold Out Item",
    price: 499.99,
    stock: 0,
    category: "Electronics",
  },
};

// Usage in handlers
http.get("/api/users/:id", ({ params }) => {
  const user = Object.values(userFixtures).find((u) => u.id === params.id);

  if (!user) {
    return HttpResponse.json({ error: "User not found" }, { status: 404 });
  }

  return HttpResponse.json(user);
});
```

## Test-Specific Mocks

```typescript
// tests/components/UserProfile.test.tsx
import { server } from "../mocks/server";
import { http, HttpResponse } from "msw";

test("should display user profile", async () => {
  // Override handler for this test
  server.use(
    http.get("/api/users/123", () => {
      return HttpResponse.json({
        id: "123",
        name: "Test User",
        email: "[email protected]",
      });
    })
  );

  render(<UserProfile userId="123" />);

  await waitFor(() => {
    expect(screen.getByText("Test User")).toBeInTheDocument();
  });
});

test("should handle API error", async () => {
  // Mock error response
  server.use(
    http.get("/api/users/123", () => {
      return HttpResponse.json({ error: "Server error" }, { status: 500 });
    })
  );

  render(<UserProfile userId="123" />);

  await waitFor(() => {
    expect(screen.getByText("Failed to load user")).toBeInTheDocument();
  });
});
```

## Service Mocking

```typescript
// src/services/paymentService.ts
export interface PaymentService {
  processPayment(amount: number, cardToken: string): Promise<PaymentResult>;
  refund(transactionId: string): Promise<void>;
}

// mocks/services/mockPaymentService.ts
export class MockPaymentService implements PaymentService {
  async processPayment(
    amount: number,
    cardToken: string
  ): Promise<PaymentResult> {
    // Simulate successful payment
    if (cardToken.startsWith("tok_success")) {
      return {
        transactionId: "txn_" + Math.random().toString(36),
        status: "success",
        amount,
      };
    }

    // Simulate failed payment
    if (cardToken.startsWith("tok_fail")) {
      throw new Error("Payment failed");
    }

    // Simulate slow payment
    await new Promise((resolve) => setTimeout(resolve, 2000));
    return {
      transactionId: "txn_" + Math.random().toString(36),
      status: "success",
      amount,
    };
  }

  async refund(transactionId: string): Promise<void> {
    // Mock refund
    console.log(`Refunding transaction: ${transactionId}`);
  }
}

// tests/checkout.test.ts
const mockPaymentService = new MockPaymentService();

test("should process payment successfully", async () => {
  const result = await mockPaymentService.processPayment(
    100,
    "tok_success_123"
  );

  expect(result.status).toBe("success");
  expect(result.transactionId).toBeDefined();
});
```

## Function Mocking with Vitest

```typescript
// src/utils/analytics.ts
export const trackEvent = (event: string, data: any) => {
  // Send to analytics service
};

// tests/component.test.ts
import { vi } from "vitest";
import * as analytics from "@/utils/analytics";

test("should track button click", () => {
  // Mock function
  const trackEventSpy = vi.spyOn(analytics, "trackEvent");

  render(<Button onClick={handleClick} />);
  fireEvent.click(screen.getByRole("button"));

  expect(trackEventSpy).toHaveBeenCalledWith("button_click", {
    buttonId: "submit",
  });
});
```

## Date/Time Mocking

```typescript
// tests/date-sensitive.test.ts
import { vi } from "vitest";

test("should show correct greeting based on time", () => {
  // Mock date to morning
  vi.setSystemTime(new Date("2024-01-01 09:00:00"));

  render(<Greeting />);
  expect(screen.getByText("Good morning!")).toBeInTheDocument();

  // Mock date to evening
  vi.setSystemTime(new Date("2024-01-01 19:00:00"));

  render(<Greeting />);
  expect(screen.getByText("Good evening!")).toBeInTheDocument();

  // Restore real time
  vi.useRealTimers();
});
```

## Module Mocking

```typescript
// src/lib/database.ts
export const db = {
  user: {
    findById: (id: string) => {
      // Real database query
    },
  },
};

// tests/mocks/database.ts
export const mockDb = {
  user: {
    findById: vi.fn((id: string) => ({
      id,
      name: "Mock User",
      email: "[email protected]",
    })),
  },
};

// tests/userService.test.ts
vi.mock("@/lib/database", () => ({
  db: mockDb,
}));

test("should fetch user from database", async () => {
  const user = await userService.getUser("123");

  expect(mockDb.user.findById).toHaveBeenCalledWith("123");
  expect(user.name).toBe("Mock User");
});
```

## GraphQL Mocking

```typescript
// mocks/graphql-handlers.ts
import { graphql, HttpResponse } from "msw";

export const graphqlHandlers = [
  graphql.query("GetUser", ({ variables }) => {
    return HttpResponse.json({
      data: {
        user: {
          id: variables.id,
          name: "John Doe",
          email: "[email protected]",
        },
      },
    });
  }),

  graphql.mutation("CreateUser", ({ variables }) => {
    return HttpResponse.json({
      data: {
        createUser: {
          id: Math.random().toString(),
          ...variables.input,
        },
      },
    });
  }),
];
```

## Best Practices

1. **Use MSW for HTTP**: More realistic than mocking fetch
2. **Centralize fixtures**: Single source of truth
3. **Test-specific overrides**: Override defaults per test
4. **Mock at boundaries**: Services, APIs, not internals
5. **Realistic data**: Fixtures should match production
6. **Error scenarios**: Test failure cases
7. **Timing control**: Mock delays for loading states

## Output Checklist

- [ ] MSW handlers created
- [ ] Fixture conventions established
- [ ] Common fixtures defined
- [ ] Test-specific mock overrides
- [ ] Service mocks implemented
- [ ] Function spies used appropriately
- [ ] Date/time mocking when needed
- [ ] Error scenarios mocked
- [ ] GraphQL mocks (if applicable)
- [ ] Documentation for mock usage

© patricio0312rev · MIT · patricio0312rev/skills

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

Все скиллы по теме «Тесты и QA» →
bun-test-mocking secondsky Скилл bun-test-mocking помогает писать моки и шпионы во встроенном раннере bun:test. Пригодится при изоляции сетевых вызовов и подмене модулей. CX Codex +1 427установок vitest-testing secondsky Скилл vitest-testing для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который добавляет знания о Vitest — фреймворке для юнит- и интеграционных тестов на TypeScript/JavaScript. CX Codex +1 1 300установок test-doubles-mocking dev-toolings Скилл test-doubles-mocking помогает создавать тестовые двойники с PHPUnit для изолированного тестирования Symfony-приложений. CX Codex +1 ★ 234звёзд репо Testing taste f Промпт Testing taste для ChatGPT и Claude.ai задаёт правила генерации тестов на TypeScript. Включает проверки на Vitest и Playwright. GP ChatGPT ★ 178 201звёзд репо vitest-unit-testing-cursorrules-prompt-file PatrickJS Правило vitest-unit-testing-cursorrules-prompt-file для Cursor настраивает ИИ писать юнит-тесты на Vitest с TypeScript или JavaScript. Оно запускается на файлах проекта, мокает зависимости до импортов и группирует тесты в describe-блоки. CX Codex +1 ★ 41 178звёзд репо react-testing affaan-m Скилл для написания тестов React-компонентов, хуков и страниц: React Testing Library, Vitest или Jest, MSW для моков сети и проверки доступности через axe. CX Codex +1 6 700установок

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

Весь набор →
embedding-pipeline-builder Скилл embedding-pipeline-builder для Claude Code собирает пайплайны эмбеддингов документов: загрузку, очистку, чанкинг, индексацию и настройку поиска. Поддерживает RAG и семантическую индексацию. CX Codex +1 259установок llm-debugger Скилл llm-debugger находит причины сбоев в ответах нейросетей, правит системные промпты и генерирует регрессионные тесты для фиксации ошибок. CX Codex +1 259установок tool-function-schema-designer Скилл tool-function-schema-designer помогает описать инструменты для LLM так, чтобы модель вызывала их с валидными аргументами: JSON-схема, типы, проверка через zod и примеры вызовов. CX Codex +1 258установок test-reporting-triage-skill Скилл test-reporting-triage-skill для Claude Code группирует ошибки тестов по категориям, предлагает ответственные команды и варианты исправления. Разбирает результаты прогона тестов. CX Codex +1 257установок service-layer-extractor Скилл service-layer-extractor выносит бизнес-логику из контроллеров в сервисы и репозитории. Помогает навести порядок в раздутых роутах и подготовить код к юнит-тестам. CX Codex +1 255установок 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установок

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

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