CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-module

Adds a new application module to this Spring Modulith project with the package layout the ModuleBoundariesTests gate expects, and a module-scoped integration test. Use when the user asks for a new module, bounded context, or feature area that doesn't belong in an existing module.

Quality

89%

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, actionable skill body: the module layout, interaction rules, and verification gate are all stated concretely with no padding. The remaining gaps are an undefined-template-placeholder risk, a missing minimal example of the module test class, and no guidance on recovering from a failed verify run.

Suggestions

Briefly define or resolve the placeholders — state that {{BASE_PACKAGE}}/{{BASE_PATH}} are substituted from project configuration (or show one concrete expanded example like com.acme.billing) so the paths are unambiguous at execution time.

Include a 5-8 line skeleton of <Module>ModuleTests.java showing the @ApplicationModuleTest annotation and one public-API-driven test, making step 4 copy-paste ready.

Add a short error-recovery step after "Run `./mvnw verify`": e.g., "If ModuleBoundariesTests fails, the report names the offending references — fix the caller or move the type to internal, then re-run."

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — e.g., "Each direct subpackage of `{{BASE_PACKAGE}}` is a module. `./mvnw verify` fails if another module reaches into its nested packages or if modules form a cycle" states only project-specific facts, and annotations like `@ApplicationModuleListener` are used without tutorial explanation. Every sentence instructs; nothing re-teaches Spring Modulith concepts, matching anchor 5.

5 / 5

Actionability

Concrete and mostly executable: exact layout ("{{BASE_PACKAGE}}.<module>.internal"), exact test path ("src/test/java/{{BASE_PATH}}/<module>/<Module>ModuleTests.java"), annotations, and the command "Run `./mvnw verify`". However, no code snippet is given for the test class or the public API surface, and the placeholders {{BASE_PACKAGE}}/{{BASE_PATH}} are never defined or explained in the skill — minor gaps that fit anchor 4 rather than 5's fully copy-paste-ready coverage.

4 / 5

Workflow Clarity

A clear, well-ordered six-step sequence with checkpoints: step 1 verifies name availability ("Check that no existing module owns it") and step 6 runs the gate ("Run `./mvnw verify`"). It falls short of anchor 5 because there is no error-recovery loop telling Claude what to do when verify fails (e.g., read the ModuleBoundariesTests report, fix the offending reference, re-run), though it comfortably exceeds anchor 3's implicit-checkpoint level. The destructive/batch cap does not apply since adding a module is an additive operation with verification present.

4 / 5

Progressive Disclosure

At roughly 20 lines with a single heading, a two-line framing sentence, and a numbered procedure, the skill is well-organized and needs no external files — the simple-skill guideline allows a 5 here. Its only external pointer ("the `Modules` section of `AGENTS.md`") is clearly signaled and one level deep, and no bundle files exist to reference.

5 / 5

Total

18

/

20

Passed

Description

87%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 strong description: third-person, concrete about what it does, and explicit about when to trigger it with natural synonymous phrases. The only soft spot is trigger coverage that stops at three variants and a capability list that omits the registry/verification steps.

DimensionReasoningScore

Specificity

"Adds a new application module to this Spring Modulith project with the package layout the ModuleBoundariesTests gate expects, and a module-scoped integration test" lists several specific actions (create the module, produce the expected package layout, add the integration test), but coverage stops there — steps like updating the module registry or running verification are not mentioned. This fits anchor 4 (several specific actions, minor gaps) and not 3, since more than 1-2 actions are named.

4 / 5

Completeness

The description explicitly answers both questions: what ("Adds a new application module... with the package layout the ModuleBoundariesTests gate expects, and a module-scoped integration test") and when ("Use when the user asks for a new module, bounded context, or feature area that doesn't belong in an existing module") with concrete trigger phrases, matching anchor 5 exactly. It is not a 4 because the 'when' clause is already explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

"Use when the user asks for a new module, bounded context, or feature area" supplies three natural synonymous phrases users would actually say. It falls short of anchor 5's comprehensive coverage (no additional variants like "new context", "add a service", or project-specific naming cues beyond those three), but clearly exceeds anchor 3's partial keyword coverage.

4 / 5

Distinctiveness Conflict Risk

"Spring Modulith project", "ModuleBoundariesTests gate", "bounded context", and "module-scoped integration test" carve out a clear niche with distinct triggers; no other skill would plausibly claim these phrases. Not a 4 because there is no meaningful overlap with a closely related skill's territory.

5 / 5

Total

18

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

a-pavithraa/springboot-skills-marketplace

Path

plugins/springboot-architecture/skills/spring-boot-team-harness/assets/project-skills/add-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.