CtrlK
BlogDocsLog inGet started
Tessl Logo

workflow-orchestration-patterns

Design durable workflows with Temporal for distributed systems. Covers workflow vs activity separation, saga patterns, state management, and determinism constraints. Use when building long-running processes, distributed transactions, or microservice orchestration.

63

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/backend-development/skills/workflow-orchestration-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-structured and concisely written, with good progressive disclosure to a single reference file. It is weakened by the absence of executable code examples and by being pattern-reference material without sequenced validation checkpoints.

Suggestions

Add one minimal executable Temporal SDK snippet (e.g., a workflow + activity in Python/Go) so the guidance is copy-paste ready rather than pseudocode-only.

Include a short validation/verification step for the saga pattern — e.g., how to confirm compensations ran or how to test determinism with the time-skipping test environment.

Move the inlined Best Practices and Common Pitfalls lists into references/details.md, keeping SKILL.md as a tighter overview that points to the detail file.

DimensionReasoningScore

Conciseness

The body is mostly efficient bullet-list guidance that assumes Claude's competence, with only minor instances that could be trimmed (e.g., the 'When NOT to Use' and 'Additional Resources' lists border on padding).

4 / 5

Actionability

Concrete actionable rules appear (e.g., 'Using datetime.now() instead of workflow.now()', '2MB per argument', 'Always set timeouts'), but the body provides no executable code and the worked patterns in details.md are pseudocode, leaving key implementation details incomplete.

3 / 5

Workflow Clarity

Patterns carry a rough sequence (saga: register compensation → execute → run compensations LIFO), but this is reference material rather than a procedural workflow and lacks any validation or verification checkpoints.

3 / 5

Progressive Disclosure

Clear sectioned overview with a well-signaled one-level-deep pointer to references/details.md ('Read that file when the navigation tier above is insufficient'); minor gaps because a fair amount of best-practice content is inlined rather than delegated.

4 / 5

Total

14

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is strong: it clearly states the skill's purpose, enumerates concrete domain capabilities, and provides an explicit 'Use when' trigger clause tied to natural user language. Its only weakness is mild reliance on topic enumeration rather than varied action verbs.

DimensionReasoningScore

Specificity

Lists several concrete capabilities — 'workflow vs activity separation, saga patterns, state management, and determinism constraints' — but relies on a single action verb ('Design') with topic enumeration rather than multiple distinct actions, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers both what ('Design durable workflows with Temporal... Covers...') and when ('Use when building long-running processes, distributed transactions, or microservice orchestration') with concrete trigger phrases.

5 / 5

Trigger Term Quality

The 'Use when building long-running processes, distributed transactions, or microservice orchestration' clause provides good natural keywords a user would say, though a few common synonyms (e.g., 'saga', 'event-driven') are missing.

4 / 5

Distinctiveness Conflict Risk

Temporal-specific workflow orchestration niche with distinct triggers ('durable workflows', 'saga patterns', 'microservice orchestration') gives minimal conflict risk with other skills.

5 / 5

Total

18

/

20

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
wshobson/agents
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.