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

80%

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/react/skills/dev-create-module/SKILL.md
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.

The body is an exemplar of lean skill writing: a tight, well-sequenced workflow that delegates architecture detail to the project doc and ends with executable validation. The only notable gaps are the unspecified mechanics around the @builder step and route registration, plus the absence of a failure-recovery loop after validation.

DimensionReasoningScore

Conciseness

The body is ~45 lines of terse imperative steps with zero concept explanations, no padding, and even the validation step is a one-liner ("npx tsc --noEmit && npx vite build"). Every token earns its place and it fully assumes Claude's competence.

5 / 5

Actionability

It provides a concrete directory tree, an exact validation command, and specific stack guidance (React Query, React.lazy() + Suspense). However, "Use `@builder` to create bottom-up" and "Register the route in the router" omit the specific mechanics/file locations, and the index.ts block is comments only — minor gaps that keep it below fully copy-paste ready.

4 / 5

Workflow Clarity

A clear numbered 1–7 sequence includes a user-input checkpoint (step 4) and an explicit final validation command. It falls short of the top anchor because there is no feedback loop (fix-and-re-validate on failure) and validation appears only once at the end.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files, is well organized into steps, and properly offloads detailed conventions to docs/ARCHITECTURE.md with specific section numbers (2, 3 and 4) — exactly the one-level-deep reference pattern the rubric rewards for simple skills.

5 / 5

Total

18

/

20

Passed

Description

67%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 concise, third-person, and appropriately scoped to a specific layered architecture, giving it good specificity and low conflict risk. Its main weakness is trigger coverage: it offers essentially one natural trigger phrase with no synonyms or variations, and the 'what' is implied by the layer list rather than stated as concrete actions.

Suggestions

Add natural trigger variations users might say, e.g. "Use when creating, scaffolding, or adding a new feature module".

State the 'what' as concrete actions, e.g. "Scaffolds a new feature module with service, adapter, types, state, components, and test layers", to complement the 'Use when' clause.

Mention the stack context (e.g. React/TypeScript module) so the niche is even more distinguishable from generic code-generation skills.

DimensionReasoningScore

Specificity

The description enumerates six concrete deliverables ("service, adapter, types, state, components, and tests") but relies on a single action verb ("creating"), so it lists several specific elements with minor gaps rather than the comprehensive multi-action coverage of the top anchor.

4 / 5

Completeness

It explicitly answers both parts: "Use when creating a new feature module" gives the when, and the layer enumeration gives the what. However, the what is implicit (the skill scaffolds these layers) and the when lacks concrete trigger variations, so it does not clearly reach the fully explicit top anchor.

4 / 5

Trigger Term Quality

The only natural trigger phrase is "creating a new feature module"; the layer names describe the deliverable rather than phrases a user would say, and common variations like "scaffold", "add", or "generate a module" are missing. This matches "some relevant keywords but missing common variations or synonyms" better than the good-coverage anchor above it.

3 / 5

Distinctiveness Conflict Risk

The specific layered-architecture enumeration ("service, adapter, types, state, components, and tests") carves a distinct niche, but a generic component- or feature-creation skill could still claim overlapping triggers, matching "mostly distinct; minor overlap risk with closely related skills".

4 / 5

Total

15

/

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