CtrlK
BlogDocsLog inGet started
Tessl Logo

workflow-engine

**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

Quality

72%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/workflow-engine/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jonathan-vella/azure-agentic-infraops
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.