CtrlK
BlogDocsLog inGet started
Tessl Logo

webiny-admin-build-params-catalog

admin/build-params — 3 abstractions.

53

Quality

67%

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/admin/build-params/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 a lean, well-organized API catalog: exact import statements, exact source paths, and an unambiguous lookup workflow with zero wasted tokens. Its only real gap is that it never says what the three abstractions do or how to call them, deferring entirely to the source files.

DimensionReasoningScore

Conciseness

The ~30-line body has zero padding and explains nothing Claude already knows; every line is either a lookup instruction or a catalog entry. This matches anchor 5 — lean, every token earns its place.

5 / 5

Actionability

Each entry gives a copy-paste import statement and an exact source path, and "You MUST read the source file to get the exact interface and types" is concrete direction. Not 5 because no entry states what each abstraction does or shows a usage example; not 3 because the entries are real, executable imports rather than pseudocode.

4 / 5

Workflow Clarity

The three-step sequence (find abstraction → read source → import) is clear and ordered. Anchor 4 fits: the sequence is explicit with a minor gap (nothing past the import step); no validation is needed for this read-only lookup, so the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external bundle files, and is cleanly sectioned ("How to Use", "Abstractions") with detail correctly deferred one level deep to the actual source files. This matches the rubric's simple-skill exception for a 5.

5 / 5

Total

18

/

20

Passed

Description

32%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 terse catalog title rather than a functional description: it names the domain and nothing else. It fails to state any capability, lacks any 'Use when...' trigger guidance, and contains no natural keywords a user would say, making it nearly useless for skill selection even though the domain itself is distinct.

Suggestions

State the actual capabilities concretely, e.g. "Catalogs the BuildParam, BuildParams, and useBuildParams abstractions from Webiny's admin/build-params module with import statements and source file locations."

Add an explicit 'Use when...' clause, e.g. "Use when working with Webiny admin build parameters or importing from webiny/admin/build-params."

Include natural trigger terms and synonyms users would actually say ("build params", "Webiny admin configuration", "useBuildParams") so the description matches real requests.

DimensionReasoningScore

Specificity

"admin/build-params — 3 abstractions" names a concrete domain but states zero actions or capabilities. It fits anchor 2 (names the domain, actions absent) better than anchor 1 because the domain is specific rather than purely abstract.

2 / 5

Completeness

It offers only a vague 'what' (a count of 3 abstractions) and no 'when' at all — exactly anchor 2. The missing 'Use when...' clause caps this dimension at 3 regardless.

2 / 5

Trigger Term Quality

The description is almost entirely technical jargon ("admin/build-params", "abstractions") with no natural user phrases like "build params" usage questions or synonyms. It sits between anchor 1 (only jargon) and anchor 2 (one or two generic keywords).

2 / 5

Distinctiveness Conflict Risk

The specific module path "admin/build-params" carves a clear niche with minimal conflict risk against unrelated skills. Not 5 because no distinct trigger phrasing reinforces the boundary, leaving minor overlap risk with sibling Webiny catalog skills.

4 / 5

Total

10

/

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.