CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

webiny-full-stack-architect

Full-stack extension skeleton and registration pattern. Use this skill when creating an extension that spans both API and Admin — the top-level component with Api.Extension and Admin.Extension entry points, shared domain layer, BuildParam declarations, and package structure. References webiny-api-architect and webiny-admin-architect for layer-specific details.

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

A lean, highly actionable architecture pattern document that assumes Claude's competence and contributes only Webiny-specific knowledge, with excellent delegation to sibling skills. Its one real defect is an internal contradiction about required file extensions in Extension src props (.ts/.tsx vs .js), which directly undermines the skill's most-repeated rule.

Suggestions

Resolve the src-extension contradiction: the RULE section says ".ts or .tsx" (with a `.ts` example) while every code block, the checklist, and the Quick Reference say `.js` — pick one (apparently compiled `.js` output) and make the wrong-pattern example consistent.

Trim the MyEntity value-object class in 'Shared Domain Layer' to the interface plus a one-line note that entities live in shared/; the private-constructor/getter boilerplate is knowledge Claude already has.

Add an explicit verification step to the checklist (e.g., 'run the project build and confirm both extensions register') so the construction sequence ends with a validation checkpoint.

DimensionReasoningScore

Conciseness

The body is dense with project-specific knowledge Claude cannot know (entry-point components, BuildParam placement rules, extension vs. core import conventions) and avoids explaining general concepts. It is not a 5 because the ~30-line MyEntity value-object class in 'Shared Domain Layer' is boilerplate Claude could write itself — only the convention that entities live in shared/ needed stating.

4 / 5

Actionability

Mostly executable, copy-paste-ready guidance: the top-level component, BuildParam declaration as React props, consumption in webiny.config.tsx, package structure, and checklist all give concrete code. Not a 5 because the src-extension guidance is contradictory — the RULE section demands ".ts or .tsx extension in every src prop" with a `.ts` example, while all code blocks and the checklist mandate `.js` extensions ("Use .js extensions in all import paths (ESM)"), leaving the reader to guess which is correct.

4 / 5

Workflow Clarity

The six-item Checklist gives a clear construction sequence, and the RULE section supplies strong preventive checkpoints by naming exact failure modes ("Omitting the file extension will cause a build failure", "Bypassing these entry points will fail at runtime"). Below a 5 because there is no explicit verification step (e.g., run the build to confirm registration) after the steps.

4 / 5

Progressive Disclosure

The body is a well-organized overview with TL;DR, rules, structure, code, checklist, and quick reference, and it consistently delegates layer-specific depth to sibling skills ("see webiny-api-architect", "see webiny-admin-architect") — one level deep, clearly signaled in the body, checklist, and Quick Reference. No bundle files exist to house further detail, and none are needed at this scope; navigation is easy.

5 / 5

Total

17

/

20

Passed

Description

87%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.

A strong description with an explicit 'Use when' trigger, concrete coverage of the skill's components, and clear delegation to sibling skills that minimizes conflict risk. The main weakness is missing natural trigger vocabulary — most notably the word "Webiny" itself.

Suggestions

Include the product name (e.g., "Webiny full-stack extension...") so users who say 'webiny extension' or 'webiny project' naturally trigger this skill.

Add one or two artifact-level keywords users would mention, such as "webiny.config.tsx" or "extension package", alongside API and Admin.

Convert one structural noun phrase into an action verb (e.g., "Create and register a full-stack extension") to sharpen the 'what' further.

DimensionReasoningScore

Specificity

The description lists several concrete structural elements — "the top-level component with Api.Extension and Admin.Extension entry points, shared domain layer, BuildParam declarations, and package structure" — which comprehensively mirror the body's coverage. It stops short of a 5 because these are named components rather than concrete actions (e.g., 'create', 'register', 'declare'), leaving minor coverage gaps in what the skill actually does.

4 / 5

Completeness

It explicitly answers both questions: the 'what' is concrete ("Full-stack extension skeleton and registration pattern... top-level component with Api.Extension and Admin.Extension entry points, shared domain layer, BuildParam declarations, and package structure") and the 'when' is an explicit trigger clause ("Use this skill when creating an extension that spans both API and Admin"), matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "creating an extension that spans both API and Admin", "full-stack", "extension", "API and Admin" — phrases a developer would plausibly say. However it never mentions "Webiny" or familiar artifacts like "webiny.config.tsx", so a few natural trigger terms users would actually use are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is clearly delimited: 'spans both API and Admin' distinguishes it from single-side skills, and it explicitly states "References webiny-api-architect and webiny-admin-architect for layer-specific details", which both sharpens the boundary and reduces wrong-skill triggering. Not below 5: no generic language that would overlap with unrelated skills.

5 / 5

Total

18

/

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

Path

skills/user-skills/full-stack-architect/SKILL.md

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.