CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

omni-gateway-diagnose

Diagnose Omni Gateway errors and failures given any combination of log output, dump files, or symptom descriptions. Use when the user reports a gateway error (5xx, 4xx, gateway unreachable, policy not applying), has log output to analyze, needs to decide whether to request debug logs from a customer, or needs to determine whether an issue requires escalation to the gateway team.

72

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

An exemplary triage skill body: symptom-to-action routing tables, concrete escalation criteria with validation gates, and a pre-ticket checklist, all with detail correctly delegated to sibling skills. The only flaw is two redundant intro sentences under the escalation subheadings that restate their headings.

DimensionReasoningScore

Conciseness

Lean, table-driven routing content with zero explanation of concepts Claude already knows — every section is actionable triage data. Two intro lines ("These issues can be resolved without escalating to the gateway team:" and "These issues require gateway team involvement:") merely restate their headings and could be trimmed, matching anchor 4's 'minor instances that could be trimmed' rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

Fully concrete instruction-only guidance: the symptom table pairs each symptom with a specific first check ("spec.address binding", "Listen address (0.0.0.0 vs localhost)", "PolicyBinding → ApiInstance cross-reference") and an exact skill to invoke; escalation criteria are precise ("crash loop, OOMKill", "reproducible after configuration is confirmed valid"); the checklist names concrete artifacts ("flexctl version output", platform list). Per the scoring notes, absence of code is not penalized when guidance is this actionable, and the common cases are all covered.

5 / 5

Workflow Clarity

The diagnostic workflow is clearly sequenced — triage by symptom table, dispatch by available artifact, then escalation decision, then package checklist — with explicit validation gates: escalation is gated on "configuration is confirmed valid by omni-gateway-config", dump analysis is required "before escalating", and the ticket checklist is an explicit pre-flight list. The "Known-good config still failing → live deployed state" row provides an error-recovery path, matching anchor 5's 'checklists + validation steps + feedback loops'.

5 / 5

Progressive Disclosure

The body is a short, well-sectioned overview that delegates all detail via clearly signaled one-level references to sibling skills (omni-gateway-logs, omni-gateway-config, omni-gateway-dump, omni-gateway-install), each referenced with its purpose restated in 'Related Jobs'. No content that belongs in a separate file is inlined, and navigation is trivial — with no bundle files needed, this matches the simple-skill exception for a top score.

5 / 5

Total

19

/

20

Passed

Description

83%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 strong description with an explicit what and a concrete, multi-condition 'Use when' clause anchored to natural symptom language. Its main weaknesses are mild trigger overlap with the sibling log-analysis skill and a few missing common synonyms (specific 5xx codes, connection-refused phrasing).

Suggestions

Add common error-code synonyms to the trigger clause (e.g., 502 Bad Gateway, 504 timeout, connection refused, gateway crash) to broaden natural trigger coverage.

Signal that this skill is the triage entry point for the omni-gateway family (e.g., 'Use first when diagnosing any Omni Gateway issue, before invoking the artifact-specific skills') to reduce trigger overlap with omni-gateway-logs.

DimensionReasoningScore

Specificity

Lists several specific actions — "Diagnose Omni Gateway errors and failures given any combination of log output, dump files, or symptom descriptions", "decide whether to request debug logs from a customer", "determine whether an issue requires escalation" — but does not enumerate the triage-to-sub-skill routing or escalation-package assembly, so coverage has minor gaps (anchor 4, not 3: well beyond 1-2 actions; not 5: not comprehensive).

4 / 5

Completeness

Clearly answers both: what — "Diagnose Omni Gateway errors and failures given any combination of log output, dump files, or symptom descriptions" — and when — an explicit "Use when the user reports a gateway error (5xx, 4xx, gateway unreachable, policy not applying), has log output to analyze, needs to decide whether to request debug logs… or needs to determine whether an issue requires escalation" with concrete trigger phrases. Matches the anchor-5 example pattern exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "gateway error (5xx, 4xx, gateway unreachable, policy not applying)", "log output to analyze", "debug logs", "escalation". A few natural terms users would say are missing, e.g. specific codes like 502/504, "connection refused", "gateway down", so it falls between "good coverage" (4) and "comprehensive with synonyms" (5).

4 / 5

Distinctiveness Conflict Risk

"Omni Gateway" names a clear niche with product-specific triggers, but the trigger "has log output to analyze" overlaps with the sibling omni-gateway-logs skill's own trigger, creating minor overlap risk with a closely related skill (anchor 4). Not 5: the description does not state it is the family's triage entry point, so both skills could plausibly fire on the same input.

4 / 5

Total

17

/

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/omni-gateway/omni-gateway-diagnose/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.