CtrlK
BlogDocsLog inGet started
Tessl Logo

mapper-creator

Creates a mapper between an entity and a DTO (MapStruct or custom converter). Use this skill when a mapper/converter between entity and DTO needs to be created, either standalone or as part of a larger task (e.g. after DTO creation, during CRUD setup).

70

Quality

62%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/mapper-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a solid skill description that clearly communicates its purpose and when to use it. The explicit 'Use this skill when...' clause with contextual triggers (standalone, after DTO creation, during CRUD setup) is well done. The main weakness is that the 'what' portion could be more specific about the concrete actions performed beyond just 'creates a mapper'.

Suggestions

Expand the capability description with more specific actions, e.g., 'Creates a mapper between an entity and a DTO using MapStruct annotations or custom converter classes, including field mappings, nested object handling, and collection conversions.'

DimensionReasoningScore

Specificity

Names the domain (mapper/converter between entity and DTO) and mentions specific approaches (MapStruct or custom converter), but doesn't list multiple concrete actions beyond 'creates a mapper'. Could specify more actions like 'generates mapping methods, handles nested object mapping, configures custom field mappings'.

2 / 3

Completeness

Clearly answers both 'what' (creates a mapper between entity and DTO using MapStruct or custom converter) and 'when' (explicit 'Use this skill when...' clause with triggers including standalone use and as part of larger tasks like DTO creation or CRUD setup).

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'mapper', 'converter', 'entity', 'DTO', 'MapStruct', 'CRUD setup', 'DTO creation'. These cover the main terms a developer would use when requesting this functionality.

3 / 3

Distinctiveness Conflict Risk

Clearly scoped to mapper/converter creation between entities and DTOs, which is a distinct niche. The mention of MapStruct and the specific entity-to-DTO context makes it unlikely to conflict with other skills like general code generation or DTO creation skills.

3 / 3

Total

11

/

12

Passed

Implementation

35%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is a comprehensive but overly verbose mapper creation guide. Its greatest weakness is extreme verbosity — the decision-making principle, question-asking meta-instructions, and context-scanning guidance are repeated and restated multiple times, consuming significant token budget without proportional value. The workflow structure is reasonable with clear steps and external file references, but lacks post-generation validation and contains no inline executable code examples.

Suggestions

Reduce token count by 40-50%: consolidate the decision-making principle, Step 0, and smart-defaults sections into a single concise block — the current content repeats 'don't re-ask what the user said' in at least 5 different places.

Extract the AskUserQuestion usage rules and the detailed context-scanning table into a separate reference file (e.g., references/question-guidelines.md) to keep the main skill lean.

Add a post-generation validation step (e.g., 'verify the file compiles by checking imports match usage' or 'run build to confirm MapStruct processor generates implementation').

Include at least one concrete, complete code example inline (e.g., a minimal MapStruct mapper output) so the skill is actionable even without the external reference files.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~350+ lines. It over-explains decision-making principles, repeats instructions multiple times (e.g., 'NEVER re-ask' appears in multiple places), includes lengthy tables for context scanning that Claude could infer, and restates the same logic in different forms (Step 0 vs Decision-making principle vs Step 3 context-first). Much of the meta-instruction about how to ask questions and when to use AskUserQuestion is excessive.

1 / 3

Actionability

The skill provides structured steps and references to example/fragment files for code generation, but contains no actual executable code examples within the skill itself. The concrete code generation is entirely deferred to external reference files (e.g., `references/mapstruct-java.md`, `examples/_skeletons/`), and the build file editing instructions give patterns but not complete copy-paste examples. The variable substitution rules and @Mapping annotation building are reasonably specific but still somewhat abstract.

2 / 3

Workflow Clarity

The workflow has clear numbered steps (0-5) with a logical sequence, and includes an anti-hallucination checklist at the end which serves as validation. However, there are no explicit validation checkpoints between steps (e.g., no 'verify the generated file compiles' or 'validate the mapper output'). The anti-hallucination checklist is a pre-write mental check, not a post-write verification step. For a code generation task that modifies build files, missing post-generation validation caps this at 2.

2 / 3

Progressive Disclosure

The skill references multiple external files (references/mapstruct-java.md, references/mapping-annotations.md, examples/_skeletons/, examples/_fragments/) which is good progressive disclosure structure. However, no bundle files were provided to verify these exist, and the SKILL.md itself is monolithic — the lengthy decision-making principle section, the AskUserQuestion usage rules, and the detailed Step 0 context-scanning table could all be extracted to separate reference files. The main file tries to contain too much inline.

2 / 3

Total

7

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
Amplicode/spring-skills
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.