Test Automator

Test Automator

Expert in creating and maintaining automated tests for various frameworks and languages.

When This Skill Activates

Activates when you:

• Ask to write tests
• Mention test automation
• Request test coverage improvement
• Need to set up testing framework

Testing Pyramid

        /\
       /E2E\      - Few, expensive, slow
      /------\
     /  Integration \ - Moderate number
    /--------------\
   /     Unit Tests  \ - Many, cheap, fast
  /------------------\

Unit Testing

Principles

1. Test behavior, not implementation 2. One assertion per test (generally) 3. Arrange-Act-Assert pattern 4. Descriptive test names

Example (Jest)

describe('UserService', () => {
  describe('createUser', () => {
    it('should create a user with valid data', async () => {
      // Arrange
      const userData = {
        name: 'John Doe',
        email: 'john@example.com'
      };

      // Act
      const user = await userService.create(userData);

      // Assert
      expect(user.id).toBeDefined();
      expect(user.email).toBe(userData.email);
    });

    it('should throw error for invalid email', async () => {
      // Arrange
      const userData = { email: 'invalid' };

      // Act & Assert
      await expect(userService.create(userData))
        .rejects.toThrow('Invalid email');
    });
  });
});

Integration Testing

Principles

1. Test component interactions 2. Use test doubles for external services 3. Clean up test data 4. Run in isolation

Example (Supertest)

describe('POST /api/users', () => {
  it('should create a user', async () => {
    const response = await request(app)
      .post('/api/users')
      .send({
        name: 'John Doe',
        email: 'john@example.com'
      })
      .expect(201)
      .expect((res) => {
        expect(res.body.id).toBeDefined();
        expect(res.body.email).toBe('john@example.com');
      });
  });
});

E2E Testing

Principles

1. Test critical user flows 2. Use realistic test data 3. Handle async operations properly 4. Clean up after tests

Example (Playwright)

test('user can login', async ({ page }) => {
  await page.goto('/login');
  await page.fill('[name="email"]', 'user@example.com');
  await page.fill('[name="password"]', 'password123');
  await page.click('button[type="submit"]');

  await expect(page).toHaveURL('/dashboard');
  await expect(page.locator('h1')).toContainText('Welcome');
});

Test Coverage

Coverage Goals

Coverage Reports

# Jest
npm test -- --coverage

# Python (pytest-cov)
pytest --cov=src --cov-report=html

# Go
go test -coverprofile=coverage.out
go tool cover -html=coverage.out

Testing Best Practices

DO's

• Write tests before fixing bugs (TDD)
• Test edge cases
• Keep tests independent
• Use descriptive test names
• Mock external dependencies
• Clean up test data

DON'Ts

• Don't test implementation details
• Don't write brittle tests
• Don't skip tests without a reason
• Don't commit commented-out tests
• Don't test third-party libraries

Test Naming Conventions

// Good: Describes what is being tested
it('should reject invalid email addresses')

// Good: Describes the scenario and outcome
it('returns 401 when user provides invalid credentials')

// Bad: Vague
it('works correctly')

Common Testing Frameworks

Scripts

Generate test boilerplate:

python scripts/generate_test.py <filename>

Check test coverage:

python scripts/coverage_report.py

References

• references/best-practices.md - Testing best practices
• references/examples/ - Framework-specific examples
• references/mocking.md - Mocking guidelines

Test Automator

A Claude Code skill for creating and maintaining automated tests.

Installation

This skill is part of the agent-playbook collection.

Usage

You: Write tests for this function
You: Create test cases
You: Improve test coverage

Testing Frameworks

Scripts

Generate test boilerplate:

python scripts/generate_test.py <filename>

Check test coverage:

python scripts/coverage_report.py

Resources

• Testing Best Practices
• Test Driven Development

Test Automation Best Practices

• Keep tests deterministic
• Avoid test order dependencies
• Prefer explicit fixtures
• Run tests in CI on every change

Examples

This directory contains small, focused test automation examples.

Unit Test Example

from my_module import add

def test_add():
    assert add(2, 3) == 5

Mocking Guide

• Mock external services
• Avoid mocking internal logic
• Use realistic data shapes