CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

update-mule-run-config

Call use_skill as your FIRST and ONLY action when the user asks to EDIT, UPDATE, MODIFY, or CHANGE an EXISTING run configuration for Mule applications. Use this ONLY for modifying configurations that already exist, NOT for creating new ones. Trigger phrases include "edit config", "update config", "modify config", "change config". When you call use_skill, it must be the only tool call in that response.

58

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/mule-development/update-mule-run-config/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

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

A highly actionable, well-sequenced operational guide with strong error-recovery paths and concrete tool-call templates. Its weaknesses are redundancy (duplicated near-identical code blocks and repetitive examples) and a monolithic single-file layout where examples and matching heuristics should be split into a reference file.

Suggestions

Consolidate the near-identical list/update/execute code blocks into one template each, noting "include `projectPath` when scope is 'project'" — this alone would cut ~40 lines.

Move the six Example Conversations into a references/examples.md file and keep 1-2 inline, improving both conciseness and progressive disclosure.

Fix the structural errors: remove the redundant "## Step-by-Step Process" heading above "## Step 1" (or demote steps to H3), and renumber the duplicated "5." item in Step 2's list.

DimensionReasoningScore

Conciseness

Everything is operational with no concept teaching, but there is clear tightening potential: three near-identical `list` blocks in Step 4, twin `update`/`execute` blocks in Steps 7-8 differing only by `scope`, and six example conversations (~130 lines) all ending with the same "Would you like to run this configuration now?" pattern. This matches anchor 3 ("mostly efficient but... could be tightened") rather than anchor 2, since no padding explains things Claude already knows.

3 / 5

Actionability

The body provides concrete parameterized tool-call templates (e.g., `{"operation": "update", "configName": string, "scope": "workspace", ...}`), exact user-facing message templates, and copy-ready disambiguation dialogs. Minor gaps keep it below anchor 5: the list operation's tool name is never stated ("Call the list tool" shows only a params object), and matching is hand-waved as "Use Levenshtein distance or similar algorithm".

4 / 5

Workflow Clarity

The 8-step sequence is clear with genuine recovery checkpoints (duplicate configs, not-found suggestions, empty-list handling, stale-project warnings, "use the EXACT name from the update response"). Minor structural sloppiness — a "## Step-by-Step Process" heading immediately followed by a same-level "## Step 1" heading, and two list items numbered "5" in Step 2 — introduces slight navigational confusion, matching anchor 4 rather than 5.

4 / 5

Progressive Disclosure

The skill is a ~420-line monolithic file with no external references at all: no references/, scripts/, or assets/ exist, and the 130-line Example Conversations section plus the matching heuristics are natural candidates for a separate reference file. This matches anchor 3 ("content that should be separate is inline") — the under-50-line exception does not apply at this size.

3 / 5

Total

14

/

20

Passed

Description

68%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A distinctive, well-triggered description with explicit boundary guidance and concrete trigger phrases. Its weaknesses are the thin statement of concrete capabilities (what aspects of a config can be changed is left unstated) and the second-person voice, which the rubric penalizes.

Suggestions

Rewrite the description in third person (e.g., "Updates existing Mule run configurations — renaming, changing included projects, or toggling run/debug mode") to both fix the voice penalty and enumerate the concrete capabilities.

Add natural trigger synonyms users would say, such as "rename config" or "switch to debug mode", to close the trigger-term gap.

DimensionReasoningScore

Specificity

The description lists essentially one action with synonyms ("EDIT, UPDATE, MODIFY, or CHANGE an EXISTING run configuration") rather than several concrete capabilities — it never states what can be changed (name, projects, run/debug mode), fitting anchor 3. It is written in second person ("When you call use_skill, it must be the only tool call in that response"), which the guidelines penalize by reducing specificity by 1, yielding 2.

2 / 5

Completeness

Both 'what' ("EDIT, UPDATE, MODIFY, or CHANGE an EXISTING run configuration for Mule applications") and 'when' (explicit trigger phrases plus "Use this ONLY for modifying configurations that already exist, NOT for creating new ones") are present. The 'what' could enumerate the changeable aspects (name, projects, mode), so it falls just short of the anchor-5 exemplar.

4 / 5

Trigger Term Quality

Explicit natural trigger phrases ("edit config", "update config", "modify config", "change config") are exactly what users would say. Missing common variations such as "rename config" or "make it debug" keeps it below the comprehensive-coverage anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche ("run configuration for Mule applications") with an explicit exclusion boundary ("NOT for creating new ones") gives minimal conflict risk with other skills, matching the anchor-5 clear-niche example.

5 / 5

Total

15

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

mulesoft/mulesoft-dx

Path

skills/mule-development/update-mule-run-config/SKILL.md

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.