CtrlK
BlogDocsLog inGet started
Tessl Logo

webiny-api-build-params-catalog

api/build-params — 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/build-params/SKILL.md
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.

The body is an exemplary lean reference catalog: it gives exact imports, source paths, and brief descriptions per abstraction, with a clear usage workflow and appropriately deferred detail (source files and pattern skills). Its only weakness is that the consumer must open the source file for actual interfaces, which is a reasonable design tradeoff for a catalog.

DimensionReasoningScore

Conciseness

The body is a lean catalog: a four-step usage list and two terse abstraction entries with import, source, and one-line descriptions. No padding and no explanation of concepts Claude already knows; every token earns its place, matching the anchor-5 example of lean efficiency.

5 / 5

Actionability

It provides copy-paste-ready import statements ("import { BuildParam } from \"webiny/api/build-params\"") and exact source paths ("@webiny/api-core/features/buildParams/index.ts") with an explicit instruction to read the source. However, no type signatures or usage examples are given, leaving minor gaps consistent with anchor 4 rather than the fully self-contained coverage of anchor 5.

4 / 5

Workflow Clarity

This is a simple, single-purpose lookup skill under 50 lines, and the 'How to Use' sequence (find the abstraction, read the source, import it, consult the pattern skills) is unambiguous with clearly signaled next steps. No destructive or batch operations exist, so no validation checkpoints are required; per the simple-skill note this warrants a 5.

5 / 5

Progressive Disclosure

The content is short, organized into clear 'How to Use' and 'Abstractions' sections, with nothing inlined that belongs in a separate file. The only cross-references (the two pattern skills) are one level deep and clearly signaled, and no bundle files exist or are needed at this size.

5 / 5

Total

19

/

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 effectively a title, not a description: it names the module and counts its abstractions but communicates no capabilities, no use cases, and no trigger conditions. It would rarely be selected correctly because nothing in it tells Claude when to reach for this skill.

Suggestions

Add a 'Use when...' clause with natural trigger phrases, e.g. 'Use when the user asks about build-time parameters or configuration in Webiny APIs'.

State what the skill actually provides as concrete actions, e.g. 'Lists the BuildParam and BuildParams abstractions with import paths and source locations for Webiny build-time configuration'.

Include natural keywords and synonyms users would say (build params, build-time config, environment parameters) rather than only the technical module path.

DimensionReasoningScore

Specificity

The description names the domain ("api/build-params") and counts "2 abstractions" but lists no concrete actions or capabilities whatsoever, matching the anchor 'Names the domain but actions are minimal or generic'. It is not purely abstract language (ruling out 1), and it falls well short of the 1-2 concrete actions required for 3.

2 / 5

Completeness

The 'what' is only weakly implied (a catalog of 2 abstractions for a module) and there is no 'when' guidance at all. This fits anchor 2 ('Has a vague what and no when'); it is below 3 because even the 'what' is never stated as a capability.

2 / 5

Trigger Term Quality

The entire description is a technical module path and an abstraction count; there are no natural keywords or phrases a user would say when needing this skill. This matches anchor 1 ('only technical jargon'); it does not even reach the 'one or two generic keywords' of anchor 2.

1 / 5

Distinctiveness Conflict Risk

"api/build-params" is a fairly specific module path, giving it some distinction, but the terse description provides no differentiating triggers and it could overlap with sibling webiny catalog skills or generic build-parameter/config requests. Somewhat specific but overlap remains, matching anchor 3.

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.