Develop, debug, and manage Temporal applications across Python, TypeScript, Go, Java and .NET. Use when the user is building workflows, activities, or workers with a Temporal SDK, debugging issues like non-determinism errors, stuck workflows, or activity retries, using Temporal CLI, Temporal Server, or Temporal Cloud, or working with durable execution concepts like signals, queries, heartbeats, versioning, continue-as-new, child workflows, or saga patterns.
84
78%
Does it follow best practices?
Impact
96%
1.03xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./SKILL.mdQuality
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 (Temporal application development across five languages), provides comprehensive trigger terms covering SDK usage, debugging scenarios, CLI/server tooling, and durable execution concepts, and includes an explicit 'Use when...' clause. It is highly specific, complete, and distinctive with minimal conflict risk.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Develop, debug, and manage Temporal applications' across five named languages, and enumerates specific concepts like non-determinism errors, stuck workflows, activity retries, signals, queries, heartbeats, versioning, continue-as-new, child workflows, and saga patterns. | 3 / 3 |
Completeness | Clearly answers both 'what' (develop, debug, and manage Temporal applications across multiple languages) and 'when' with an explicit 'Use when...' clause that covers building with SDKs, debugging specific issues, using Temporal tooling, and working with durable execution concepts. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms a user would say: 'Temporal', 'workflows', 'activities', 'workers', 'Temporal SDK', 'Temporal CLI', 'Temporal Server', 'Temporal Cloud', 'non-determinism errors', 'stuck workflows', 'activity retries', 'signals', 'queries', 'heartbeats', 'versioning', 'continue-as-new', 'child workflows', 'saga patterns'. These are all terms a developer working with Temporal would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — Temporal is a specific technology with a clear niche. The description names Temporal-specific concepts (non-determinism errors, continue-as-new, heartbeats, saga patterns) that are unlikely to conflict with other skills. The only minor overlap risk would be with general workflow orchestration skills, but the Temporal-specific terminology makes it clearly distinguishable. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured routing/overview skill with excellent progressive disclosure and clear reference organization across multiple languages and topics. Its main weaknesses are verbosity in the architecture explanation (concepts Claude likely knows) and a lack of inline actionable examples — it relies almost entirely on delegating to reference files without providing any quick-start code snippets or concrete debugging workflows in the main body.
Suggestions
Trim the Core Architecture section significantly — Claude understands distributed systems concepts; focus on Temporal-specific constraints and gotchas rather than explaining what Workers and Task Queues are.
Add at least one concrete, executable quick-start code snippet per major language (even a 5-line workflow + activity example) so the skill is immediately actionable without reading reference files.
Add an explicit troubleshooting workflow with validation checkpoints for common debugging scenarios (e.g., non-determinism errors: 1. Check error message → 2. Identify the mismatched command → 3. Review recent code changes → 4. Apply versioning fix → 5. Verify with replay test).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Core Architecture section explains concepts like what Workers, Task Queues, and Event History are at a level Claude likely already understands. The History Replay section is useful but the architecture overview could be significantly tightened. The Task Queue Priority/Fairness section adds proactive recommendation context that earns its place, but overall there's room to trim. | 2 / 3 |
Actionability | The skill is primarily a routing document pointing to reference files rather than providing executable code or concrete commands inline. The only concrete command is `temporal server start-dev`. The 'Getting Started' section tells Claude to read other files rather than providing actionable steps directly. For a routing/overview skill this is somewhat expected, but it lacks any inline code examples for common tasks. | 2 / 3 |
Workflow Clarity | The Getting Started section provides a basic sequence (install CLI, read language guide, read relevant references), but there are no validation checkpoints or feedback loops. For a skill covering debugging stuck workflows and non-determinism errors, the main SKILL.md lacks any troubleshooting workflow with explicit validation steps — it just points to reference files. The history replay explanation is a conceptual sequence, not an actionable workflow. | 2 / 3 |
Progressive Disclosure | The skill excels at progressive disclosure with a clear overview followed by well-organized, one-level-deep references. References are clearly categorized (core vs. language-specific), paths are consistent and predictable (`references/core/...`, `references/{language}/...`), and each reference has a brief description of what it covers. The integrations catalog pattern is also well-structured. | 3 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
77def86
Table of Contents
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.