What recovery actions does the skill support?

It provides instructions for resetting a workflow to a specific event ID, terminating stuck executions, or requesting graceful cancellations.

Can I use this to fix stuck Nexus operations?

Yes, it includes a dedicated diagnostic tree for Nexus issues, covering endpoint configurations, handler worker availability, and cross-namespace authentication.

How does it help with 'non-deterministic' errors?

The skill provides specific code examples showing the difference between non-deterministic patterns (like using system time) and deterministic equivalents (like workflow.Now) to prevent history mismatches.

What is the primary purpose of the Temporal Troubleshooting skill?

It provides structured guidance, diagnostic commands, and best practices for resolving common issues in Temporal workflow orchestrations.

Does this skill work with any Temporal SDK?

While the code examples are often in Go, the diagnostic logic, CLI commands, and conceptual solutions apply to all Temporal SDKs including TypeScript, Python, and Java.

Temporal Troubleshooting

Name: Temporal Troubleshooting
Author: therealbill

bytherealbill

0•

Analytics & Monitoring

Diagnoses and resolves complex Temporal workflow issues including non-determinism, timeouts, and stuck executions.

The Temporal Troubleshooting skill provides a specialized diagnostic framework for developers managing distributed orchestrations with Temporal. It offers structured logic to identify why workflows are stuck, failing, or suffering from non-determinism errors. By providing specific CLI commands for event history inspection and code-level patterns for fixing common pitfalls like improper time usage or map iteration, this skill streamlines the debugging process. It also covers advanced topics like Nexus operation failures and workflow recovery actions, ensuring your stateful applications remain resilient and maintainable.

Key Features

01Code patterns for resolving non-determinism and history mismatch errors

02Step-by-step diagnostic trees for identifying root causes of stuck workflows

03Recovery procedures for resetting, terminating, or canceling workflows

040 GitHub stars

05Pre-configured CLI commands for inspecting workflow states and event histories

06Timeout management guidance for activities and heartbeating

Use Cases

01Fixing 'non-deterministic workflow definition' errors caused by side effects

02Debugging cross-namespace Nexus operations and endpoint misconfigurations

03Identifying why activities are scheduled but not being picked up by workers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add therealbill/mynet troubleshooting

For use in Claude.ai and ChatGPT

Download Skill