Temporal Cloud

This one walks you through the usual suspects when you can't connect to Temporal Cloud or your workers aren't picking up tasks. It knows the difference between tcld login failures, mTLS certificate problems, namespace endpoint misconfigurations, and the genuinely ambiguous errors like "context deadline exceeded" that could mean five different things. The decision trees are practical: check DNS, verify you're using the namespace endpoint instead of the old regional format, confirm pollers are actually running. It explicitly stays out of worker performance tuning and keeps you focused on getting the connection working in the first place. Good for when you're staring at x509 errors or pasted SDK snippets that look wrong but you're not sure why.

skills.sh installs: 609
GitHub stars: 6
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add temporalio/skill-temporal-cloud --skill temporal-cloud --agent claude-code

Installs into .claude/skills of the current project.

Files

Temporal Cloud Skill

Help users diagnose and resolve Temporal Cloud connectivity, authentication, and configuration issues using tcld and temporal CLI.

Core Philosophy

Cloud issues are frustrating because they sit at the intersection of configuration, networking, authentication, and Temporal-specific code. Most problems fall into predictable patterns. This skill provides systematic diagnosis to quickly identify root causes and prescribe fixes.

References:

See references/cloud-troubleshooting-reference.md for full CLI command reference and error codes
See references/common-scenarios.md for step-by-step setup walkthroughs
Environment configuration docs - SDK setup for connecting to Cloud
HA namespace connectivity - multi-region endpoint and DNS setup
Dev Success troubleshooting guide - companion connection troubleshooting guide

SKILL.md on GitHub

Details

Repository: github.com/temporalio/skill-temporal-cloud
Categories: Backend & APIs, Debugging, Cloud & Infrastructure
First seen: Jun 3, 2026