integration-test-runner

Run integration test suites against real services with parallel isolation.

3|2|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/robotijn/ctoc --skill integration-test-runner-robotijn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-test-runner
Source: https://github.com/robotijn/ctoc/tree/main/skills/testing/runners/integration-test-runner
Command: npx skills add https://github.com/robotijn/ctoc --skill integration-test-runner-robotijn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integration tests are the most neglected layer of the testing trophy, often producing flaky results due to poor service isolation, port conflicts, and missing cleanup that waste hours of developer debugging time and let real system interaction bugs slip through to production.

Core Features & Use Cases

  • Parallel-safe test execution: Runs integration test suites against real databases, caches, and external services with built-in isolation strategies to avoid flaky failures.
  • Failure root cause detection: Automatically identifies common integration test failure modes including shared-DB flakes, slow container startup, port conflicts, and missing teardown, with actionable fix recommendations.
  • 2026 best practice compliance: Enforces modern testing standards like Testcontainers reuse for developer machines, schema-per-test isolation, and loud failures for missing infrastructure instead of silent skips. Use case: A team running a PostgreSQL-backed API test suite can use this skill to automatically provision containers, execute tests in parallel with proper isolation, and flag flaky tests caused by missing savepoint rollback so test writers can fix fixtures instead of debugging random failures.

Quick Start

Use the integration-test-runner skill to execute your project's integration test suite against real services and receive a structured report of passes, failures, and flaky test root causes.

Frequently Asked Questions about integration-test-runner

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

FAQPage Schema
Why do my integration tests fail randomly with port conflicts and missing cleanup?

Integration tests fail randomly due to poor service isolation, port conflicts, and missing teardown. This skill enforces per-test isolation and loud failure on missing infrastructure to eliminate flaky results and wasted debugging time.

How do I run parallel integration tests against a real PostgreSQL database without flaky failures?

To run parallel integration tests against real databases without flakes, use built-in isolation strategies like schema-per-test isolation and Testcontainers reuse. This skill provisions containers and prevents shared-DB conflicts during parallel execution.

Can I use Testcontainers for integration testing across Python, Node.js, Go, and Java?

Yes, you can use Testcontainers for integration testing across Python, Node.js, Go, Java, .NET, C/C++, and SQL. The skill enforces 2026 best practices including container reuse on developer machines and loud failures for missing infrastructure.

What is the best way to detect flaky integration tests caused by shared database state?

The best way to detect flaky integration tests caused by shared database state is automated root cause detection. This skill identifies shared-DB flakes, slow container startup, and missing savepoint rollbacks, providing actionable fix guidance.

How do I stop my CI/CD pipeline from silently skipping integration tests when infrastructure is missing?

To stop CI/CD pipelines from silently skipping integration tests when infrastructure is missing, enforce loud failure standards. This skill ensures missing infrastructure causes explicit test failures instead of silent skips, preventing real bugs from slipping through.