integration-testing

Validate component interactions against real infrastructure dependencies using Testcontainers or Docker Compose.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/marquesfelip/agents-and-skills --skill integration-testing-marquesfelip
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-testing
Source: https://github.com/marquesfelip/agents-and-skills/tree/main/skills/integration-testing
Command: npx skills add https://github.com/marquesfelip/agents-and-skills --skill integration-testing-marquesfelip

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integration testing ensures components interact correctly with real infrastructure dependencies (databases, caches, brokers, external services), catching issues that unit tests may miss.

Core Features & Use Cases

  • Define test scope that targets infrastructure contracts and data management.
  • Choose and configure infrastructure strategies (Testcontainers, Docker Compose, embedded options) for realistic test environments.
  • Ensure test isolation and deterministic results with per-test data seeding, dedicated schemas, and cleanup hooks.

Quick Start

Configure Testcontainers and write a simple integration test that boots a PostgreSQL container and validates a repository query.

Frequently Asked Questions about integration-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate component interactions against real infrastructure dependencies like databases and message brokers?

To validate component interactions, integration testing connects your components to real infrastructure dependencies like databases and message brokers. Using containerized environments ensures end-to-end reliability by catching infrastructure contract issues that unit tests miss.

What's the best way to isolate integration tests and ensure deterministic results?

The best way to isolate integration tests involves implementing a defined isolation strategy with per-test data seeding, dedicated schemas, and cleanup hooks. This guarantees reproducible results by preventing data leakage between test executions.

How do I set up integration tests using Testcontainers and Docker Compose?

You set up integration tests by configuring Testcontainers or Docker Compose to boot real infrastructure, such as a PostgreSQL container. This provides a realistic test environment to validate repository queries and external service interactions.

When do I need integration testing instead of unit testing for my application?

You need integration testing when you must verify infrastructure contracts and data management against real services. It targets scenarios involving databases, caches, and message brokers, catching interaction issues that standard unit tests cannot detect.

Does integration testing work with external services and message brokers?

Yes, integration testing works with external services and message brokers by validating component interactions against these real infrastructure dependencies. Containerized environments manage the external service lifecycle to ensure end-to-end reliability.

Why does my integration test fail to produce reproducible results?

Integration tests fail to produce reproducible results without a defined isolation strategy and proper test data management. Implementing per-test data seeding, dedicated schemas, and cleanup hooks ensures deterministic outcomes by maintaining test isolation.