CtrlK
BlogDocsLog inGet started
Tessl Logo

webiny-api-key-value-store-catalog

api/key-value-store — 2 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/api/key-value-store/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: structured records with concrete import paths and source locations, no filler, and a clear usage sequence. Its only weakness is that it delegates all type/method detail to the source file without locating that file precisely or showing a single usage example, which slightly limits copy-paste actionability. The linked sibling skills are referenced by name only and cannot be verified within this bundle.

Suggestions

Clarify how to locate the source file, e.g., prefix the path with the repo root or a glob ("@webiny/api-core/features/keyValueStore/index.ts in the webiny monorepo"), since both abstractions share one file.

Add one minimal inline usage snippet per abstraction (e.g., getting a store instance) so the common case is copy-paste ready without opening the source.

State the distinction between the two abstractions more operationally (when to pick GlobalKeyValueStore vs tenant-scoped KeyValueStore), or link to the pattern skill that covers that decision.

DimensionReasoningScore

Conciseness

The body is ~25 lines of pure signal: a short usage list, then four factual fields (Name, Import, Source, Description) per abstraction. Nothing explains concepts Claude already knows, no padding, every token earns its place — a direct match for the 'Lean and efficient' anchor.

5 / 5

Actionability

Each abstraction provides a copy-paste-ready import statement ("import { GlobalKeyValueStore } from \"webiny/api/key-value-store\"") and a concrete source path, plus the explicit instruction to read the source for exact types. It is mostly executable with a minor gap: no method signatures or usage examples, so a small trip to the source file is required — fits anchor 4, not 5, whose common cases are fully covered inline.

4 / 5

Workflow Clarity

The four numbered steps (find abstraction → read source → import → consult pattern skills) form a clear, coherent sequence appropriate to a simple catalog skill; nothing here is destructive or batch, so no validation checkpoint is required. Minor gaps keep it at 4 rather than 5: step 2 does not say where/how to locate the source file (the paths are repo-relative and both entries share one), and no fallback guidance is given if an abstraction is not listed.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external reference files, and it uses well-organized sections ('How to Use', 'Abstractions') with per-abstraction records — exactly the simple-skill case the guideline allows to score 5 with just well-organized structure. The pointers it does contain (source files, sibling pattern skills) are one level deep and clearly signaled.

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 essentially a bare catalog label: a domain path and an item count with no stated capabilities and no trigger guidance. It avoids fluff and is highly concise, but it fails to tell Claude what the skill does or when to invoke it, which will hurt automatic triggering. Adding one sentence of concrete actions plus a 'Use when...' clause would move it into good-example territory.

Suggestions

State concrete capabilities, e.g., 'Catalogs the GlobalKeyValueStore and KeyValueStore abstractions in webiny's api/key-value-store package, with import paths and source file locations for each.'

Add a trigger clause: 'Use when working with webiny key-value stores, per-tenant vs global storage, or when importing from "webiny/api/key-value-store".'

Include natural synonyms users would actually say (KV store, key-value storage, tenant-scoped store) rather than only the technical package path.

DimensionReasoningScore

Specificity

The description names the domain ("api/key-value-store") but the only additional content is a count ("2 abstractions") — no concrete actions or capabilities are described at all. It matches the anchor 'Names the domain but actions are minimal or generic'; not 1 because the domain is named specifically rather than being pure abstract language, and not 3 because no concrete action (catalog, list, lookup, etc.) is ever stated.

2 / 5

Completeness

The 'what' is only weakly implied (a count of abstractions, not what the skill does) and the 'when' is entirely absent — no 'Use when...' clause or equivalent trigger guidance. Per the judging guidelines a missing 'Use when' clause caps completeness at 3; this fits anchor 2 ('Has a vague what and no when') and not 3, which requires a clear 'what'.

2 / 5

Trigger Term Quality

"key-value store" is a somewhat relevant keyword, but it appears only as a technical path fragment ("api/key-value-store"), and terms like "abstractions" are pure technical jargon — no natural phrases a user would say (e.g., "key-value store", "store a value", "KV store", "webiny"). It sits between anchor 1 ('only technical jargon') and anchor 3 ('some relevant keywords but missing common variations'); noticeably below the midpoint, so 2.

2 / 5

Distinctiveness Conflict Risk

"api/key-value-store" carves out a clear niche within the webiny ecosystem, so it is mostly distinct with only minor overlap risk against closely related webiny api catalog skills. Not 5 because the lack of any trigger phrasing means distinguishing it from sibling skills relies entirely on the path name; not 3 because the named domain is narrow and specific rather than broad.

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.