Can I use this to reset a workflow to a specific point?

Yes, the skill provides specific Temporal CLI commands to reset workflows to specific event IDs or the last successful workflow task to recover from failures.

How does this skill help with non-determinism errors?

It identifies common causes like using system time, random values, or map iteration, and provides deterministic code patterns and versioning strategies using GetVersion to resolve them.

What tools does this skill assume I have?

The skill provides commands for the Temporal CLI (temporal) and utilizes JQ for parsing JSON history exports for deep analysis.

How do I identify why an activity is timing out?

The skill breaks down the four types of Temporal timeouts (ScheduleToStart, StartToClose, etc.) and provides JQ filters to extract exact failure attributes from your workflow history.

Does it support troubleshooting for Nexus operations?

Yes, it includes a dedicated diagnostic tree for Nexus failures, helping you verify endpoints, handler worker status, and cross-namespace authorization.

Temporal Workflow Troubleshooting

Name: Temporal Workflow Troubleshooting
Author: therealbill

bytherealbill

0•

分析と監視

Diagnoses and resolves complex Temporal workflow issues including non-determinism errors, activity timeouts, and worker connectivity problems.

The troubleshooting skill for the timelord plugin provides expert-level guidance for identifying and fixing failures within Temporal-based applications. It streamlines the debugging process by offering structured diagnostic trees for common issues like stuck workflows, history mismatches, and Nexus operation failures. By providing specific CLI commands and best-practice code patterns, it helps developers quickly isolate whether a problem stems from worker infrastructure, workflow logic, or external dependencies, ensuring high reliability for distributed systems.

主な機能

010 GitHub stars

02Nexus operation troubleshooting for cross-namespace and cross-cluster communication

03Detailed guidance on resolving ActivityTaskTimedOut and ScheduleToStart latencies

04Diagnostic trees for identifying causes of stuck or non-progressing workflows

05CLI command templates for workflow resets, event history analysis, and task queue inspection

06Remediation patterns for 'non-deterministic workflow definition' and history mismatch errors

ユースケース

01Implementing versioning with GetVersion to fix non-determinism after code changes

02Recovering workflows stuck in 'Running' state due to worker disconnects or missing signals

03Optimizing activity timeouts and retry policies based on specific failure types

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