Akka Net Testing Patterns

If you're testing Akka.NET actors, this skill from Aaron Stannard walks you through eight different testing patterns with complete code samples. It covers the basics like unit testing actors and message flows, but also gets into the trickier stuff like testing persistent actors with event sourcing, cluster sharding behavior, and state recovery. The examples.md file has working code for each pattern, while anti-patterns-and-reference.md shows you what not to do and how to integrate tests into CI/CD. It's practical rather than theoretical, which makes sense given it's from someone deeply involved in the Akka.NET ecosystem. Worth grabbing if you're beyond hello world actors and need to actually verify your distributed systems work correctly.

skills.sh installs: 431
GitHub stars: 1.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add aaronontheweb/dotnet-skills --skill akka-net-testing-patterns --agent claude-code

Installs into .claude/skills of the current project.

Files

Akka.NET Testing Patterns

When to Use This Skill

Use this skill when:

Writing unit tests for Akka.NET actors
Testing persistent actors with event sourcing
Verifying actor interactions and message flows
Testing actor supervision and lifecycle
Mocking external dependencies in actor tests
Testing cluster sharding behavior locally
Verifying actor state recovery and persistence

Reference Files

examples.md: Complete code samples for all testing patterns (Patterns 1-8 plus Reminders)
anti-patterns-and-reference.md: Anti-patterns, traditional TestKit, CI/CD integration

Choosing Your Testing Approach

Use Akka.Hosting.TestKit (Recommended for 95% of Use Cases)

When:

Building modern .NET applications with Microsoft.Extensions.DependencyInjection
Using Akka.Hosting for actor configuration in production
Need to inject services into actors (IOptions, DbContext, ILogger, HTTP clients, etc.)
Testing applications that use ASP.NET Core, Worker Services, or .NET Aspire
Working with modern Akka.NET projects (Akka.NET v1.5+)