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
73%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Risky
Do not use without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/workflow-skill-designer/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 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.
| Dimension | Reasoning | Score |
|---|---|---|
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
Total | 10 / 11 Passed | |
5ff5e86
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.