testcontainers-integration-tests

Use this skill when:

aaronontheweb/dotnet-skills|Updated Apr 8, 2026

Works with

Claude CodeCursorClineWindsurfCodexGoose

Installation Guide

Select your AI agent

How to use testcontainers-integration-tests on Cursor

AI-first code editor with Composer

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

›Cursor installed and configured on your machine
›Node.js 16+ with npm — verify with node --version
›Active project directory where you want to add testcontainers-integration-tests

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/aaronontheweb/dotnet-skills --skill testcontainers-integration-tests

Fetches testcontainers-integration-tests from aaronontheweb/dotnet-skills and configures it for Cursor.

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?

│

│ ── Universal (.agents/skills) ────────────────

│ · Cline · Codex · Goose · Windsurf

│ ●Cursor(selected)

│ · Cursor · Aider · Continue

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/testcontainers-integration-tests

Restart Cursor to activate testcontainers-integration-tests. Access via /testcontainers-integration-tests in your agent's command palette.

⚠

Security Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.

›View source on GitHub ›Skills CLI docs ›About Cursor ›What are agent skills?

Documentation

List & Monetize Your Skill

Submit your Claude Code skill and start earning

Get started →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

✓

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

✓

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

✓

Improve work quality by 30-40% with less effort

When to Use This Skill

Use this skill when:

Writing integration tests that need real infrastructure (databases, caches, message queues)

Testing data access layers against actual databases

Verifying message queue integrations

Testing Redis caching behavior

Avoiding mocks for infrastructure components

Ensuring tests work against production-like environments

Testing database migrations and schema changes

Core Principles

Real Infrastructure Over Mocks - Use actual databases/services in containers, not mocks

Test Isolation - Each test gets fresh containers or fresh data

Automatic Cleanup - TestContainers handles container lifecycle and cleanup

Fast Startup - Reuse containers across tests in the same class when appropriate

CI/CD Compatible - Works seamlessly in Docker-enabled CI environments

Port Randomization - Containers use random ports to avoid conflicts

Why TestContainers Over Mocks?

The Problem with Mocking Infrastructure

// BAD: Mocking a database public class OrderRepositoryTests { private readonly Mock<IDbConnection> _mockDb = new(); [Fact] public async Task GetOrder_ReturnsOrder() { // This doesn't test real SQL behavior, constraints, or performance _mockDb.Setup(db => db.QueryAsync<Order>(It.IsAny<string>())) .ReturnsAsync(new[] { new Order { Id = 1 } }); var repo = new OrderRepository(_mockDb.Object); var order = await repo.GetOrderAsync(1); Assert.NotNull(order); } }

Problems: doesn't test actual SQL queries, misses constraints/indexes, gives false confidence, doesn't catch SQL syntax errors.

Better: TestContainers with Real Database

// GOOD: Testing against a real database public class OrderRepositoryTests : IAsyncLifetime { private readonly TestcontainersContainer _dbContainer; private IDbConnection _connection; public OrderRepositoryTests() { _dbContainer = new TestcontainersBuilder<TestcontainersContainer>() .WithImage("mcr.microsoft.com/mssql/server:2022-latest") .WithEnvironment("ACCEPT_EULA", "Y") .WithEnvironment("SA_PASSWORD", "Your_password123") .WithPortBinding(1433, true) .Build(); } public async Task InitializeAsync() { await _dbContainer.StartAsync(); var port = _dbContainer.GetMappedPublicPort(1433); var connectionString = $"Server=localhost,{port};Database=TestDb;User Id=sa;Password=Your_password123;TrustServerCertificate=true"; _connection = new SqlConnection(connectionString); await _connection.OpenAsync(); await RunMigrationsAsync(_connection); } public async Task DisposeAsync() { await _connection.DisposeAsync(); await _dbContainer.DisposeAsync(); } [Fact] public async Task GetOrder_WithRealDatabase_ReturnsOrder() { await _connection.ExecuteAsync( "INSERT INTO Orders (Id, CustomerId, Total) VALUES (1, 'CUST1', 100.00)"); var repo = new OrderRepository(_connection); var order = await repo.GetOrderAsync(1); Assert.NotNull(order); Assert.Equal("CUST1", order.CustomerId); Assert.Equal(100.00m, order.Total); } }

See database-patterns.md for complete SQL Server, PostgreSQL, and migration testing examples.

See infrastructure-patterns.md for Redis, RabbitMQ, multi-container networks, container reuse, and Respawn database reset patterns.

Required NuGet Packages

testcontainers-integration-tests

Installation Guide

How to use testcontainers-integration-tests on Cursor

Prerequisites

Run the install command

Select Cursor when prompted

Verify installation

Security Notice

Documentation

List & Monetize Your Skill

Use Cases

Task Automation & Efficiency

Knowledge Enhancement

Quality Improvement

Install Skill

Integration Testing with TestContainers

When to Use This Skill

Reference Files

Core Principles

Why TestContainers Over Mocks?

The Problem with Mocking Infrastructure

Better: TestContainers with Real Database

Required NuGet Packages

Best Practices

Implementation Guide

Best Practices

When to Use This

Learning Path

Related Skills

mjml-email-templates

ml-paper-writing

beautiful-mermaid

llm-council

blockchain-developer

qq-email

Reviews

Discussion