temporal-cloud
Fix Temporal Cloud connection, auth, and config problems. Use when users hit login failures, can't connect to Cloud, get x509/TLS errors, have namespace or endpoint mismatches, paste broken SDK connection snippets, are confused about which endpoint to use, see "no pollers" or RESOURCE_EXHAUSTED, struggle with PrivateLink/PSC, or need help setting up a new namespace. Also use for HA namespace failover and DNS issues. Not for worker performance tuning or scaling.
93
92%
Does it follow best practices?
Impact
91%
1.33xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly defines its scope with specific error types, natural trigger terms users would encounter, and explicit 'Use when' and 'Not for' clauses. It covers a well-defined niche (Temporal Cloud connection/auth/config) with enough detail to distinguish it from related skills like worker performance tuning. The description is comprehensive yet concise, hitting all rubric dimensions at the highest level.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and scenarios: fix connection/auth/config problems, login failures, x509/TLS errors, namespace/endpoint mismatches, broken SDK connection snippets, 'no pollers' or RESOURCE_EXHAUSTED errors, PrivateLink/PSC setup, namespace setup, HA failover, and DNS issues. | 3 / 3 |
Completeness | Clearly answers both 'what' (fix Temporal Cloud connection, auth, and config problems) and 'when' with an explicit 'Use when...' clause listing numerous specific trigger scenarios. Also includes a 'Not for...' exclusion clause which further clarifies scope. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would actually say or encounter: 'login failures', 'can't connect to Cloud', 'x509/TLS errors', 'namespace', 'endpoint mismatches', 'SDK connection snippets', 'no pollers', 'RESOURCE_EXHAUSTED', 'PrivateLink/PSC', 'HA namespace failover', 'DNS issues'. These are highly specific error messages and terms users would paste or describe. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche around Temporal Cloud connection/auth/config issues. The explicit exclusion of 'worker performance tuning or scaling' further reduces conflict risk with adjacent skills. The specific error messages and product names (Temporal Cloud, PrivateLink, PSC) make it very unlikely to trigger incorrectly. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, well-structured troubleshooting skill with excellent actionability through specific CLI commands and decision trees. The progressive disclosure is well-handled with clear references to supporting files. The main weakness is some redundancy—endpoint guidance, confidence score instructions, and context-gathering questions appear in multiple places, which inflates token usage without adding proportional value.
Suggestions
Consolidate the confidence score instructions (currently explained in Step 4 and again in the Ambiguous Runtime Errors section) into a single location to reduce redundancy.
Consider merging the 'Gather Context' question lists with the decision trees they feed into, since much of the information is duplicated between the two sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is quite long (~400+ lines) and includes some redundancy—confidence score instructions appear twice, endpoint tables are repeated across sections, and the 'Gather Context' questions overlap with what the decision trees already cover. However, it avoids explaining basic concepts Claude would know and most content is domain-specific knowledge that earns its place. | 2 / 3 |
Actionability | The skill provides specific, executable CLI commands throughout (tcld, openssl, temporal CLI, nc, nslookup), concrete endpoint formats with examples, exact namespace naming conventions, and copy-paste-ready verification commands. The decision trees give precise diagnostic steps rather than vague guidance. | 3 / 3 |
Workflow Clarity | The decision trees provide clear sequenced workflows with explicit validation checkpoints (e.g., DNS resolution → port connectivity → TLS handshake → CLI test). The confidence scoring system adds a feedback mechanism for ambiguous cases, and the 'Ambiguous Runtime Errors' section explicitly handles cases where the diagnosis is uncertain with a narrow-next-check approach rather than speculative fixes. | 3 / 3 |
Progressive Disclosure | The skill has a clear overview structure with well-signaled one-level-deep references to `references/cloud-troubleshooting-reference.md`, `references/common-scenarios.md`, and external docs. The main file contains actionable decision trees while deferring detailed walkthroughs and full CLI references to separate files. Navigation is clear with a classification table up front. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- temporalio/skill-temporal-cloud
- Commit
2d867d1
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.