CtrlK
BlogDocsLog inGet started
Tessl Logo

webiny-api-graphql-catalog

api/graphql — 7 abstractions.

49

Quality

53%

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

Quality

Content

100%

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 well-structured, token-efficient catalog: a clear usage workflow followed by concise, copy-paste-ready import and source entries. It appropriately defers detail to source files and pattern skills rather than duplicating it inline.

DimensionReasoningScore

Conciseness

The body is lean and direct: a four-step 'How to Use' list plus seven terse four-line entries with no explanation of concepts Claude already knows, matching the score-3 anchor of every token earning its place.

3 / 3

Actionability

Each entry gives a copy-paste-ready import statement and an exact source path, and the instructions explicitly direct reading the source for interfaces; this matches the score-3 anchor of fully executable, copy-paste-ready guidance.

3 / 3

Workflow Clarity

The numbered 'How to Use' sequence (find abstraction, read source, import, consult pattern skills) is clear and unambiguous for a simple catalog skill with no destructive or batch operations, so it meets the score-3 bar per the simple-skills note.

3 / 3

Progressive Disclosure

Under 50 lines with well-organized sections and no bundle files to traverse; outward pointers to source files and pattern skills are clearly signaled one level deep, matching the score-3 anchor.

3 / 3

Total

12

/

12

Passed

Description

7%

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 frontmatter description is far too terse: it identifies a domain and an abstraction count but conveys no actions, no natural trigger terms, and no use-when guidance. It reads as an internal label rather than a user-facing capability statement.

Suggestions

Replace 'api/graphql — 7 abstractions' with concrete actions, e.g. 'Build GraphQL APIs with Webiny: define schema extensions and return error, list, not-found, and not-authorized responses.'

Add an explicit 'Use when...' clause naming natural trigger terms such as 'GraphQL API', 'Webiny', 'GraphQL response helpers', or 'custom schema extensions'.

Drop the raw abstraction count from the description and instead summarize the capability so Claude can distinguish this skill from sibling webiny-api skills.

DimensionReasoningScore

Specificity

The description 'api/graphql — 7 abstractions' names a domain and a count but states no concrete actions; closest to the score-1 anchor of vague, actionless language, and not a score 2 because no actions are named.

1 / 3

Completeness

It barely states what (a count of abstractions) and entirely omits any 'Use when...' trigger for when to invoke it; per the judging guidelines the missing trigger caps completeness, and the weak 'what' keeps it at score 1 rather than 2.

1 / 3

Trigger Term Quality

'api/graphql' and '7 abstractions' are technical jargon a user would not naturally say when needing this skill, matching the score-1 anchor of no natural keywords.

1 / 3

Distinctiveness Conflict Risk

The 'api/graphql' niche is somewhat specific and distinguishable, but with no distinct triggers it could still overlap with sibling webiny-api skills; this matches the score-2 anchor more than the conflict-prone score-1.

2 / 3

Total

5

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

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.