CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

platform-assistant

Discover and navigate the Anypoint Platform API developer portal to find APIs, agent skills, and schemas. Use when bootstrapping knowledge of the Anypoint Platform, onboarding to the API ecosystem, finding available APIs, understanding the portal structure, resolving URNs, looking up JTBD skills, understanding x-origin dynamic parameters, or planning multi-API workflows.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a well-structured, highly actionable operating manual with concrete URL schemes, filters, and error-recovery guidance. Its main weaknesses are redundant repetition of the raw-HTTP rule across four sections and inline re-explanation of x-origin/JTBD detail that the referenced portal documents already provide.

Suggestions

State the 'use raw HTTP tools, never summarizers' rule once in the Fetching Strategy section and remove the duplicates in the Overview, Tips, and Prerequisites sections.

Trim the inline x-origin and JTBD format walkthroughs to the essentials and point readers earlier to the referenced portal schema/template documents, which already cover the full detail.

Cut obvious troubleshooting causes (e.g., 'Network connectivity issues') and keep only the non-obvious diagnostics such as the exact URN-to-URL mapping rules and valid kind values.

DimensionReasoningScore

Conciseness

The body is mostly efficient and domain-specific, but the "use raw HTTP, never summarizer tools" instruction is repeated four times (Overview's Important note, Fetching Strategy step 1, Tips/Discovery Strategy, and Prerequisites), and some troubleshooting causes ("Network connectivity issues", "Incorrect portal URL") state the obvious. This fits "mostly efficient but includes some unnecessary explanation or could be tightened" better than anchor 4's "minor instances", since the redundancy spans multiple sections.

3 / 5

Actionability

Guidance is fully executable for a navigation skill: exact URL templates ("urn:api:{slug}" resolves to "/apis/{slug}/api.yaml"), concrete registry filters ("kind == 'oas'"), a verbatim x-origin YAML example with JSONPath expressions, a five-step resolution procedure, and explicit GET paths for every fetch. The {portal-url} placeholder is justified by the documented context preamble, so there is no real gap preventing execution.

5 / 5

Workflow Clarity

The x-origin resolution is a clear numbered five-step sequence, skill execution tips give an ordered approach (read full skill first, resolve userProvided inputs early, chain outputs via from.variable), and the Troubleshooting section provides symptom/cause/solution feedback loops for 404s, empty filters, and missing operations. Not a 5 because there is no single end-to-end discovery workflow with explicit validation checkpoints tying the sub-procedures together; not a 3 since error-recovery loops are present and sequences are complete.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so this scores on body structure alone: the skill acts as an overview that defers full detail to one-level-deep, clearly signaled portal documents ("Full schema: {portal-url}/schemas/x-origin.schema.json", "Read AGENTS.md for the full operating manual") with well-organized sections. Not a 5 because the ~90 lines re-explaining x-origin and JTBD formats inline duplicate topics AGENTS.md already covers, which is minor inline content that could live behind the references.

4 / 5

Total

16

/

20

Passed

Description

92%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: concrete capabilities, an explicit multi-scenario "Use when" clause, and a well-defined niche. The only gap is modest synonym coverage (e.g., MuleSoft-adjacent phrasing) in its trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Discover and navigate the Anypoint Platform API developer portal to find APIs, agent skills, and schemas" plus "resolving URNs", "looking up JTBD skills", "understanding x-origin dynamic parameters", and "planning multi-API workflows" — giving comprehensive coverage of the skill's capabilities. Not a 4 because the actions are concrete and enumerative rather than leaving minor gaps; not below since nothing is generic filler.

5 / 5

Completeness

It explicitly answers both questions: the "what" ("Discover and navigate the Anypoint Platform API developer portal to find APIs, agent skills, and schemas") and the "when" via a concrete "Use when..." clause enumerating eight trigger scenarios. This matches the anchor-5 example pattern exactly; the 'when' clause is explicit and multi-trigger, so it cannot be a 4.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases users would say such as "finding available APIs", "onboarding to the API ecosystem", and "planning multi-API workflows". Not a 5 because it misses common synonyms a user might naturally say (e.g., "MuleSoft", "API catalog", "list APIs") and leans on internal jargon (URNs, JTBD, x-origin) that only portal-aware users would voice.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Anypoint Platform portal navigation/discovery) with distinct trigger terms like "resolving URNs" and "x-origin dynamic parameters", so it is unlikely to fire for unrelated skills. A neighboring score would require either overlap risk with similar skills (4) or broad generic scope (3), neither of which applies.

5 / 5

Total

19

/

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/platform-assistant/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.