CtrlK
BlogDocsLog inGet started
Tessl Logo

workflows

Framework for building durable workflows with orchestrated activities, used for background jobs, multi-step pipelines, scheduled tasks, LLM agents, or any process requiring fault tolerance, retries, and long-running execution. This skill provides comprehensive documentation and guidance for working with the Mistral Workflows framework.

53

1.21x
Quality

27%

Does it follow best practices?

Impact

100%

1.21x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./template/.agents/skills/workflows/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 identifies the domain and lists relevant use cases but lacks concrete actions Claude would perform and entirely omits explicit trigger guidance ('Use when...'). The phrase 'provides comprehensive documentation and guidance' is vague filler that doesn't help Claude decide when to select this skill. The 'Mistral Workflows' name provides some distinctiveness, but the description would benefit significantly from explicit triggers and more specific capability statements.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about Mistral Workflows, building durable workflows, or needs help with workflow activities, retries, or scheduled task orchestration.'

Replace 'provides comprehensive documentation and guidance' with specific actions like 'Generates workflow definitions, configures activity retries, sets up scheduled triggers, and implements fault-tolerant multi-step pipelines.'

Include natural user trigger terms such as 'workflow orchestration', 'job queue', 'cron', 'retry logic', 'long-running tasks', and file/framework-specific terms users might mention.

DimensionReasoningScore

Specificity

The description names the domain (durable workflows) and lists several use cases (background jobs, multi-step pipelines, scheduled tasks, LLM agents), but doesn't describe concrete actions the skill performs—it says it 'provides comprehensive documentation and guidance' which is vague about what Claude actually does with it.

2 / 3

Completeness

The description addresses 'what' (framework for building durable workflows) but completely lacks an explicit 'when should Claude use it' clause. There is no 'Use when...' or equivalent trigger guidance, which per the rubric should cap completeness at 2, and since the 'what' is also somewhat vague ('provides comprehensive documentation and guidance'), this falls to 1.

1 / 3

Trigger Term Quality

Includes some relevant keywords like 'workflows', 'background jobs', 'pipelines', 'scheduled tasks', 'retries', 'fault tolerance', and 'Mistral Workflows', but misses common user phrasings and variations. Terms like 'durable workflows' and 'orchestrated activities' are more technical jargon than natural user language.

2 / 3

Distinctiveness Conflict Risk

The mention of 'Mistral Workflows framework' specifically helps distinguish it from generic workflow tools, but terms like 'background jobs', 'multi-step pipelines', and 'scheduled tasks' could overlap with other task queue or workflow orchestration skills (e.g., Celery, Temporal, etc.).

2 / 3

Total

7

/

12

Passed

Implementation

22%

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

This skill functions primarily as a documentation index/table of contents rather than an actionable skill. While the reference organization is reasonable, the file is bloated with sections that explain obvious concepts ('When to Use This Skill', 'Key Features', 'About Workflows') that waste tokens without adding value. The only genuinely actionable content is the testing quick-script command and timeout table; the rest provides no concrete guidance Claude could act on without consulting the referenced files.

Suggestions

Remove the 'About Workflows', 'When to Use This Skill', and 'Key Features' sections entirely — they explain concepts Claude can infer from the documentation structure and add ~40 lines of zero-value content.

Add a 'Quick Start' section with a minimal executable workflow example (decorator usage, activity definition, worker setup) so Claude can act immediately without consulting references.

Add a workflow/decision tree for common tasks: e.g., 'To add a new activity: 1. Define function with @activity decorator 2. Configure retries 3. Register in worker 4. Test with test_workflow.py script 5. Validate output'.

Consolidate the reference links into a more compact format (e.g., a simple categorized list without descriptions that repeat the link title) to reduce token usage.

DimensionReasoningScore

Conciseness

The content is heavily padded with information Claude already knows or can infer. The 'About Workflows' section explains what an orchestration framework is, the 'When to Use This Skill' section lists obvious use cases, and the 'Key Features' section repeats information already covered in the documentation links. The bulk of the file is a table of contents with brief descriptions that largely duplicate what the link titles already convey.

1 / 3

Actionability

The testing section provides a concrete executable command with a useful timeout table, which is genuinely actionable. However, the rest of the skill is purely navigational — it tells Claude where to find information rather than providing any executable guidance, code patterns, or specific instructions for common tasks.

2 / 3

Workflow Clarity

There is no clear workflow or sequenced process for how to approach building or debugging workflows. The skill is essentially a documentation index without any guidance on what order to consult references, how to validate work, or what steps to follow for common tasks. The testing section has some workflow elements but the overall skill lacks sequenced processes with validation checkpoints.

1 / 3

Progressive Disclosure

The documentation is well-organized into categories with clear one-level-deep references to specific guide files, which is good. However, without bundle files to verify the references exist, and given that the SKILL.md itself contains substantial inline content that adds little value (feature lists, use case lists) while the actual actionable content is entirely deferred to references, the balance between overview and delegation is off.

2 / 3

Total

6

/

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
mistralai/workflows-starter-app
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.