CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dev-create-module

Use when creating a new feature module with all layers - service, adapter, types, state, components, and tests.

Quality

72%

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 ./packs/nuxt/skills/dev-create-module/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%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, well-structured workflow for a simple scaffolding skill, with concrete paths and a validation step. Its weaknesses are the unspecified core generation step delegated to @builder and the absence of an error-recovery loop after validation.

Suggestions

Add a minimal concrete example (or a referenced template) for the core artifacts of step 5 — e.g., a 3-line service/adapter snippet — so the generation step is executable rather than fully delegated to @builder.

Add a feedback loop after validation: "If typecheck or build fails, fix the errors and re-run before proceeding" rather than ending at step 7.

Clarify or define "contracts" in step 5 (where it lives, what it contains), since it is the one term not covered by the referenced ARCHITECTURE.md sections.

DimensionReasoningScore

Conciseness

The body is lean and dense: a file reference with specific sections ("docs/ARCHITECTURE.md sections 2, 3 and 4"), a compact directory tree, terse steps, and a validation command. There is no explanation of concepts Claude already knows and nothing that could be trimmed — matching 'every token earns its place'.

5 / 5

Actionability

There is concrete guidance (specific paths, directory tree, `nuxi typecheck && nuxi build`, user questions), but the core creation work — "Types + contracts + adapter + service (using $fetch)" — is delegated to `@builder` with no example or specification of what these artifacts look like, and the index.ts snippet is only comments. These are missing key details rather than the minor gaps of level 4.

3 / 5

Workflow Clarity

A clear numbered sequence exists and ends with a validation checkpoint (`nuxi typecheck && nuxi build`), but there is no error-recovery loop (what to do when validation fails) and validation is deferred to the very end of a batch multi-file generation. Per the batch-operation feedback-loop cap, it cannot exceed 3.

3 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and well-organized with a clean step structure; it appropriately defers architectural detail to the external docs/ARCHITECTURE.md rather than inlining it. Per the simple-skill guideline, this earns a 5 without bundle files.

5 / 5

Total

16

/

20

Passed

Description

62%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 has an explicit trigger clause and a concrete, niche-scoped layer list, but it states only one action and lacks trigger variations, and the 'what' is not clearly separated from the 'when'. It is solid but not comprehensive.

Suggestions

Separate the 'what' from the 'when': e.g., "Scaffolds a complete feature module (service, adapter, types, state, components, tests) following docs/ARCHITECTURE.md. Use when creating a new feature module or adding a new feature to the app."

Add natural trigger variations users might say, such as "new module", "scaffold a feature", or "add a feature", to broaden keyword coverage.

Mention key deliverables like the Nuxt page in pages/ and server API routes so the capability list is more comprehensive.

DimensionReasoningScore

Specificity

The description names the domain and a single action — "creating a new feature module" — and enumerates the layers involved ("service, adapter, types, state, components, and tests"), but it lists only one concrete action rather than the several specific actions of the level-4 anchor. It is more concrete than the generic level-2 anchor, which names a domain with minimal actions.

3 / 5

Completeness

An explicit "Use when..." clause is present (avoiding the level-3 cap), and the 'what' — building a module with all layers — is stated. However, the 'what' is embedded in and nearly tautological with the 'when' clause, so it falls short of the level-5 anchor's clearly distinct and concrete what-and-when pairing.

4 / 5

Trigger Term Quality

"Use when creating a new feature module" is a natural phrase a user would say, but coverage stops there: no synonyms or variations ("scaffold", "add a feature", "new module", "new page") are present, and the layer names (adapter, state) read as architectural jargon rather than user triggers. This matches 'some relevant keywords but missing common variations'.

3 / 5

Distinctiveness Conflict Risk

The specific layer stack ("service, adapter, types, state, components") carves out a clear project-specific niche with low conflict risk against general skills. It does not fully reach level 5 because terms like "components" and "tests" leave minor overlap risk with generic scaffolding or code-generation skills.

4 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/specialist-agent

Path

packs/nuxt/skills/dev-create-module/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.