Creates a DTO (Data Transfer Object) class for an entity. Use this skill when a DTO class needs to be created, either standalone or as part of a larger task (e.g. REST controller, service layer, replacing entity usage with a DTO).
74
68%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/dto-creator/SKILL.mdQuality
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 both what the skill does and when to use it, with good trigger terms covering common scenarios. Its main weakness is that the 'what' portion could be more specific about the concrete actions involved in DTO creation (e.g., field mapping, constructor generation, conversion methods). Overall it performs well for skill selection purposes.
Suggestions
Add more specific concrete actions to the capability description, e.g., 'Creates a DTO class for an entity, including field mapping, constructors, getters/setters, and entity-to-DTO conversion methods.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (DTO/Data Transfer Object class for an entity) and the core action (creates), but doesn't list multiple specific concrete actions like mapping fields, adding validation annotations, generating constructors/getters/setters, or conversion methods. | 2 / 3 |
Completeness | Clearly answers both 'what' (creates a DTO class for an entity) and 'when' (explicit 'Use this skill when...' clause with multiple trigger scenarios including standalone creation and as part of larger tasks like REST controllers or service layers). | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms: 'DTO', 'Data Transfer Object', 'entity', 'REST controller', 'service layer', and 'replacing entity usage with a DTO' — these cover the common ways users would describe needing a DTO. | 3 / 3 |
Distinctiveness Conflict Risk | DTO creation is a clear, specific niche that is unlikely to conflict with other skills. The description narrows the scope to DTO classes specifically, with distinct triggers that wouldn't overlap with general code generation or entity creation skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
47%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill has excellent workflow structure with clear step sequencing and validation checkpoints, but is severely undermined by extreme verbosity — the same instructions about context-checking and not re-asking questions are repeated in multiple forms throughout. The actionability is moderate since all actual code generation is delegated to external example files that aren't provided, making the skill a detailed process orchestration document rather than a self-contained guide. The content would benefit enormously from aggressive trimming of redundant guidance.
Suggestions
Reduce verbosity by consolidating the repeated 'check context before asking' instructions into a single concise section — currently this principle is stated in the intro, Step 0, the Decision-making principle section, Smart answer recognition, and multiple step descriptions.
Include at least one concrete, complete code example of a generated DTO (e.g., a simple Java record DTO) inline so the skill is partially actionable even without the external example files.
Extract the lengthy 'Decision-making principle' and 'How to ask' sections into a separate reference file (e.g., references/interaction-guidelines.md) to keep the main SKILL.md focused on the generation workflow.
Deduplicate the anti-hallucination checklist — several items restate rules already covered in Step 6 (e.g., FQN handling, import grouping, nested record requirements).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~400+ lines. Extensively explains decision-making principles, context-reading strategies, and interaction patterns that Claude already understands. The 'Decision-making principle' section alone spans dozens of lines restating variations of 'check context before asking'. Multiple sections repeat the same rules (e.g., 'never ask what was already answered' appears in at least 4 places). The anti-hallucination checklist, while useful, is bloated with redundant items. | 1 / 3 |
Actionability | The skill provides structured steps and references to example/fragment files for code generation, which is concrete guidance. However, it contains no actual executable code examples — all generation relies on external files (examples/_skeletons/, examples/_fragments/) that are not provided. The MCP tool calls are named but the actual code output is entirely delegated to unseen reference files, making the skill itself more of a process description than executable guidance. | 2 / 3 |
Workflow Clarity | The multi-step workflow (Steps 0-7) is clearly sequenced with explicit decision points, validation checkpoints (anti-hallucination checklist before writing code), and feedback loops (e.g., name collision detection, re-validation). Each step has clear entry/exit conditions and the dependency chain between steps is well-documented with tables showing what feeds into what. | 3 / 3 |
Progressive Disclosure | The skill references multiple external files (references/sub-dto.md, references/java-plain.md, references/java-record.md, references/java-lombok.md, references/kotlin.md, references/validation.md, examples/_skeletons/, examples/_fragments/) which is good progressive disclosure structure. However, no bundle files were provided to verify these exist, and the main SKILL.md itself is monolithic — much of the decision-making logic and interaction patterns could be extracted into a separate reference file to keep the main file leaner. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (507 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
4d8e766
Table of Contents
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.