skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
zander-zyx/java-development-skill56 installs

java-development

Use when writing, refactoring, or reviewing any Java or JVM code: plain Java, libraries, CLI tools, Android Java, Maven/Gradle dependency and build governance (pom.xml, BOMs, version catalogs, toolchains), Spring Boot development and version migration (2.x to 3.x, 3.x to 4.x, javax to jakarta), MyBatis/MyBatis-Plus or JPA/Hibernate persistence, writing tests with JUnit 5, Mockito, AssertJ, and Testcontainers, API design, exception handling, security review, Java upgrades, and JVM troubleshooting such as OOM, high CPU, GC tuning, GC logs, thread dumps, deadlocks, and memory leaks. Also covers Jakarta EE, Quarkus, Micronaut, and Lombok. Not for non-JVM languages or general questions unrelated to Java code.

How do I install this agent skill?

npx skills add https://github.com/zander-zyx/java-development-skill --skill java-development
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a comprehensive guide for Java development agents, focusing on project structure, dependency management, and JVM troubleshooting. It includes scripts for local installation and validation, following best practices for environment preservation and minimal code modification.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Java Development Agent

Router skill for general Java/JVM work. Treat Spring Boot as one supported framework, not the default for every project. Load only the matching rule files below.

Routing Protocol

Run these three steps in order before generating or modifying code.

Step 1 — Stack Detection

Inspect the project's build descriptor(s) first and record what they prove:

  • pom.xml vs build.gradle(.kts) → Maven or Gradle; preserve whichever exists.
  • Java version → maven.compiler.release / <java.version> / Gradle toolchain or sourceCompatibility.
  • Spring Boot line → parent or BOM version: 2.x, 3.x, or 4.x (drives jakarta namespace, security DSL, Actuator/Micrometer config).
  • Persistence → JPA/Hibernate vs MyBatis/MyBatis-Plus vs JDBC/jOOQ (dependencies plus repository/mapper layout).
  • Lombok → present and annotation processing configured, or absent.
  • Logging facade → SLF4J, Log4j2, or JUL in actual use.
  • Test stack → JUnit 4 vs 5, Mockito, Testcontainers, Spring Boot test slices.

Existing evidence beats this skill's defaults. If a descriptor answers a question, do not assume otherwise.

Step 2 — Lazy Routing (Progressive Disclosure)

Classify the task, then read only the 1–3 highest-matching rule files from the route table. Never load every rule file for one task — it inflates the context window without improving the answer.

  • Unknown/general Java task: load core/java-general-development.md only if classification or the default choice is unclear.
  • API/exception/version work: load the specific core/... rule before framework rules.
  • Build edits: load exactly one build-tools/... rule matching the detected build tool.
  • Spring Boot edits: load the primary spring-boot/... rule only when the project actually uses Spring Boot.
  • Broad code review: start with code-review/cr-anti-patterns.md, then add specific risk files.
  • Test work: load testing/test-layering.md first, then the framework-specific test file.
  • JVM incident: load the symptom file first; add GC/thread/resource files only when evidence points there.
  • Do not load README files or examples/ unless the user asks for usage docs.

Step 3 — Convention Priority

The target project's existing code style, architecture, and module conventions outrank this skill's rules. When they conflict, follow the project and say so explicitly.

Defaults

  • Respond in the user's language; keep code unchanged unless editing.
  • Do not introduce Spring Boot, Maven, Gradle, Lombok, MyBatis-Plus, JPA, Testcontainers, or Java 17+ syntax unless the project already uses it or the user asks.
  • If creating a new project and no preference is given: choose a dependency-supported Java LTS baseline (17 or newer), infer Maven or Gradle from the surrounding repository, use JUnit 5, constructor-based design, SLF4J-compatible logging, and immutable DTOs where practical.
  • For a new Spring Boot project, verify the current stable release, Java/build requirements, and third-party starter compatibility from official sources before choosing a line. For existing projects, keep their supported line unless migration is requested.
  • Do not choose a persistence framework by geography or popularity. Preserve the existing choice; for greenfield work, select JDBC, jOOQ, MyBatis/MyBatis-Plus, or JPA/Hibernate from the actual query model and team constraints.
  • Prefer constructor injection in DI frameworks. Use Lombok (@RequiredArgsConstructor, @Slf4j) only when the project already uses Lombok; otherwise write explicit constructors/loggers.
  • If multiple modules or frameworks exist, modify only the affected module unless the user asks for a cross-cutting change.
  • Do not edit generated output unless explicitly requested; edit the source template, annotation processor input, schema, or generator configuration instead.

Work Rules

  • Inspect only relevant files before editing: build descriptor, source layout, dependency versions, framework style, and tests around the change.
  • Prefer the smallest safe change; do not perform broad refactors unless requested.
  • If business behavior is unclear, ask one concise question instead of inventing rules.
  • For non-trivial work, report: change reason, impact scope, verification performed, verification not performed, and the narrowest verification command/result.

Route By Task

Task signalRead firstAdd if needed
Unknown Java project, framework-neutral edit, library/CLI codecore/java-general-development.mdadd matching build-tools/..., testing/..., or code-review/... rule
Public API, interfaces, DTOs, compatibility, library contractscore/java-api-design.mdcode-review/cr-null-safety.md
Exceptions, retries, interrupts, failure boundariescore/java-exception-handling.mdcode-review/cr-resource-leak.md
Java 8/11/17/21/25 upgrade, newer syntax, toolchaincore/java-version-modernization.mdbuild-tools/build-maven-dependencies.md or build-tools/build-gradle-dependencies.md
Maven pom.xml, dependencies, BOM, plugins, Java releasebuild-tools/build-maven-dependencies.mdrelevant spring-boot/..., testing/..., or migration rule
Gradle build.gradle(.kts), wrapper, version catalog, toolchainbuild-tools/build-gradle-dependencies.mdrelevant spring-boot/..., testing/..., or migration rule
DI, beans, Lombok, service/controller skeletonspring-boot/sb-dependency-injection.mdspring-boot/sb-project-structure.md
Package layout, controller/service/repository boundariesspring-boot/sb-project-structure.mdspring-boot/sb-exception-handling.md
application.yml, profiles, secrets, config importspring-boot/sb-config-profiles.mdspring-boot/sb-actuator-health.md
MyBatis, MyBatis-Plus, mapper, wrapper, paginationspring-boot/sb-mybatis-plus.mdcode-review/cr-equals-hashcode.md
JPA, Hibernate, N+1, lazy loading, transactionsspring-boot/sb-jpa-repository.mdcode-review/cr-equals-hashcode.md
REST API error handling, validation errorsspring-boot/sb-exception-handling.mdcode-review/cr-null-safety.md
HTTP clients, RestClient, WebClient, RestTemplatespring-boot/sb-rest-client.mdspring-boot/sb-config-profiles.md
Actuator, health, metrics, probesspring-boot/sb-actuator-health.mdjvm/jvm-gc-logs.md
Spring Boot 2->3, javax/jakarta migrationspring-boot/sb-migration-2-to-3.mdbuild-tools/... plus spring-boot/sb-rest-client.md when HTTP clients are affected
Spring Boot 3->4, Framework 7/Jakarta/Servlet baselinespring-boot/sb-migration-3-to-4.mdbuild-tools/..., spring-boot/sb-rest-client.md, and affected testing/... rules
Java code review, general smell scancode-review/cr-anti-patterns.mdspecific review files below
Security review, secrets, injection, crypto, deserialization, SSRFcode-review/cr-security.mdspring-boot/sb-config-profiles.md plus relevant build/framework rule
Thread safety, locks, ThreadLocal, transactions proxycode-review/cr-concurrency.mdcode-review/cr-resource-leak.md
Closeable, JDBC, locks, thread pools, leakscode-review/cr-resource-leak.mdjvm/jvm-oom-analysis.md
NPE, Optional, nullable contractscode-review/cr-null-safety.mdcore/java-exception-handling.md or framework error rule
equals, hashCode, entity identitycode-review/cr-equals-hashcode.mdspring-boot/sb-jpa-repository.md or spring-boot/sb-mybatis-plus.md when entities are involved
Stream API, parallel stream, lambda side effectscode-review/cr-stream-pitfalls.mdcode-review/cr-concurrency.md
Test strategy, unit/slice/integration choicetesting/test-layering.mdtesting/test-junit5.md, testing/test-mockito.md, testing/test-spring-boot-test.md, or testing/test-testcontainers.md
JUnit 5 lifecycle, parameterized teststesting/test-junit5.mdtesting/test-coverage-assertj.md
Mockito mocks, spies, static mockstesting/test-mockito.mdtesting/test-layering.md
Testcontainers, real DB/Redis/Kafkatesting/test-testcontainers.mdtesting/test-spring-boot-test.md
@SpringBootTest, @WebMvcTest, @DataJpaTesttesting/test-spring-boot-test.mdtesting/test-testcontainers.md
AssertJ, JaCoCo, coverage floortesting/test-coverage-assertj.mdaffected testing/... framework rule
OOM, heap dump, memory leakjvm/jvm-oom-analysis.mdcode-review/cr-resource-leak.md
High CPU, hot thread, profilingjvm/jvm-cpu-high.mdjvm/jvm-thread-dump.md
Hang, deadlock, thread leakjvm/jvm-thread-dump.mdcode-review/cr-concurrency.md
GC pause, heap sizing, collector choicejvm/jvm-gc-tuning.mdjvm/jvm-gc-logs.md
GC log interpretationjvm/jvm-gc-logs.mdjvm/jvm-gc-tuning.md

Assets

  • assets/pom-spring-boot-3.xml: opt-in Spring Boot 3.x + MyBatis-Plus Maven example.
  • assets/pom-spring-boot-2.xml: opt-in legacy Spring Boot 2.7 maintenance example.
  • assets/controller-service-test.java: opt-in Spring Boot 3 + MyBatis-Plus skeleton; split it into real files before use.
  • assets/application.yml.template: opt-in multi-environment Spring Boot + MyBatis-Plus config example.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/zander-zyx/java-development-skill/java-development">View java-development on skillZs</a>