CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dev-create-module

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

Quality

81%

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

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.

A tight, well-sequenced orchestration skill that stays lean by delegating detail to the architecture doc and @builder, with a real validation command at the end. The remaining gaps are minor: an undefined @builder reference, a comment-only index.ts template, and no guidance for handling validation failures.

DimensionReasoningScore

Conciseness

The body is a lean numbered checklist with no explanation of concepts Claude already knows; it delegates detail to "docs/ARCHITECTURE.md" and "@builder", so every token earns its place.

5 / 5

Actionability

Concrete artifacts are given (directory tree, index.ts template, "npx astro check && npx astro build"), but "@builder" is never defined and the index.ts snippet shows only comments rather than an actual export statement — minor gaps that keep it below fully copy-paste ready.

4 / 5

Workflow Clarity

Steps 1-7 are clearly sequenced and a validation checkpoint exists (step 7), but there is no error-recovery loop (what to do when astro check fails) and the user-questions step comes after the directory structure is already created.

4 / 5

Progressive Disclosure

With no bundle files, the under-50-line body is well organized and its single external reference is clearly signaled with pinpoint sections ("Read docs/ARCHITECTURE.md sections 2, 3 and 4"), matching the simple-skill exception for a top score.

5 / 5

Total

18

/

20

Passed

Description

71%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 lean, appropriately third-person description with an explicit trigger clause and a concrete layer enumeration that bounds the scope well. Its main weaknesses are merged what/when phrasing and thin trigger-term coverage (no synonyms like add/scaffold), which limit discoverability.

Suggestions

Split the description into a what clause and a when clause, e.g. "Creates a complete feature module (service, adapter, types, pages, components, tests) following the project architecture. Use when the user asks to create, add, or scaffold a new feature module or section of the app."

Add natural trigger synonyms such as "add", "scaffold", "generate", or "new module" so varied user phrasings match the skill.

Mention the target stack (Astro) or the architecture doc by name so the description anchors to this project rather than reading as generic scaffolding.

DimensionReasoningScore

Specificity

The description enumerates concrete deliverables ("service, adapter, types, pages, components, and tests") making the scope specific, but rests on a single action verb ("creating"), so it is not the comprehensive multi-action coverage of a 5.

4 / 5

Completeness

An explicit "Use when..." clause answers when, and the what (a module with all layers) is clear, but both are merged into a single clause rather than distinct statements with concrete trigger phrases.

4 / 5

Trigger Term Quality

"creating a new feature module" is a natural phrase a user would say, but common variations and synonyms ("add", "scaffold", "generate", "new module") are missing, matching the anchor for some relevant keywords without variations.

3 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — greenfield full-stack module scaffolding for a specific service/adapter/pages architecture — and "with all layers" distinguishes it from single-component or single-file skills, giving minimal conflict risk.

5 / 5

Total

16

/

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/astro/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.