CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-workflow-designer

Design production-grade multi-agent workflows with clear pattern choice (sequential, parallel, hierarchical), handoff contracts, failure handling, and cost/context controls. Use when architecting a multi-step agent pipeline, choosing between single-agent vs multi-agent approaches, or refactoring an LLM workflow that suffers from context bloat or unreliable handoffs.

67

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

Well-structured, lean content with executable scaffold commands, a clear sequenced workflow, and exemplary progressive disclosure against a real one-level-deep bundle. The main gaps are mild redundancy between Overview and Core Capabilities and the absence of a concrete inline handoff-contract example.

Suggestions

Remove or merge the Overview/Core Capabilities sections, which duplicate the frontmatter description, to save tokens and lift conciseness to the top anchor.

Inline one minimal handoff contract example (e.g., a short JSON snippet showing required fields per edge) or point to one in references/workflow-patterns.md, so 'Define handoff contract fields for every edge' is directly actionable.

Add an explicit feedback loop to the Recommended Workflow (e.g., 'validate output; if validation fails, fix and re-run dry-run before scaling') to reach the top workflow-clarity anchor.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence (e.g., the Pattern Map is five one-line entries, Common Pitfalls are terse bullets). Minor redundancy: the Overview repeats the frontmatter description nearly verbatim ('Design production-grade multi-agent workflows with clear pattern choice, handoff contracts, failure handling, and cost/context controls.') and Core Capabilities restates it, which could be trimmed — placing it at efficient-with-minor-fat rather than the 5 anchor.

4 / 5

Actionability

Quick Start gives copy-paste-ready commands ('python3 scripts/workflow_scaffolder.py sequential --name content-pipeline') and the Pattern Map names concrete patterns. However, steps like 'Define handoff contract fields for every edge' have no inline example of a contract or scaffold output, leaving minor gaps versus the fully-executable 5 anchor.

4 / 5

Workflow Clarity

The Recommended Workflow is a clear five-step sequence that includes checkpoints ('Add retry/timeouts and output validation gates', 'Dry-run with small context budgets before scaling'). It stops short of the 5 anchor because there is no explicit validate-then-fix-then-retry feedback loop or ordered handling of failures. This is not a destructive or batch skill, so the cap at 3 does not apply.

4 / 5

Progressive Disclosure

The body is a clear overview with a well-signaled, one-level-deep reference ('Detailed templates: references/workflow-patterns.md') that exists in the bundle, and detailed JSON templates are appropriately split into that file while the scaffold script lives in scripts/. Structure matches the actual bundle layout with easy navigation, fitting the 5 anchor.

5 / 5

Total

17

/

20

Passed

Description

83%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.

A strong description that clearly states what the skill does and when to use it, with natural, distinctive trigger phrases and mostly specific capability language. Its only weaknesses are mild: a single-verb action structure and a few missing common synonyms like 'orchestration'.

DimensionReasoningScore

Specificity

The description lists several specific actions and facets — 'Design production-grade multi-agent workflows with clear pattern choice (sequential, parallel, hierarchical), handoff contracts, failure handling, and cost/context controls' — with named patterns. It falls just short of the 5 anchor because the concrete actions are aspects of one design verb rather than a comprehensive list of distinct operations.

4 / 5

Completeness

It explicitly answers both: what ('Design production-grade multi-agent workflows with clear pattern choice... handoff contracts, failure handling, and cost/context controls') and when ('Use when architecting a multi-step agent pipeline, choosing between single-agent vs multi-agent approaches, or refactoring an LLM workflow that suffers from context bloat or unreliable handoffs') with concrete trigger phrases, matching the 5 anchor.

5 / 5

Trigger Term Quality

Natural phrases like 'architecting a multi-step agent pipeline', 'choosing between single-agent vs multi-agent approaches', 'context bloat', and 'unreliable handoffs' are terms users would plausibly say. It misses a few common synonyms such as 'orchestration' or 'agent teams', placing it at good-but-not-comprehensive coverage rather than the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The multi-agent workflow design niche with distinctive triggers ('context bloat', 'unreliable handoffs', 'single-agent vs multi-agent') is mostly distinct. Minor overlap risk remains with general orchestration or software-architecture skills since the triggers are conceptual rather than file-type anchored, keeping it below the 5 anchor.

4 / 5

Total

17

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

alirezarezvani/claude-skills

Path

engineering/skills/agent-workflow-designer/SKILL.md

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.