CtrlK
BlogDocsLog inGet started
Tessl Logo

webiny-api-languages-catalog

api/languages — 2 abstractions.

52

Quality

65%

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/languages/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 exemplary lean catalog: minimal, well-structured, with copy-paste import statements and exact source-file pointers for each abstraction. Its only weaknesses are the vague cross-skill pointer and the absence of a minimal usage example beyond the import line.

DimensionReasoningScore

Conciseness

The body is pure metadata: a 4-step usage list plus Name/Import/Source/Description tuples for two abstractions. Nothing Claude already knows is re-explained and every line earns its place, matching the lean anchor 5.

5 / 5

Actionability

It gives copy-paste-ready import statements ('import { GetLanguageByCodeUseCase } from "webiny/api/languages"') and exact source paths to read. It falls short of anchor 5 because beyond the import line there is no executable usage example — it defers entirely to 'You MUST read the source file', leaving a minor gap.

4 / 5

Workflow Clarity

A clear 4-step 'How to Use' sequence (find → read source → import → see pattern skills) covers this single-purpose lookup skill; it is read-only so no validation cap applies. It misses anchor 5 because the pointer to 'webiny-use-case-pattern or webiny-event-handler-pattern' skills is vague and not resolvable within the bundle.

4 / 5

Progressive Disclosure

The skill is under 50 lines, has no bundle files, and is cleanly organized into 'How to Use' and 'Abstractions' sections with per-entry metadata. Per the rubric's simple-skill guideline, well-organized sections alone warrant a 5, and the per-abstraction Source pointers are one level deep.

5 / 5

Total

18

/

20

Passed

Description

28%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 extremely terse and names a real module but tells the model almost nothing: no concrete capabilities, no natural trigger terms, and no 'Use when' guidance. It functions as a bare index label rather than a description that would cause the skill to be discovered or correctly selected.

Suggestions

List the concrete capabilities, e.g., 'Get a language entry by its code or list all language entries via the Webiny api/languages use cases.'

Add an explicit trigger clause, e.g., 'Use when working with Webiny multilingual/language features, language codes, or importing from webiny/api/languages.'

Include natural trigger keywords and synonyms users would actually say — 'language', 'language code', 'locale', 'list languages' — rather than only the module path and the word 'abstractions'.

DimensionReasoningScore

Specificity

The description 'api/languages — 2 abstractions.' names a concrete domain and a count but lists zero actions. It is more specific than the purely abstract anchor 1, but with no actions at all it cannot reach anchor 3, which requires 1-2 concrete actions.

2 / 5

Completeness

The 'what' is only weakly stated (a catalog of 2 abstractions in api/languages) and there is no 'Use when...' trigger guidance, which caps completeness at 3. Anchor 2 ('has a vague what and no when') fits exactly; it is not a 1 because some what-information is present.

2 / 5

Trigger Term Quality

The only terms are 'api/languages' and 'abstractions' — an internal module path and jargon rather than natural phrases a user would say (e.g., 'get a language by code', 'list languages'). This matches anchor 2: one or two keywords present but the natural trigger phrases users actually say are missing.

2 / 5

Distinctiveness Conflict Risk

Scoping to the 'api/languages' module gives it a somewhat specific niche, but the generic 'N abstractions' catalog pattern is shared with sibling Webiny api skills, so it could overlap with similar skills. Better than anchor 2's very-broad overlap risk, but not distinct enough for anchor 4.

3 / 5

Total

9

/

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.