CtrlK
BlogDocsLog inGet started
Tessl Logo

webiny-api-logger-catalog

api/logger — 1 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/logger/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 minimal catalog: token-efficient, well-structured, with concrete import statements, real source paths, and an unambiguous usage workflow. Its only weakness is the absence of any usage example for the cataloged abstraction, which leaves actionability just short of fully copy-paste ready.

DimensionReasoningScore

Conciseness

The body is a lean 26-line catalog: a 4-step usage flow ('Find the abstraction you need below', 'You MUST read the source file to get the exact interface and types!') and one compact entry per abstraction. No padding, no concepts Claude already knows — every token earns its place, matching anchor 5.

5 / 5

Actionability

Provides a concrete executable import ('import { Logger } from "webiny/api/logger"'), a real source path ('@webiny/api-core/features/logger/index.ts'), and a generic template ('import { Name } from "<importPath>"'). Mostly executable guidance with minor gaps — there is no usage example of the Logger API itself, so it falls short of anchor 5's 'specific examples cover the common cases'.

4 / 5

Workflow Clarity

The 'How to Use' section lists a clear, unambiguous 4-step sequence (find abstraction, read source, import, consult pattern skills). This is a simple read-only lookup skill with no destructive or batch operations, so the validation cap does not apply and the sequence is fully coherent, matching the simple-skill exception for a 5.

5 / 5

Progressive Disclosure

Under 50 lines with well-organized sections ('How to Use', 'Abstractions') and no bundle files to reference. The pointers to sibling skills ('webiny-use-case-pattern', 'webiny-event-handler-pattern') and the repo source path are one level deep and clearly signaled, fitting the guideline that sub-50-line skills with no external references can score 5 on organization alone.

5 / 5

Total

19

/

20

Passed

Description

20%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: a module path and an abstraction count. It fails to state any capability, includes no trigger guidance, and offers no natural search terms beyond the jargon path itself. It is distinguishable only by its module name, not by what it does or when to use it.

Suggestions

State the capability in third person with concrete actions, e.g. 'Catalogs the Logger abstraction from Webiny's api/logger module: import paths, source locations, and structured logging levels.'

Add an explicit 'Use when...' trigger clause, e.g. 'Use when implementing logging in a Webiny project or when the user mentions Webiny api/logger, structured logging, or log levels.'

Include natural user-facing keywords such as 'logging', 'log messages', 'log levels', and 'Webiny' so the skill matches how users actually phrase the need.

DimensionReasoningScore

Specificity

The description names a precise domain ("api/logger") but states zero concrete actions — no verbs at all. It sits between anchor 1 ('no concrete actions', e.g. 'Helps with documents') and anchor 2 ('names the domain but actions are minimal', e.g. 'Processes PDF files'), which at least names a generic action.

2 / 5

Completeness

Neither a 'what' (only a label and count, no capability statement) nor a 'when' (no 'Use when...' clause or equivalent trigger guidance). Matches anchor 1 — both what and when are missing or extremely vague, and the missing-trigger guideline would cap completeness at 3 regardless.

1 / 5

Trigger Term Quality

The only keywords are technical jargon — the module path "api/logger" and "abstractions" — with none of the natural phrases a user would say when needing logging ("logging", "log messages", "log levels"). Slightly above anchor 1 because the path does contain 'logger', but far below the natural-term coverage of anchors 3-5.

2 / 5

Distinctiveness Conflict Risk

"api/logger" is a specific Webiny module path, which distinguishes it from unrelated skills, but sibling catalog skills likely share the identical '— N abstractions' shape and users asking for logging would not naturally say the module path. Fits anchor 3: 'somewhat specific but could still overlap with similar skills'.

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.