Agent skill · software engineering · wshobson
temporal-python-testing
Test Temporal workflows with pytest, time-skipping, and mocking strategies. Covers unit testing, integration testing, replay testing, and local development setup. Use when implementing Temporal workflow tests or debugging test failures.
Why this skill is useful
Provides specific testing strategies and resources for Temporal workflows that the AI wouldn't reliably generate on its own.
What it needs
Requires pytest, temporalio installed locally. About 2k tokens when loaded. Last updated 2026-08-05. 38,570 stars on the source repository.
What this skill does
Temporal Python Testing Strategies Comprehensive testing approaches for Temporal workflows using pytest, progressive disclosure resources for specific testing scenarios. When to Use This Skill Unit testing workflows - Fast tests with time-skipping Integration testing - Workflows with mocked activities Replay testing - Validate determinism against production histories Local development - Set up Temporal server and pytest CI/CD integration - Automated testing pipelines Coverage strategies - Achieve ≥80% test coverage Testing Philosophy Recommended Approach (Source: docs.temporal.io/develop/python/testing-suite): Write majority as integration tests Use pytest with async fixtures Time-skipping enables fast feedback (month-long workflows → seconds) Mock activities to isolate workflow logic Validate determinism with replay testing Three Test Types: 1. Unit: Workflows with time-skipping, activities with ActivityEnvironment 2. Integration: Workers with mocked activities 3. End-to-end: Full Temporal server with real activities (use sparingly) Available Resources This skill provides detailed guidance through progressive disclosure. Load specific resources based on your testing needs: Unit Testing Resources File: resources/unit-testing.md When to load: Testing individual workflows or activities in isolation Contains: WorkflowEnvironment with time-skipping ActivityEnvironment for activity testing Fast execution of long-running workflows Manual time advancement patterns pytest fixtures and patterns Integration Testing Resources File: resources/integration-testing.md When to load: Testing workflows with mocked external dependencies Contains: Activity mocking strategies Error injection patterns Multi-activity workflow testing Signal and query testing Coverage strategies Replay Testing Resources File: resources/replay-testing.md When to load: Validating determinism or deploying workflow changes Contains: Determinism validation Production history replay CI/CD integration patterns Ve …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills wshobson/temporal-python-testing