neqsim-api-patterns SKILL.md skillA

neqsim-api-patterns from equinor/neqsim is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add equinor/neqsim/neqsim-api-patterns@git:20261026.7e867ed

Pins git:20261026.7e867ed in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
equinor/neqsim
Path
.github/skills/neqsim-api-patterns/SKILL.md
Versions recorded
16
Latest version
git:20261026.7e867ed, committed Oct 26, 2026
First version recorded
Jul 11, 2026
Size
68,822 bytes
Repository stars
167
License
Apache-2.0

NeqSim Java/Python API patterns for fluids, flashes, process equipment and units. USE WHEN: selecting EOS/mixing-rule selection and property retrieval, including viscosity, thermal conductivity, binary/effective diffusion, gas-oil-water interfacial tension and black-oil PVT table conversion. Follow linked references for exact model selection, initialization and tested examples.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# NeqSim API Patterns

Copy-paste reference for common NeqSim operations. All Java code must be Java 8 compatible.

Use progressive disclosure: search headings and read only the task-relevant section.
For property-model selection, diffusion or gas-oil-water interfacial tension, read
[references/physical-properties.md](references/physical-properties.md) and its tested guides.
For black-oil tables, conversion and reservoir export, use `docs/blackoil/README.md` and
the `pvt-simulation` agent. For APIs absent from this recipe list, follow
[source/runtime discovery](../../../docs/development/AGENT_CAPABILITY_DISCOVERY.md).

## MCP server vs. Python/Java API — which to use

**Default policy: MCP first.** For any single calculation, always check whether
a NeqSim MCP tool (`mcp_neqsim_*`) already covers it before writing Python or
Java. Only drop to code when MCP genuinely cannot do the job. Concretely:

1. **Curated tool exists** (`runFlash`, `runProcess`, `runPVT`, `getPhaseEnvelope`,
   `sizeEquipment`, `calculateStandard`, `runFlowAssurance`, `runBatch`, ...) →
   use it directly. Confirm field names with `getSchema`/`validateInput` first.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add equinor/neqsim/neqsim-api-patterns@sha256:8e73b933880ce0b3

The line at the top of this page pins the label git:20261026.7e867ed, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ythc6mxrricyjcy5.svg)](https://markdownregistry.com/a/art_ythc6mxrricyjcy5)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 16 versions of this file, between Jul 11, 2026 and Oct 26, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
git:20261026.7e867ed latest2026-10-26 7e867ed 68,822 BA view · diff
git:20261026.b2bf93b2026-10-26 b2bf93b 67,458 BA view · diff
git:20261025.a31b8bb2026-10-25 a31b8bb 67,452 BA view · diff
git:20261024.ab0a14e2026-10-24 ab0a14e 66,591 BA view · diff
git:20261012.7dc323b2026-10-12 7dc323b 65,638 BA view · diff
git:20260920.f0088952026-09-20 f008895 63,658 BA view · diff
git:20260920.c10428e2026-09-20 c10428e 62,287 BA view · diff
git:20260919.77c34a02026-09-19 77c34a0 60,271 BA view · diff
git:20260918.8a98ac12026-09-18 8a98ac1 58,865 BA view · diff
git:20260913.7878b742026-09-13 7878b74 58,091 BA view · diff
git:20260907.9ca9ea22026-09-07 9ca9ea2 57,458 BA view · diff
git:20260822.bd077292026-08-22 bd07729 55,580 BA view · diff
git:20260821.47a11f52026-08-21 47a11f5 52,732 BA view · diff
git:20260714.fb85e052026-07-14 fb85e05 49,737 BA view · diff
git:20260713.6e09b102026-07-13 6e09b10 48,492 BA view · diff
git:20260711.237b3682026-07-11 237b368 47,560 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (68822 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

equinor/neqsim · 167 stars · license Apache-2.0 · pushed 2026-11-08 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_ythc6mxrricyjcy5
GET https://markdownregistry.com/api/v1/resolve?ref=equinor/neqsim/neqsim-api-patterns
GET https://markdownregistry.com/api/v1/blob/8e73b933880ce0b3495444176b75f27d70fd470bd92c352ab4bdc0287f1bdfb5

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from equinor/neqsim

.cursorrules Cursor rule
equinor/neqsim · .cursorrules
git:20260418.119a3f4 · audit A · 167 stars
analyze-convergence SKILL.md skill
equinor/neqsim · .github/skills/analyze-convergence/SKILL.md · Interpret flash algorithm convergence metrics, identify patterns, and produce
git:20260919.77c34a0 · audit A · 167 stars
analyze-gibbs-convergence SKILL.md skill
equinor/neqsim · .github/skills/analyze-gibbs-convergence/SKILL.md · Interpret Gibbs energy minimization convergence metrics, analyze Jacobian
git:20260919.77c34a0 · audit A · 167 stars
book-creation SKILL.md skill
equinor/neqsim · .github/skills/book-creation/SKILL.md · PaperLab skill for book creation workflows in scientific writing and book production.
git:20260919.77c34a0 · audit B · 167 stars
design-flash-benchmark SKILL.md skill
equinor/neqsim · .github/skills/design-flash-benchmark/SKILL.md · Create a structured test matrix for comparing flash algorithm performance
git:20260919.77c34a0 · audit A · 167 stars
design-reactor-benchmark SKILL.md skill
equinor/neqsim · .github/skills/design-reactor-benchmark/SKILL.md · Create a structured test matrix for evaluating Gibbs energy minimization
git:20260919.77c34a0 · audit A · 167 stars
figure-discussion SKILL.md skill
equinor/neqsim · .github/skills/figure-discussion/SKILL.md · PaperLab skill for figure discussion workflows in scientific writing and book production.
git:20260919.77c34a0 · audit A · 167 stars
generate-publication-figures SKILL.md skill
equinor/neqsim · .github/skills/generate-publication-figures/SKILL.md · Create matplotlib figures that meet journal submission standards: correct fonts,
git:20260919.77c34a0 · audit A · 167 stars
journal-formatting SKILL.md skill
equinor/neqsim · .github/skills/journal-formatting/SKILL.md · Apply journal-specific formatting rules to transform a manuscript from Markdown
git:20260919.77c34a0 · audit A · 167 stars
neqsim-acid-gas-treating SKILL.md skill
equinor/neqsim · .github/skills/neqsim-acid-gas-treating/SKILL.md · Guides NeqSim agents through acid-gas and contaminant removal with SimpleAmineAbsorber, SimpleAmineRegenerator…
git:20261004.fc23e28 · audit A · 167 stars
neqsim-advanced-control-mpc-and-virtual-sensing SKILL.md skill
equinor/neqsim · .github/skills/neqsim-advanced-control-mpc-and-virtual-sensing/SKILL.md · Guides agents through ProcessLinkedMPC, ProcessLinearizer, ModelPredictiveController, VirtualFlowMeter, SoftSensor, and…
git:20261004.fc23e28 · audit A · 167 stars
neqsim-agent-handoff SKILL.md skill
equinor/neqsim · .github/skills/neqsim-agent-handoff/SKILL.md · Agent-to-agent communication schema for NeqSim. USE WHEN: composing multi-agent pipelines where one agent's output…
git:20260926.08d0028 · audit A · 167 stars

Every file in equinor/neqsim

Browse by kind, by grade A, or by owner.