**UTILITY SKILL** — Machine-readable workflow DAG for the multi-step agent pipeline. Defines node types, edge conditions, gates, and fan-out patterns. WHEN: "orchestrator step routing", "resume from graph", "workflow validation", "workflow DAG", "workflow gate", "fan-out pattern". USE FOR: orchestrator step routing, resume-from-graph, workflow validation. DO NOT USE FOR: Azure infrastructure, code generation, troubleshooting.
62
72%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/skills/workflow-engine/SKILL.mdQuality
Discovery
75%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 well-structured with explicit WHEN, USE FOR, and DO NOT USE FOR clauses, making it strong on completeness and distinctiveness. However, the specific capabilities listed are somewhat abstract (defining node types, edge conditions) rather than concrete user-facing actions, and the trigger terms lean heavily on technical jargon that may not match natural user language.
Suggestions
Replace abstract structural descriptions with concrete actions users would request, e.g., 'Creates and validates workflow DAGs, routes orchestrator steps between nodes, resumes pipeline execution from checkpoints.'
Add more natural-language trigger term variations such as 'pipeline steps,' 'task orchestration,' 'workflow graph,' 'step dependencies,' or 'execution flow' to improve matching with how users actually phrase requests.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (workflow DAG for multi-step agent pipeline) and mentions some actions like 'Defines node types, edge conditions, gates, and fan-out patterns,' but these are more structural definitions than concrete user-facing actions. It doesn't list specific operations like 'create DAG nodes,' 'validate workflow edges,' or 'resume execution from checkpoint.' | 2 / 3 |
Completeness | The description clearly answers both 'what' (machine-readable workflow DAG defining node types, edge conditions, gates, fan-out patterns) and 'when' (explicit WHEN clause with trigger phrases, USE FOR clause, and even a DO NOT USE FOR exclusion clause). This is a well-structured skill selection guide. | 3 / 3 |
Trigger Term Quality | It includes several trigger terms like 'orchestrator step routing,' 'workflow DAG,' 'workflow gate,' 'fan-out pattern,' and 'resume from graph,' but these are fairly technical/jargon-heavy. A user might naturally say 'workflow' or 'DAG' but terms like 'orchestrator step routing' and 'fan-out pattern' are niche. Missing more natural variations like 'pipeline steps,' 'workflow graph,' or 'task orchestration.' | 2 / 3 |
Distinctiveness Conflict Risk | The description carves out a clear niche around workflow DAGs and agent pipeline orchestration, with explicit exclusions for Azure infrastructure, code generation, and troubleshooting. The combination of 'workflow DAG,' 'gate,' and 'fan-out pattern' creates a distinct trigger profile unlikely to conflict with other skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
70%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill has strong workflow clarity and excellent progressive disclosure with well-organized reference tables. Its main weaknesses are the duplicated orchestrator routing protocol (appearing twice in nearly identical form) and the lack of concrete executable examples or schema snippets from the workflow-graph.json. Trimming the redundancy and adding a minimal JSON schema example would significantly improve the skill.
Suggestions
Remove the duplicated routing protocol — keep either the 'Steps' section or the 'Reading the Graph' section, not both, to improve conciseness.
Include a minimal example snippet of workflow-graph.json showing one node, one edge, and one gate to make the skill more actionable without requiring the reader to find the full file.
Remove the explanation 'The workflow is a Directed Acyclic Graph (DAG): nodes, edges...' from Core Concepts since this repeats what's already stated in Rules and is basic knowledge for Claude.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content has significant redundancy: the orchestrator routing protocol is described nearly identically in both the 'Steps' section (8 steps) and the 'Reading the Graph' section (7 steps). The 'Core Concepts' section also repeats information already covered in 'Rules'. Some explanations like 'The workflow is a Directed Acyclic Graph (DAG)' are unnecessary given Claude already knows what a DAG is. | 2 / 3 |
Actionability | The skill provides specific commands (e.g., `apex-recall show <project> --json`, `npm run validate:_node`) and references concrete file paths, which is good. However, there's no executable code — the routing protocol is described in prose/pseudocode rather than showing actual implementation. The workflow-graph.json structure is never shown, making it hard to act on without seeing the schema. | 2 / 3 |
Workflow Clarity | The multi-step orchestrator routing protocol is clearly sequenced with explicit status checks (complete/in_progress/pending/skipped), conditional branching (IaC routing), gate blocking behavior, and fan-out handling. Validation is explicitly enforced at three named checkpoints with specific scripts and scopes documented in a table. | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with a well-organized Reference Index table pointing to one-level-deep references (dag-concepts.md, schema-evolution.md, orchestrator-handoff-guide.md, etc.). The validation surfaces are cleanly separated into their own table. Navigation is straightforward and references are clearly signaled. | 3 / 3 |
Total | 10 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
05d7617
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.