neqsim-troubleshooting SKILL.md skillA

neqsim-troubleshooting 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-troubleshooting@git:20261016.d652b1d

Pins git:20261016.d652b1d 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-troubleshooting/SKILL.md
Versions recorded
10
Latest version
git:20261016.d652b1d, committed Oct 16, 2026
First version recorded
Jul 30, 2026
Size
33,933 bytes
Repository stars
167
License
Apache-2.0

Troubleshooting playbook for common NeqSim failures. USE WHEN: a simulation fails to converge, produces unexpected results, throws exceptions, or gives zero/NaN values. Covers flash non-convergence, recycle divergence, equipment errors, phase identification issues, and numerical problems.

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 Troubleshooting Playbook

Ranked recovery strategies for common failure modes. Try steps in order — stop when the issue is resolved.

## Flash Non-Convergence

**Symptom:** `TPflash()` or other flash throws exception or returns wrong phase count.

| Step | Action | Why It Helps |
|------|--------|-------------|
| 1 | `fluid.setMultiPhaseCheck(true)` | Enables detection of liquid-liquid splits and 3-phase regions |
| 2 | Try a different EOS: `SystemPrEos` instead of `SystemSrkEos` | PR handles heavier components better near critical |
| 3 | Check if near critical point — if $T/T_c > 0.95$ and $P/P_c > 0.8$, use volume-translated EOS: `SystemSrkEosvolcor` | Standard cubic EOS has largest errors near critical |
| 4 | Add `fluid.init(0); fluid.init(1);` before flash to force re-initialization | Clears stale internal state from prior calculations |
| 5 | Slightly perturb T or P (1 K or 0.1 bar) and re-flash | Exact phase boundary conditions can trap the solver |
| 6 | For mixtures with water + hydrocarbons, use CPA: `SystemSrkCPAstatoil` with mixing rule `10` | SRK/PR cannot model hydrogen bonding — water phase behavior is wrong |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add equinor/neqsim/neqsim-troubleshooting@sha256:333771b959014d26

The line at the top of this page pins the label git:20261016.d652b1d, 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_ptknvnm56h4yhoy5.svg)](https://markdownregistry.com/a/art_ptknvnm56h4yhoy5)

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

Versions

The registry has recorded 10 versions of this file, between Jul 30, 2026 and Oct 16, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20261016.d652b1d latest2026-10-16 d652b1d 33,933 BA view · diff
git:20261010.7b9e40b2026-10-10 7b9e40b 33,905 BA view · diff
git:20260922.93c4a712026-09-22 93c4a71 33,081 BA view · diff
git:20260912.c5ddb972026-09-12 c5ddb97 30,877 BA view · diff
git:20260912.08e460b2026-09-12 08e460b 29,054 BA view · diff
git:20260821.47a11f52026-08-21 47a11f5 27,715 BA view · diff
git:20260810.05d3ba92026-08-10 05d3ba9 26,706 BA view · diff
git:20260802.7f976a32026-08-02 7f976a3 25,082 BA view · diff
git:20260731.f620bdb2026-07-31 f620bdb 22,862 BA view · diff
git:20260730.81490822026-07-30 8149082 21,192 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 (33933 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_ptknvnm56h4yhoy5
GET https://markdownregistry.com/api/v1/resolve?ref=equinor/neqsim/neqsim-troubleshooting
GET https://markdownregistry.com/api/v1/blob/333771b959014d26e6b20a84212315fcc6377a397ff8e197dd51f33b31c6030e

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.