CtrlK
BlogDocsLog inGet started
Tessl Logo

webiny-api-opensearch-catalog

api/opensearch — 10 abstractions.

48

Quality

61%

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/user-skills/generated/api/opensearch/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 an efficient, well-structured abstraction catalog with concrete import lines and source pointers. Its main gaps are the absence of any usage example and an unresolved instruction to 'read the source file' without stating where those files live.

DimensionReasoningScore

Conciseness

The body is a lean, data-dense catalog: a 4-step usage section plus ten 3-line entries (Name/Import/Source) with zero padding and no explanation of concepts Claude already knows — every token earns its place.

5 / 5

Actionability

Each entry gives a copy-paste-ready import statement and a concrete source path, which is mostly executable guidance; minor gaps keep it below 5 — no usage example and step 2's 'read the source file' does not say where the '@webiny/...' paths resolve.

4 / 5

Workflow Clarity

The sequence (find abstraction → read source → import → consult pattern skills) is clear and unambiguous for this simple, non-destructive lookup task. It falls between anchors 4 and 5: no validation is needed, but the 'read the source' step leaves a minor gap about locating the referenced files, so 4 fits better than 5.

4 / 5

Progressive Disclosure

Well-organized sections with a compact inline catalog and clearly signaled one-level references to sibling pattern skills; no bundle files exist to verify. It falls just short of anchor 5 because the ten catalog entries could plausibly live in a separate reference file and navigation between them relies on visual scanning rather than a structured index.

4 / 5

Total

17

/

20

Passed

Description

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

The description is a bare catalog label: it names the domain and an entry count but provides no capabilities, no usage triggers, and no natural keywords. It would rarely fire when a user actually needs it.

Suggestions

Add a 'Use when...' clause naming concrete trigger situations, e.g. 'Use when building OpenSearch-backed queries or indexes in a Webiny project, or when the user mentions opensearch, search indexes, or query builders.'

State 1-3 concrete capabilities instead of an entry count, e.g. 'Catalogs 10 abstractions for creating OpenSearch clients, defining index fields, building query operators, and registering indexes.'

Include natural trigger terms and synonyms users would say (opensearch, search index, query builder) rather than only the technical package path 'api/opensearch'.

DimensionReasoningScore

Specificity

The description only states "api/opensearch — 10 abstractions" — it names the domain but contains no action verbs or capability statements whatsoever, sitting between anchor 1 (entirely vague) and anchor 2 (domain named, actions minimal).

2 / 5

Completeness

The 'what' is only a vague domain label and there is no 'Use when...' clause or equivalent trigger guidance (which caps completeness at 3); this fits anchor 2 — vague what, no when. It cannot score 3 because the 'what' is not clear, and not 1 because the domain is explicitly named.

2 / 5

Trigger Term Quality

It consists purely of technical jargon ("api/opensearch", "abstractions") with no natural phrases a user would say, closely matching the anchor-1 example "Handles document object model manipulation".

1 / 5

Distinctiveness Conflict Risk

"opensearch" denotes a fairly specific niche, but the bare catalog phrasing could still overlap with sibling Webiny api/* catalog skills, matching anchor 3; it is not distinct enough for 4-5 because no differentiating triggers are given.

3 / 5

Total

8

/

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
webiny/webiny-js
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.