CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-workflow-designer

Use when architecting a multi-step LLM or agent pipeline, choosing single vs multi-agent, or fixing context bloat and broken handoffs. Scaffolds the pattern, handoff contracts and failure handling with workflow_scaffolder.py.

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, token-efficient content with verified executable commands and clean one-level progressive disclosure across a small bundle. The main weaknesses are mild duplication in the capabilities list, no sample scaffold output, and validation steps that name gates without concrete error-recovery loops.

Suggestions

Cut or merge the 'Core Capabilities' section, which mostly restates Quick Start, Recommended Workflow, and Pattern Map, and drop the vague 'Documentation pointers for operational pattern tradeoffs' bullet.

Show a short excerpt of the generated config (e.g., the sequential skeleton with retry policy) after the Quick Start commands so users know what to expect without running the script.

In the Recommended Workflow, point step 3 to the handoff contract field list in references/workflow-patterns.md, and add a concrete feedback step for when dry-run or validation fails.

DimensionReasoningScore

Conciseness

The body is lean with no explanations of concepts Claude already knows, but the 'Core Capabilities' section largely duplicates other sections ('Skeleton config generation' restates Quick Start) and includes vague filler ('Documentation pointers for operational pattern tradeoffs'). Efficient overall with minor padding that could be trimmed, matching anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Quick Start gives executable commands verified against the script's actual CLI (pattern, --name, --output), and Pattern Map provides concrete one-line definitions. Minor gaps: no sample generated output is shown, and 'Define handoff contract fields for every edge' does not surface the contract fields, which live only in references/workflow-patterns.md — mostly executable with small gaps, so 4 rather than 5.

4 / 5

Workflow Clarity

A clear 5-step numbered sequence with validation mentioned ('Add retry/timeouts and output validation gates') and an explicit dry-run checkpoint ('Dry-run with small context budgets before scaling'). Not 5 because checkpoints are abstract rather than concrete commands and there is no feedback loop (what to do when validation or the dry-run fails); comfortably above the implicit-checkpoint anchor 3.

4 / 5

Progressive Disclosure

The body is a genuine overview: pattern summaries inline, with details correctly split into a real, one-level-deep, clearly signaled reference ('Detailed templates: references/workflow-patterns.md') and a real script. Bundle structure confirms clean navigation with no inlined bulk content, matching the top anchor; not 4 since there are no meaningful organization gaps.

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 explicitly covers both what the skill does and when to use it, with natural trigger phrases and third-person voice. Actions are specific if slightly process-level, and the niche is well differentiated from neighboring skills.

DimensionReasoningScore

Specificity

Lists several concrete actions ('architecting a multi-step LLM or agent pipeline', 'choosing single vs multi-agent', 'fixing context bloat and broken handoffs', 'Scaffolds the pattern, handoff contracts and failure handling') with only minor gaps in coverage. Not 5 because the actions are process-level rather than the fully concrete operations of the top anchor; not 3 since well more than 1-2 specific actions are named.

4 / 5

Completeness

Explicitly answers both: 'when' via a concrete 'Use when...' clause with three trigger scenarios (architecting pipelines, choosing single vs multi-agent, fixing context bloat/broken handoffs) and 'what' via 'Scaffolds the pattern, handoff contracts and failure handling with workflow_scaffolder.py'. Clearly matches the top anchor; not 4 because the 'when' is already explicit and specific rather than needing improvement.

5 / 5

Trigger Term Quality

Natural phrases a user would say include 'multi-step', 'pipeline', 'context bloat', 'broken handoffs', and 'single vs multi-agent'. Good coverage, but common synonyms like 'agent orchestration', 'agent workflow', or 'chaining' are missing, keeping it below the comprehensive anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche (multi-agent workflow architecture) with a named tool trigger (workflow_scaffolder.py), giving mostly distinct triggers. Minor overlap risk with general software-architecture or coding-pipeline skills keeps it below the minimal-conflict anchor; it is well above the 'somewhat specific but overlapping' 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.