CtrlK
BlogDocsLog inGet started
Tessl Logo

workflow-skill-designer

Meta-skill for designing orchestrator+phases structured workflow skills. Creates SKILL.md coordinator with progressive phase loading, TodoWrite patterns, and data flow. Triggers on "design workflow skill", "create workflow skill", "workflow skill designer".

62

Quality

73%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/workflow-skill-designer/SKILL.md
SKILL.md
Quality
Evals
Security

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 a strong description that clearly communicates a specific, niche capability (designing structured workflow skills) with concrete actions (creating SKILL.md coordinators, progressive phase loading, TodoWrite patterns, data flow). It includes explicit trigger terms and is highly distinctive. The only minor weakness is that the trigger guidance uses 'Triggers on' rather than the more conventional 'Use when' phrasing, but it still effectively communicates when to select this skill.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'designing orchestrator+phases structured workflow skills', 'Creates SKILL.md coordinator with progressive phase loading, TodoWrite patterns, and data flow'. These are concrete, specific capabilities.

3 / 3

Completeness

Clearly answers both what ('Meta-skill for designing orchestrator+phases structured workflow skills. Creates SKILL.md coordinator with progressive phase loading, TodoWrite patterns, and data flow') and when ('Triggers on "design workflow skill", "create workflow skill", "workflow skill designer"').

3 / 3

Trigger Term Quality

Includes explicit trigger phrases that users would naturally say: 'design workflow skill', 'create workflow skill', 'workflow skill designer'. Also includes domain-specific terms like 'orchestrator', 'phases', 'TodoWrite patterns' that help distinguish it.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche — a meta-skill specifically for designing workflow skills with orchestrator+phases patterns. The trigger terms are very specific ('workflow skill designer') and unlikely to conflict with general coding or document skills.

3 / 3

Total

12

/

12

Passed

Implementation

47%

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

This is a comprehensive meta-skill for designing workflow skills, with excellent workflow clarity and a well-thought-out phase structure. However, it suffers significantly from verbosity — Pattern 9 alone is excessively detailed with redundant Chinese/English explanations, and the templates repeat information from the patterns section. The actionability is moderate: while structural guidance is strong, the code examples are illustrative rather than executable.

Suggestions

Reduce Pattern 9 (Compact Recovery) by ~60% — consolidate the dual-language explanations and remove redundant tables/diagrams that restate the same concept

Move the SKILL.md Template and Phase File Template sections into separate reference files (e.g., templates/skill-template.md and templates/phase-template.md) to reduce SKILL.md size

Replace pseudocode examples (like the AskUserQuestion JavaScript) with either real executable code or remove them entirely, since Claude can infer implementation from the pattern description

Consolidate the Orchestrator Content Mapping tables — the SKILL.md vs Phase Files distinction is stated multiple times across different sections and could be a single concise table

DimensionReasoningScore

Conciseness

Extremely verbose at ~400+ lines. Extensive repetition of patterns (Pattern 9 alone spans ~100 lines with redundant explanations in Chinese and English). Explains concepts Claude already knows (what orchestrators are, what phase files are). The ASCII diagrams, while useful, are duplicated in concept across multiple sections. Templates repeat information already covered in the patterns section.

1 / 3

Actionability

Provides templates and structural patterns that are somewhat actionable, but the code examples are pseudocode/illustrative rather than executable (e.g., the AskUserQuestion JavaScript snippet isn't real API code). The templates give good structure but lack concrete, copy-paste-ready implementations. The mapping tables are helpful but describe what to do rather than showing exact execution.

2 / 3

Workflow Clarity

The 4-phase execution flow is clearly sequenced with explicit inputs/outputs per phase. Validation is covered in Phase 4 and the Design Decision Framework provides a systematic checklist. The compact recovery pattern includes explicit checkpoints and verification steps. The TodoWrite attachment/collapse lifecycle is well-defined with clear state transitions.

3 / 3

Progressive Disclosure

References 4 phase files (phases/01-04) which is good progressive disclosure structure, but no bundle files are provided so we can't verify they exist. The SKILL.md itself is monolithic — Pattern 9 (Compact Recovery) alone could be its own reference document. The templates section duplicates pattern content and should be separated. Too much detail is inline rather than delegated to the phase files.

2 / 3

Total

8

/

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

10

/

11

Passed

Repository
catlog22/Claude-Code-Workflow
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.