Skip to content
Skills Library
Programming · Testing

integration-test-engineer

/integration-test-engineer

Designs and writes integration tests that exercise real boundaries such as database queries, HTTP clients and message handlers, including failure and timeout behaviour. Use when unit tests with mocks cannot prove the integration works.

Licence
MIT
Last repository change
02.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 02.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Designs and writes integration tests that exercise real boundaries such as database queries, HTTP clients and message handlers, including failure and timeout behaviour. Use when unit tests with mocks cannot prove the integration works.

Original author description

Designs and writes integration tests that exercise real boundaries such as database queries, HTTP clients and message handlers, including failure and timeout behaviour. Use when unit tests with mocks cannot prove the integration works.

How it works

  1. Purpose
  2. When to invoke
  3. Required input
  4. Execution instructions
  5. Expected output
  6. Validation checklist
  7. Example usage
  8. Sample prompts
  9. Common mistakes
  10. Related skills
Original SKILL.md headings · 100 lines, 562 words
SKILL.md preview
---
name: integration-test-engineer
description: "Designs and writes integration tests that exercise real boundaries such as database queries, HTTP clients and message handlers, including failure and timeout behaviour. Use when unit tests with mocks cannot prove the integration works."
license: MIT
metadata:
  activity: testing
  difficulty: intermediate
  frameworks: "JUnit 5, pytest, Vitest"
  version: "1.0"
---

# Integration Test Engineer

## Purpose

Prove that components work together against real or realistic dependencies. Catch what mocks hide: wrong SQL, serialisation mismatches, status code handling and timeouts.

## When to invoke

- Code talks to a database, HTTP service, queue or filesystem.
- A bug escaped even though unit tests with mocks were green.
- You are adding or changing a public API or persistence mapping.

## Required input

- The boundary under test and how to run a realistic dependency (in-memory database, local container, stub server).
- Existing integration test conventions and tooling.
- Scenario matrix rows for dependency failure and data variations.

If a required input is missing, ask for it. Do not guess.

## Execution instructions

1. Identify the seam: the smallest unit that includes the real boundary code (repository, client, controller).
2. Choose a realistic dependency: real database engine or embedded equivalent, local stub server that speaks real HTTP, test container.
3. Create isolated, repeatable setup and teardown. Each test owns its data.
4. Write the happy path through the real boundary, asserting stored or returned data exactly.
5. Add failure paths: not found, constraint violation, 4xx and 5xx responses, malformed body, timeout, connection refused.
6. Verify side effects: rows written, messages emitted, transaction rollback on failure.
7. Keep them fast and deterministic. Tag them so they can run separately from unit tests.
8. Run them and report results. State what remains untested at the boundary.

## Expected output

- Integration test files with setup, teardown and tagging.
- Instructions to run them locally and in CI.
- List of dependency behaviours covered and not covered.

## Validation checklist

- [ ] The real boundary code runs, not a mock of it.
- [ ] Tests are isolated and can run in any order.
- [ ] Failure and timeout paths are covered, not only success.
- [ ] No dependency on shared external environments.
- [ ] Run time is acceptable and documented.

## Example usage

Input:

> `PriceClient` calls a pricing service over HTTP; unit tests mock the HTTP client.

Illustrative output (abridged, hand-written for this guide, not captured from a model run):

```text
Starts a local stub server. Tests: 200 with valid JSON, 404 -> `PriceNotFound`, 500 -> `PriceServiceUnavailable`, malformed JSON -> `InvalidPriceResponse`, slow response -> timeout error within the configured limit.
```

## Sample prompts

```text
Write integration tests for [CLASS] against a real [database engine | local stub HTTP server]. Cover success, not found, constraint or 5xx errors, malformed responses and timeouts. Isolate data per test, tag the tests as integration, and tell me the command to run them. Report actual results. Code: [CODE]
```

## Common mistakes

- Calling a test with a mocked HTTP client an integration test.
- Using a different database dialect than production without noting the gap.
- Sharing state between tests so that they fail in a different order.
- Testing only success responses.

## Related skills

- [Unit Test Engineer](../unit-test-engineer/SKILL.md)
- [API Contract Reviewer](../api-contract-reviewer/SKILL.md)
- [Database Design Reviewer](../database-design-reviewer/SKILL.md)

## Related resources

Handbook:

- [Chapter 5: Test Driven Development](../../handbook/05_test_driven_development/README.md)
- [Chapter 6: Defensive Programming and Edge Case Engineering](../../handbook/06_defensive_programming/README.md)

Prompts:

- [Integration Test Generation](../../prompts/testing/integration-test-generation.md)
- [Contract Testing](../../prompts/testing/contract-testing.md)
- [Flaky Test Diagnosis](../../prompts/testing/flaky-test-diagnosis.md)

Workflows:

- [Write unit and integration tests](../../workflows/07_unit_and_integration_testing.md)
- [Introduce a new API](../../workflows/04_new_api.md)
- [Change a database schema](../../workflows/05_database_schema_change.md)

Examples:

- [examples/python/README.md](../../examples/python/README.md) scenario S8; [examples/java/README.md](../../examples/java/README.md) scenario S8

Versions

RepositoryScoreLicence
This page · arijeetganguli/ai-kaarkhana100MIT
arijeetganguli/ai-kaarkhana100MIT

Database snapshot: 13.11.2026 · package version bd831ab9dc77 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100integration-test
    Creates Go integration tests for net/http handlers, services, and sqlc queries against a real PostgreSQL database started with testcontainers-go. Use when the user asks to "write integration tests", "test with a real database", "create Go integration tests", or mentions Go…
  • 100unit-test-engineer
    Designs and writes fast, deterministic unit tests that assert behaviour, cover boundaries and negative cases, and fail when the code is wrong. Use when adding or improving unit tests for existing or new code.
  • 100unit-test-engineer
    Designs and writes fast, deterministic unit tests that assert behaviour, cover boundaries and negative cases, and fail when the code is wrong. Use when adding or improving unit tests for existing or new code.
  • 100integration
    Integration testing skill. Tests across real boundaries — databases, APIs, message queues. Covers Testcontainers, DB seeding/cleanup, API integration. Triggers on: /godmode:integration, "test with real database", "testcontainers".
  • 85wicked-garden-qe-integration-test-engineer
    Real-service integration testing — distinct from contract testing. Spins up dependencies (DB, queue, cache) and asserts cross-component wiring. No mocks. Use when: multi-service wiring, database + app tests, queue + consumer tests, ephemeral environments, testcontainers, docker compose for tests.
  • 100backend-test
    Generate backend tests (unit, integration, mocks) for existing code. Auto-invoke when user says "write test for", "add test", "test this", or "create test".

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.