Agent skill

128 Java Generics

by jabrena in jabrena/plinth

A skill your agent uses when you need to review, improve, or refactor Java code for generics quality — including avoiding raw types, applying the PECS (Producer Extends Consumer Super) principle for…

Apache-2.0Auto-check passedDevelopment

Install 128 Java Generics

skills CLI
$ npx skills add jabrena/plinth --skill 128-java-generics -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jabrena/plinth 128-java-generics --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jabrena/plinth.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/128-java-generics .claude/skills/128-java-generics && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
128-java-generics
GitHub stars
446
Token cost
~956 tokens
SKILL.md length
374 words
Files
2 (incl. references)
Skills in repo
124
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when you need to review, improve, or refactor Java code for generics quality — including avoiding raw types, applying the PECS (Producer Extends Consumer Super) principle for…

  • You need to review
  • SKILL.md covers Constraints, When to use this skill, Workflow and Reference
  • Calls mvn
  • Refactor Java code for generics quality — including avoiding raw types

What it does

128 Java Generics is an agent skill from jabrena/plinth. Use when you need to review, improve, or refactor Java code for generics quality — including avoiding raw types, applying the PECS (Producer Extends Consumer Super) principle for wildcards, using bounded type parameters, designing effective generic methods, leveraging the diamond operator, understanding type erasure implications, handling generic inheritance correctly, preventing heap pollution with @SafeVarargs, and integrating generics with modern Java features like Records, sealed types, and pattern matching…

Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/128-java-generics.md`).

It sits in Development, covering Type safety and Refactoring. It works with Java. The repository describes itself as: Plinth is an AI-native engineering toolkit for modern Java enterprise SDLC, built around reusable Commands, Agents, Skills, and MCP Servers. The licence is Apache-2.0.

When your agent uses it

  • You need to review
  • Refactor Java code for generics quality — including avoiding raw types
  • Applying the PECS (Producer Extends Consumer Super) principle for wildcards
  • Using bounded type parameters

Example prompts

  • “/128-java-generics”

What it can do on your machine

Read from SKILL.md and the folder at commit dca88dc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • mvn

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

128 Java Generics loads about 956 tokens when it runs, and up to ~16k if it reads all its reference files. Until then it costs about 193 tokens; SKILL.md has 374 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~193
When it runs · the whole SKILL.md, loaded when a task matches
~956
With references · SKILL.md plus every file in references/, read only if the agent opens them
~16k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jabrena/plinth at commit dca88dc, republished under its Apache-2.0 licence (© jabrena). 374 words, ~956 tokens.

Download SKILL.mdSave it as .claude/skills/128-java-generics/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
128-java-generics
description
Use when you need to review, improve, or refactor Java code for generics quality — including avoiding raw types, applying the PECS (Producer Extends Consumer Super) principle for wildcards, using bounded type parameters, designing effective generic methods, leveraging the diamond operator, understanding type erasure implications, handling generic inheritance correctly, preventing heap pollution with @SafeVarargs, and integrating generics with modern Java features like Records, sealed types, and pattern matching. This should trigger for requests such as Improve the code with Generics; Apply Generics; Refactor the code with Generics; Improve generic type safety in Java APIs; Fix raw types and unchecked casts in Java code. Part of Plinth Toolkit
license
Apache-2.0
metadata.author
Juan Antonio Breña Moral
metadata.version
0.19.0

Java Generics Best Practices

Review and improve Java code using comprehensive generics best practices that enforce compile-time type safety and enable flexible, reusable APIs.

What is covered in this Skill?

  • Type safety: avoiding raw types, eliminating unsafe casts
  • Code reusability: generic methods and types for multiple type contexts
  • PECS wildcards: ? extends for producers, ? super for consumers
  • Diamond operator for type inference
  • Type erasure awareness: type tokens, factory patterns, array creation
  • Generic inheritance and variance: invariance, covariance, contravariance
  • @SafeVarargs for heap pollution prevention
  • Wildcard capture helpers, self-bounded generics (CRTP) for fluent builders
  • Proper wildcard API design: Comparator<? super T>, Function<? super T, ? extends R>
  • Arrays-vs-generics covariance pitfalls, serialization with TypeReference/TypeToken
  • Generic naming conventions (T, E, K/V, ?), typesafe heterogeneous containers
  • Integration with Records, sealed types, and pattern matching

Scope: The reference is organized by examples (good/bad code patterns) for each core area. Apply recommendations based on applicable examples.

Constraints

Before applying any generics changes, ensure the project compiles. If compilation fails, stop immediately — do not proceed until resolved. After applying improvements, run full verification.

  • MANDATORY: Run ./mvnw compile or mvn compile before applying any change
  • SAFETY: If compilation fails, stop immediately and do not proceed — compilation failure is a blocking condition
  • VERIFY: Run ./mvnw clean verify or mvn clean verify after applying improvements
  • BEFORE APPLYING: Read the reference for detailed examples, good/bad patterns, and constraints
  • EDGE CASE: If request scope is ambiguous, stop and ask a clarifying question before applying changes
  • EDGE CASE: If required inputs, files, or tooling are missing, report what is missing and ask whether to proceed with setup guidance
Show full SKILL.md (113 more words)Show less

When to use this skill

  • Improve the code with Generics
  • Apply Generics
  • Refactor the code with Generics
  • Improve generic type safety in Java APIs
  • Fix raw types and unchecked casts in Java code

Workflow

  1. Compile project before generics changes

Run ./mvnw compile or mvn compile and stop immediately if compilation fails.

  1. Read generics reference and assess type safety

Read references/128-java-generics.md and identify raw types, unsafe casts, wildcard misuse, and API variance opportunities.

  1. Apply generics refactorings

Implement selected generic type and API improvements while preserving behavior.

  1. Verify with full build

Run ./mvnw clean verify or mvn clean verify after applying improvements.

Reference

For detailed guidance, examples, and constraints, see references/128-java-generics.md.

© jabrena, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/128-java-generics of jabrena/plinth.

  • SKILL.md
  • references/128-java-generics.md

Open the folder on GitHubat commit dca88dc

Compare with similar skills

128 Java Generics next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

128 Java Generics compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
128 Java Generics this skilljabrena/plinth446—~956Automated safety check: PassApache-2.0
RTK Rust Design Patternsrtk-ai/rtk83k—~1.9kAutomated safety check: PassApache-2.0
Dignified Python Standardsdocling-project/docling69k—~1.5kAutomated safety check: PassApache-2.0
Nuqstrycompai/crm11k1 repos~1.7kAutomated safety check: PassMIT
AST Visitor Pattern for Unionsprisma/orm48k—~830Automated safety check: PassApache-2.0
Valgocohesivestack/valgo508—~2.4kAutomated safety check: PassMIT

Similar skills

  • Describes seven Rust design patterns for the RTK CLI filter modules, with when to use each, RTK examples, and notes on when a pattern is overkill.

    83k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Dignified Python Standards

    docling-project/docling

    Applies opinionated production Python conventions chosen by the project's Python version: modern type syntax, pathlib, explicit checks and interface guidance.

    69k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Nuqs

    trycompai/crm

    nuqs (type-safe URL query state) best practices for Next.js and other React frameworks.

    11k GitHub starsUsed in 1 repo~1.7k tokens
    DevelopmentAuto-check passed
  • Official

    Replaces a plain TypeScript union plus switch statements with frozen subclasses and a visitor interface when several places dispatch on the same variants.

    48k GitHub stars~830 tokensUpdated today
    DevelopmentAuto-check passed
  • Valgo

    cohesivestack/valgo

    Add, refactor, debug, review, explain, or migrate type-safe validation in consumer Go applications using github.com/cohesivestack/valgo.

    508 GitHub stars~2.4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Vue Best Practices

    oyjt/uniapp-vue3-template

    Vue 3 and Vue.js best practices for TypeScript, vue-tsc, and Volar.

    627 GitHub starsUsed in 3 repos~667 tokens
    DevelopmentAuto-check passed

More from jabrena/plinth

All 124 skills in this repo
  • A skill your agent uses when you need to add or review fuzz testing for Java APIs with CATS — including contract-driven negative testing, malformed payload validation, boundary input exploration, CI…

    446 GitHub stars~874 tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when you need to generate Java project diagrams — including UML sequence diagrams, UML class diagrams, C4 model diagrams, UML state machine diagrams, UML Deployment Diagrams…

    446 GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when you need to add or configure Maven plugins in your pom.xml — including quality tools (enforcer, surefire, failsafe, jacoco, pitest, spotbugs, pmd), security scanning…

    446 GitHub stars~3.2k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when you need to set up JMeter performance testing for a Java project — including creating the run-jmeter.sh script from the exact template, configuring load tests with…

    446 GitHub stars~842 tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when you need to set up Java application profiling to detect and measure performance issues — including trusted preinstalled async-profiler v4.x setup, problem-driven…

    446 GitHub stars~903 tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when you need to generate a checklist document with embedded commands inventory, following the embedded template exactly and producing INVENTORY-COMMANDS-JAVA.md in the…

    446 GitHub stars~697 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about 128 Java Generics

What does 128 Java Generics do?

A skill your agent uses when you need to review, improve, or refactor Java code for generics quality — including avoiding raw types, applying the PECS (Producer Extends Consumer Super) principle for…. 128 Java Generics is an agent skill from jabrena/plinth.

When should I use 128 Java Generics?

128 Java Generics fits situations like: you need to review; refactor Java code for generics quality — including avoiding raw types; applying the PECS (Producer Extends Consumer Super) principle for wildcards; using bounded type parameters.

How do I install 128 Java Generics in Claude Code?

Run `npx skills add jabrena/plinth --skill 128-java-generics -a claude-code`. Or copy the skill folder (skills/128-java-generics in jabrena/plinth) into .claude/skills/128-java-generics in your project. Claude Code loads it when a task matches its description.

How do I install 128 Java Generics in Codex?

Run `npx skills add jabrena/plinth --skill 128-java-generics -a codex`. Or copy the skill folder (skills/128-java-generics in jabrena/plinth) into .agents/skills/128-java-generics in your project. Codex loads it when a task matches its description.

Can I use 128 Java Generics in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jabrena/plinth --skill 128-java-generics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/128-java-generics, .gemini/skills/128-java-generics, .github/skills/128-java-generics and .opencode/skills/128-java-generics in your project.

What does 128 Java Generics need to run?

Going by SKILL.md and its folder, 128 Java Generics needs the command-line tools its instructions call (mvn).

Does 128 Java Generics access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is 128 Java Generics safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does 128 Java Generics use?

128 Java Generics is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does 128 Java Generics use?

About 956 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 15k tokens, read only when the agent opens those files.

What are the alternatives to 128 Java Generics?

Skills that share tags, products or a category with 128 Java Generics: RTK Rust Design Patterns (rtk-ai/rtk, 83k stars), Dignified Python Standards (docling-project/docling, 69k stars), Nuqs (trycompai/crm, 11k stars) and AST Visitor Pattern for Unions (prisma/orm, 48k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains 128 Java Generics?

jabrena (a GitHub user) maintains it in jabrena/plinth, which has 446 GitHub stars. The repository holds 124 skills in this directory. The repository was last updated on October 7, 2026.

Source: jabrena/plinth on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.