CtrlK
BlogDocsLog inGet started
Tessl Logo

webiny-admin-aco-catalog

admin/aco — 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/admin/aco/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 efficient, well-structured catalog: lean entries with concrete import statements and exact source paths, a clear single-purpose workflow, and clean one-level-deep navigation. Its only real gap is the absence of any inline usage examples or hook signatures, leaving the reader to open the source file for anything beyond the import line.

Suggestions

Add a one-line purpose next to each abstraction (e.g., 'useNavigateFolder — navigates the ACO folder tree in the admin app') so the 'find the abstraction you need' step works without opening every source file.

Include a minimal usage snippet per hook (arguments and return shape) so common cases don't require reading the full source file.

DimensionReasoningScore

Conciseness

The body is a lean catalog — two headers, three one-line usage steps, and two minimal entries (Name/Import/Source) with no explanations of concepts Claude already knows and no padding. This matches the score-5 anchor 'Lean and efficient; assumes Claude's competence; every token earns its place'; there is nothing to trim, so 4 is excluded.

5 / 5

Actionability

Each entry gives a concrete, copy-paste-ready import statement and an exact source path (e.g., 'import { useNavigateFolder } from "webiny/admin/aco"' plus '@webiny/app-aco/hooks/useNavigateFolder.ts'), but there are no examples of how to call the hooks or what they return — the skill delegates that entirely to reading the source. This matches score 4 ('Mostly executable guidance; concrete code or commands with minor gaps'); it cannot be 5 because the common usage cases are not covered inline, and not 3 because the guidance given is fully executable, not pseudocode.

4 / 5

Workflow Clarity

This is a simple, single-purpose skill with an unambiguous three-step sequence: find the abstraction, read the listed source file, import using the given template, with the imperative 'You MUST read the source file' acting as an explicit checkpoint. Per the simple-skill guideline, a single unambiguous action warrants a 5; not 4 because no step is ambiguous or missing a checkpoint.

5 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references, and is well-organized into 'How to Use' and 'Abstractions' sections with each entry pointing one level deep to its source file — the entire document is an overview. This matches both the under-50-lines guideline and the score-5 anchor 'Clear overview with well-signaled one-level-deep references; easy navigation'; no bundle files exist to penalize structure.

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 too terse to function as a trigger: it names the Webiny admin/aco module and the abstraction count but provides no concrete actions, no natural trigger terms, and no 'Use when' guidance. It would rarely be surfaced correctly by a user query and is only weakly distinguishable from other catalog-style skills.

Suggestions

List the concrete capabilities: e.g., 'Catalogs the useNavigateFolder and useRecords hooks from Webiny's admin/aco module for folder navigation and record listing in the Admin app.'

Add natural trigger terms users would actually say, such as 'Webiny ACO', 'folder navigation', 'app-aco hooks', or 'admin record list'.

Append an explicit trigger clause, e.g., 'Use when working in a Webiny admin codebase and needing ACO folder navigation or record access hooks.'

DimensionReasoningScore

Specificity

The description names a domain ("admin/aco") but includes zero concrete actions — it only states "2 abstractions" without saying what any of them do. It is not entirely vague since the domain is identifiable, matching the anchor 'Names the domain but actions are minimal or generic'; it cannot be 3 because no 1-2 concrete actions are listed, and not 1 because the domain is specifically named rather than pure abstract language.

2 / 5

Completeness

A vague 'what' is present (a catalog of 2 abstractions in admin/aco) but the 'when' is entirely missing — no 'Use when...' clause or equivalent trigger guidance. This matches the score-2 anchor 'Has a vague what and no when'; it cannot be 3 because the 'what' never states any actions performed, and cannot be 1 because the domain and content type are at least identified.

2 / 5

Trigger Term Quality

"admin/aco — 2 abstractions" contains only internal technical jargon with no natural keywords a user would say (no mention of navigation, folders, records, Webiny, or hooks). This matches the score-1 anchor 'No natural keywords; only technical jargon'; it cannot be 2 because even one generic natural keyword is absent.

1 / 5

Distinctiveness Conflict Risk

"admin/aco" is a specific Webiny module path, giving it a somewhat distinct niche, but the description says nothing else, so it could still overlap with other Webiny admin catalog skills. This matches the score-3 anchor 'Somewhat specific but could still overlap'; not 4 because no distinct trigger phrases distinguish it from sibling catalog skills, not 2 because the technical path is far more specific than 'document files'-level breadth.

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.