Agent skill

Neqsim Java8 Rules

by equinor in equinor/neqsim

Java 8 compatibility rules for NeqSim. An agent skill from equinor/neqsim.

Apache-2.0Auto-check passedDevelopment

Install Neqsim Java8 Rules

skills CLI
$ npx skills add equinor/neqsim --skill neqsim-java8-rules -a claude-code

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

GitHub CLI
$ gh skill install equinor/neqsim neqsim-java8-rules --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/equinor/neqsim.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/neqsim-java8-rules .claude/skills/neqsim-java8-rules && 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
neqsim-java8-rules
GitHub stars
156
Token cost
~1.3k tokens
SKILL.md length
408 words
Files
1
Skills in repo
66
Repo updated
First seen
Licence
Apache-2.0

At a glance

Java 8 compatibility rules for NeqSim. An agent skill from equinor/neqsim.

  • Works in 4 steps: Search for the class:… → Read constructor and method signatures… → Use only methods that actually exist… → …
  • Reviewing any Java code for NeqSim
  • SKILL.md covers Forbidden Java 9+ Features, Common var Replacements, Required Import for String… and Code Formatting (Spotless) —…, plus 4 more sections
  • Calls git

What it does

Neqsim Java8 Rules is an agent skill from equinor/neqsim. Java 8 compatibility rules for NeqSim. USE WHEN: writing or reviewing any Java code for NeqSim, including tests. Covers forbidden Java 9+ features, replacement patterns, API verification, and JavaDoc requirements. All NeqSim Java code MUST compile with Java 8.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Java. The repository describes itself as: NeqSim is a library for calculation of fluid behavior, phase equilibrium and process simulation. The licence is Apache-2.0.

When your agent uses it

  • Reviewing any Java code for NeqSim
  • Including tests

Example prompts

  • “/neqsim-java8-rules”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Search for the class: file_search("**/ClassName.java")
  2. Read constructor and method signatures from the actual source
  3. Use only methods that actually exist with correct parameter types
  4. Do NOT assume convenience overloads — check first

What it can do on your machine

Read from SKILL.md and the folder at commit 92261e0. 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:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Neqsim Java8 Rules loads about 1.3k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 408 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

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 equinor/neqsim at commit 92261e0, republished under its Apache-2.0 licence (© equinor). 408 words, ~1,285 tokens.

Download SKILL.mdSave it as .claude/skills/neqsim-java8-rules/SKILL.md (or your agent's skills folder).
name
neqsim-java8-rules
description
Java 8 compatibility rules for NeqSim. USE WHEN: writing or reviewing any Java code for NeqSim, including tests. Covers forbidden Java 9+ features, replacement patterns, API verification, and JavaDoc requirements. All NeqSim Java code MUST compile with Java 8.
last_verified
2026-07-04

Java 8 Compatibility Rules for NeqSim

All NeqSim Java code — including test classes in src/test/java/ — MUST compile with Java 8. The CI build will FAIL if you use Java 9+ features.

Forbidden Java 9+ Features

ForbiddenJava 8 Alternative
var x = ...Explicit type: String x = ..., Map<String, Object> map = ...
List.of(a, b)Arrays.asList(a, b) or Collections.singletonList(a)
Set.of(a, b)new HashSet<>(Arrays.asList(a, b))
Map.of(k, v)Collections.singletonMap(k, v) or new HashMap<>()
"str".repeat(n)StringUtils.repeat("str", n) (Apache Commons)
str.isBlank()str.trim().isEmpty()
str.strip()str.trim()
str.lines()str.split("\\R") or BufferedReader
Optional.isEmpty()!optional.isPresent()
Text blocks """..."""Regular strings with \n
RecordsRegular class with fields, constructor, getters
Pattern matching instanceofTraditional instanceof + cast
Stream.toList().collect(Collectors.toList())

Common var Replacements

java
// WRONG (Java 10+):
var map = someMethod.toMap();
var list = getItems();
var result = calculate();

// CORRECT (Java 8):
Map<String, Object> map = someMethod.toMap();
List<String> list = getItems();
CalculationResult result = calculate();

Required Import for String Repeat

java
import org.apache.commons.lang3.StringUtils;
// Usage: StringUtils.repeat("=", 70)

Code Formatting (Spotless) — MANDATORY

AI-generated Java is NOT auto-formatted. After creating or editing ANY .java file, reformat it before committing — do not rely on local pre-commit hooks being installed:

bash
./mvnw spotless:apply    # reformats Java to the project style (Eclipse profile)
./mvnw spotless:check    # verifies formatting — this is what CI runs
  • Formatter profile: .config/neqsim_formatter.xml (configured in pom.xml), applied to src/main/java and src/test/java.
  • CI runs ./mvnw spotless:check and FAILS the build on any unformatted file.
  • Run spotless:apply, then git add the reformatted files, then commit.
  • NEVER bypass the gate with git commit --no-verify.

API Verification (MANDATORY)

Before using any NeqSim class in code or examples:

  1. Search for the class: file_search("**/ClassName.java")
  2. Read constructor and method signatures from the actual source
  3. Use only methods that actually exist with correct parameter types
  4. Do NOT assume convenience overloads — check first

Common API mistakes:

  • Assuming getXxx95() when actual is getXxx(int percentile)
  • Assuming 1-arg constructors when 2+ args are required
  • Calling methods on wrong class
  • Assuming calculate() when actual is calculateRisk() or run()
Show full SKILL.md (150 more words)Show less

JavaDoc Requirements

All classes and methods (public, protected, AND private) require complete JavaDoc:

  • Class-level: description, @author, @version
  • Method-level: description, @param for every parameter, @return for non-void, @throws for each exception
  • HTML5 compatible: use <caption> in tables (no summary attribute)
  • No @see with plain text — only valid Java references
  • No lambda arrows (->) in JavaDoc code examples

Build Commands

bash
./mvnw install                            # full build
./mvnw test -Dtest=ClassName              # single test class
./mvnw test -Dtest=ClassName#methodName   # single method
./mvnw checkstyle:check spotbugs:check pmd:check  # static analysis
./mvnw javadoc:javadoc                    # verify JavaDoc

Serialization — SE_BAD_FIELD Rule (MANDATORY)

SpotBugs enforces that all instance fields in Serializable classes are either serializable themselves or marked transient. This applies to any class extending ProcessEquipmentBaseClass, MeasurementDeviceBaseClass, MechanicalDesign, thermo phase classes, or any other Serializable class.

When to use transient

Mark a field transient when its type does NOT implement Serializable:

  • Functional interfaces: Function, BiConsumer, Consumer, Supplier
  • JDBC: Connection, Statement, ResultSet
  • Threads: Thread, ExecutorService
  • Apache Commons Math: BicubicInterpolator, BicubicInterpolatingFunction, LinearInterpolator
  • Inner classes that don't implement Serializable (e.g., NetworkNode, GibbsComponent)
  • External library types not designed for serialization
Correct modifier order
java
// private fields
private transient MyType field;
private final transient List<NonSerializableInner> items = new ArrayList<>();

// package-private fields
transient SomeType field;
Verify with SpotBugs
bash
./mvnw spotbugs:check 2>&1 | Select-String "SE_BAD_FIELD"  # should return empty

© equinor, 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

Just SKILL.md in .github/skills/neqsim-java8-rules of equinor/neqsim.

Open the folder on GitHubat commit 92261e0

Compare with similar skills

Neqsim Java8 Rules 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.

Neqsim Java8 Rules compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Neqsim Java8 Rules this skillequinor/neqsim156—~1.3kAutomated safety check: PassApache-2.0
Creating Description For Gh PRredis/jedis12k—~838Automated safety check: PassMIT
Code Review Skillawesome-skills/code-review-skill2.1k—~2.8kAutomated safety check: NotesMIT
Caffeine Cache Optimization Experimentsben-manes/caffeine18k—~2.6kAutomated safety check: NotesApache-2.0
Git History Bug Auditben-manes/caffeine18k—~3.3kAutomated safety check: PassApache-2.0
CI Act Runchewiebug/GCViewer4.6k—~2.4kAutomated safety check: NotesCustom licence

Similar skills

  • Official

    Generate a clear, concise GitHub PR title and description from the diff between two local git branches, and save it to prDescription.md in the repo root.

    12k GitHub stars~838 tokensUpdated today
    DevelopmentAuto-check passed
  • Code Review Skill

    awesome-skills/code-review-skill

    Provides comprehensive code review guidance for React 19, Vue 3, Angular 17+, Svelte 5, Rust, TypeScript, Java, Java 8, PHP, Ruby, Rails, Python, Django, FastAPI, Go, C/.NET, Kotlin, Swift, Dart…

    2.1k GitHub stars~2.8k tokensUpdated 29 days ago
    DevelopmentAuto-check: notes
  • Runs controlled JMH experiments on the Caffeine cache to find shared contention and hot-path waste, then reviews correctness and returns a reviewable patch.

    18k GitHub stars~2.6k tokensUpdated 2 days ago
    DevelopmentAuto-check: notes
  • Git History Bug Audit

    ben-manes/caffeine

    Audits a module by walking its git history commit by commit, tracking unresolved issues forward, and reporting the ones that survive to HEAD as findings.

    18k GitHub stars~3.3k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • CI Act Run

    chewiebug/GCViewer

    Run the full build-and-deploy.yaml workflow locally via act + Docker.

    4.6k GitHub stars~2.4k tokensUpdated 3 mo ago
    DevelopmentAuto-check: notes
  • Code Nest Project Spec

    xiaou61/Code-Nest

    Code-Nest 多模块全栈项目协作规范与落点导航。Use when modifying this repository for feature development, bug fixing, refactor, API change, SQL migration, or frontend-backend联调 so changes land in the correct module…

    770 GitHub stars~1.3k tokensUpdated 27 days ago
    DevelopmentAuto-check passed

More from equinor/neqsim

All 66 skills in this repo
  • Guides NeqSim agents through acid-gas and contaminant removal with SimpleAmineAbsorber, SimpleAmineRegenerator, SystemKentEisenberg, SystemDesmukhMather, RateBasedAbsorber, MembraneSeparator, and…

    156 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Guides agents through ProcessLinkedMPC, ProcessLinearizer, ModelPredictiveController, VirtualFlowMeter, SoftSensor, and DataReconciliationEngine.

    156 GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Neqsim Agent Handoff

    equinor/neqsim

    Agent-to-agent communication schema for NeqSim. An agent skill from equinor/neqsim.

    156 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Autonomous observe-hypothesize-predict-test-discriminate loop for operational anomalies.

    156 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Equipment capacity constraints, bottlenecks, utilization snapshots, KPI/response DTOs, validated automation writes and GOR/MPFM rate fitting (CapacityConstraint, BottleneckTracker…

    156 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Neqsim Ccs Hydrogen

    equinor/neqsim

    CO2 capture, transport, storage (CCS) and hydrogen systems patterns for NeqSim.

    156 GitHub stars~3.8k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Neqsim Java8 Rules

What does Neqsim Java8 Rules do?

Java 8 compatibility rules for NeqSim. An agent skill from equinor/neqsim. Neqsim Java8 Rules is an agent skill from equinor/neqsim. Java 8 compatibility rules for NeqSim.

When should I use Neqsim Java8 Rules?

Neqsim Java8 Rules fits situations like: reviewing any Java code for NeqSim; including tests.

How do I install Neqsim Java8 Rules in Claude Code?

Run `npx skills add equinor/neqsim --skill neqsim-java8-rules -a claude-code`. Or copy the skill folder (.github/skills/neqsim-java8-rules in equinor/neqsim) into .claude/skills/neqsim-java8-rules in your project. Claude Code loads it when a task matches its description.

How do I install Neqsim Java8 Rules in Codex?

Run `npx skills add equinor/neqsim --skill neqsim-java8-rules -a codex`. Or copy the skill folder (.github/skills/neqsim-java8-rules in equinor/neqsim) into .agents/skills/neqsim-java8-rules in your project. Codex loads it when a task matches its description.

Can I use Neqsim Java8 Rules 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 equinor/neqsim --skill neqsim-java8-rules -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/neqsim-java8-rules, .gemini/skills/neqsim-java8-rules, .github/skills/neqsim-java8-rules and .opencode/skills/neqsim-java8-rules in your project.

What does Neqsim Java8 Rules need to run?

Going by SKILL.md and its folder, Neqsim Java8 Rules needs the command-line tools its instructions call (git).

Does Neqsim Java8 Rules access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Neqsim Java8 Rules 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 Neqsim Java8 Rules use?

Neqsim Java8 Rules is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Neqsim Java8 Rules use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Neqsim Java8 Rules?

Skills that share tags, products or a category with Neqsim Java8 Rules: Creating Description For Gh PR (redis/jedis, 12k stars), Code Review Skill (awesome-skills/code-review-skill, 2.1k stars), Caffeine Cache Optimization Experiments (ben-manes/caffeine, 18k stars) and Git History Bug Audit (ben-manes/caffeine, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Neqsim Java8 Rules?

equinor (a GitHub organization) maintains it in equinor/neqsim, which has 156 GitHub stars. The repository holds 66 skills in this directory. The repository was last updated on October 7, 2026.

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