Akka Net Best Practices

Aaron Stannard's Akka.NET skill cuts through the framework's complexity with opinionated guidance on actor patterns, supervision, and cluster abstractions. It covers the practical decision points you actually hit in production: when to use EventStream versus DistributedPubSub, how to abstract Cluster Sharding for local testing, and async cancellation patterns that don't leak. The included reference files on work distribution and cluster-local abstractions suggest real patterns extracted from building distributed systems, not just API docs repackaged. If you're past Akka.NET tutorials and need to make architectural calls that won't bite you later, this is worth the 247 installs it's already gotten.

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

View on GitHub

Install

$ npx -y skills add aaronontheweb/dotnet-skills --skill akka-net-best-practices --agent claude-code

Installs into .claude/skills of the current project.

Files

Akka.NET Best Practices

When to Use This Skill

Use this skill when:

Designing actor communication patterns
Deciding between EventStream and DistributedPubSub
Implementing error handling in actors
Understanding supervision strategies
Choosing between Props patterns and DependencyResolver
Designing work distribution across nodes
Creating testable actor systems that can run with or without cluster infrastructure
Abstracting over Cluster Sharding for local testing scenarios

Reference Files

work-distribution-patterns.md: Database queues, Akka.Streams throttling, outbox pattern
cluster-local-abstractions.md: GenericChildPerEntityParent, IPubSubMediator, execution mode wiring
async-cancellation-patterns.md: Actor-scoped CancellationToken, linked CTS, timeout handling