neqsim-ncs-ownership-equity
Skill4 starsChanged 5 months agoApache-2.0View on GitHub
Reads who owns Norwegian Continental Shelf fields, discoveries and licences from Sodir (partners, equity %, operator, history, company portfolio) and turns it into net-equity inputs for field evaluation and economics. Prospect equity is not public: user-supplied or a labelled licence proxy. USE WHEN: an evaluation needs partners and working interests, a net-to-company view of volumes, capex, opex or cash flow, a portfolio roll-up, or a check of an equity assumption.
In this repository90 other files it gives its agents.
- neqsim-document-intelligence-extractionSkill
- neqsim-co2-emissions-screeningSkill
- neqsim-energy-emissions-screeningSkill
- neqsim-weather-dataSkill
- neqsim-anp-open-dataSkill
- neqsim-artificial-lift-screeningSkill
- neqsim-asset-value-npv-screeningSkill
- neqsim-capex-opex-screeningSkill
- neqsim-design-basis-screeningSkill
- neqsim-economy-basis-screeningSkill
- neqsim-ncs-infrastructure-networkSkill
- neqsim-ncs-value-chain-optimizationSkill
- neqsim-norwegian-continental-shelf-dataSkill
- neqsim-psc-bid-economics-screeningSkill
- neqsim-reservoir-depletion-screeningSkill
- neqsim-reservoir-facility-value-chainSkill
- neqsim-reservoir-model-builderSkill
- neqsim-resource-classification-screeningSkill
- neqsim-hydrate-margin-checkSkill
- neqsim-hydrate-screeningSkill
- neqsim-multiphase-flow-slug-screeningSkill
- neqsim-olga-multiphase-simulatorSkill
- neqsim-produced-water-scale-screeningSkill
- neqsim-surf-cooldown-screeningSkill
- neqsim-two-phase-flow-regime-screeningSkill
- neqsim-wax-margin-checkSkill
- neqsim-acoustic-induced-vibration-screeningSkill
- neqsim-adsorbent-capillary-condensation-screeningSkill
- neqsim-ageing-life-extension-screeningSkill
- neqsim-cfd-couplingSkill
- neqsim-compressor-antisurge-recycleSkill
- neqsim-compressor-operating-window-checkSkill
- neqsim-compressor-power-screeningSkill
- neqsim-continuous-improvement-toolkitSkill
- neqsim-control-authority-screeningSkill
- neqsim-control-valve-cv-screeningSkill
- neqsim-dry-gas-seal-screeningSkill
- neqsim-dynamic-instrument-controller-setupSkill
- neqsim-dynamic-process-preparationSkill
- neqsim-fem-couplingSkill
- neqsim-fired-heater-duty-screeningSkill
- neqsim-flow-induced-vibration-screeningSkill
- neqsim-gas-scrubber-sizing-screeningSkill
- neqsim-gas-turbine-performance-screeningSkill
- neqsim-heat-exchanger-fouling-assessmentSkill
- neqsim-line-velocity-checkSkill
- neqsim-noise-screeningSkill
- neqsim-pipe-wall-thickness-screeningSkill
- neqsim-piping-flexibility-screeningSkill
- neqsim-pressure-drop-screeningSkill
- neqsim-pump-hydraulics-screeningSkill
- neqsim-reciprocating-compressor-screeningSkill
- neqsim-reliability-data-screeningSkill
- neqsim-sand-erosion-screeningSkill
- neqsim-separator-modellingSkill
- neqsim-teg-dehydration-modelingSkill
- neqsim-uncertainty-quantificationSkill
- neqsim-utility-balance-screeningSkill
- neqsim-water-dewpoint-dehydration-screeningSkill
- neqsim-benchmark-reference-dataSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 0 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 76
Fields: read the licensee history, keep the rows valid on as_of, take the operator from the field operator history.
- Very specific: line 78
Discoveries: read the owner history, keep the owner valid on as_of, read the owner id from its Sodir URL, then read that licence's or …
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
NCS Ownership and Equity
This skill answers "who owns what share of this asset?" for the Norwegian Continental Shelf and hands the answer to field evaluation and economics. It reads the Sodir DataService, which publishes ownership openly (NLOD 2.0), and needs no key.
| Asset | Public? | How it is read |
| Field | Yes | Sodir field_licensee_hst (layer 7108): company, share %, owner (licence or unit), valid dates |
| Discovery | Yes, via its owner | Sodir discovery_owner_hst (7007) gives the owning licence or unit; that owner's licensees (3007 licence, 3304 unit) give the shares |
| Production licence | Yes | Sodir licence_licensee_hst (3007); operator flagged by prlOperDateValid* |
| Prospect | No | Not published at prospect level. Use the user's own figures, or the licence it sits in as a labelled proxy |
It is a lookup and arithmetic skill. It does not compute volumes, prices, fiscal terms or NPV; it supplies the equity fractions those steps multiply by.
When to Use
- A field or discovery evaluation needs the partners and their working interests.
- A company wants its net share of gross volumes, revenue, capex, opex or cash flow.
- A portfolio view is needed: every field and discovery in which one company holds an interest.
- An equity assumption in a model must be checked against the public record.
- A prospect needs an equity table. The skill validates user figures or shows the licence proxy.
- Ownership changed (sale, merger, unitisation) and the history matters for a back-cast.
Inputs
OwnershipReader()reads live Sodir. Passfetch=to run offline.- Names resolve loosely and case-insensitively:
"Troll","Wisting","7324/8-1 (Wisting)". Several matches raiseOwnershipErrorlisting the candidates. - Production licences are named by the bare number:
reader.licence("1252")works,"PL1252"raisesno production licence named 'PL1252'(verified 2026-10-09). as_ofis a date (default today). Interests are valid from the start date to the inclusive end date; an empty end is open.- Companies for
portfolio()are a name or a Sodir company id. An ambiguous name (for example two Equinor entities) raises with the ids to choose from.
Outputs
OwnershipRecord with kind, name, as_of, basis, stakes (company, id,
interest %, operator flag, valid dates), owner_kind, owner_name, operator,
included_in_field, last_updated, total_pct, is_complete and warnings.
fractions(),fraction_of(company),find(company)allocate(gross)for every partner,net(gross, company)for one; lists or{year: value}mappings both workto_economics_handoff(company): equity fractions, caveats and a scaling noteportfolio_net([(record, gross), ...], company): sums a company's net over assetsOwnershipReader.history("field" | "licence", name): ownership periods, oldest firstportfolio(company, as_of): every field and discovery held, with interest %licence_milestones(licence): the licence work obligations (drill-or-drop, decision to continue, plan for development) with deadlines as local Europe/Oslo dates. Sodir stores a deadline as local midnight, so reading the epoch as UTC (to_date) gives the previous day; useto_local_datefor deadlines.
basis is sodir_public, licence_proxy or user_provided. Carry it into any
report so the reader knows how firm the equity is.
Engineering Method
- Resolve the name against the field or discovery layer (exact match first, then substring); stop on ambiguity.
- Fields: read the licensee history, keep the rows valid on
as_of, take the operator from the field operator history. - Discoveries: read the owner history, keep the owner valid on
as_of, read the owner id from its Sodir URL, then read that licence's or unit's licensees. The operator comes from the discovery operator history. - Check that the interests add up to 100 %. A shortfall is a warning, not a silent fix.
- Apply equity by multiplying gross volumes, revenue, capex and opex by the fraction. Tax is a per-company calculation on the net cash flow: do not scale a gross tax figure.
Python Usage Pattern
from datetime import date
from ncs_ownership_equity import OwnershipReader, portfolio_net
reader = OwnershipReader()
alvheim = reader.field("Alvheim") # equity today
alvheim.fractions() # {'Aker BP ASA': 0.8, 'ConocoPhillips ...': 0.2}
wisting = reader.discovery("Wisting") # via licence 537
wisting.operator, wisting.is_complete
gross_capex = {2028: 12000.0, 2029: 18000.0} # MNOK, gross
wisting.net(gross_capex, "Aker BP") # Aker BP's share
# Prospect: Sodir has no prospect equity. Enter your own, or show the licence proxy.
prospect = OwnershipReader.prospect("Delta", {"Opco AS": 60, "Partner AS": 40}, operator="Opco AS",
source="licence group agreement 2026-05")
proxy = reader.prospect_from_licence("Delta", "537") # basis = licence_proxy, with a warning
# Company view: portfolio and a net cash-flow roll-up
reader.portfolio("Aker BP ASA")["items"][:5]
portfolio_net([(alvheim, alvheim_cash), (wisting, wisting_cash)], "Aker BP")
# Back-cast an earlier equity
reader.field("Alvheim", date(2019, 1, 1)).fractions()Hand-offs
- Gross volumes and reserves:
neqsim-norwegian-continental-shelf-dataandneqsim-resource-classification-screening. - Economics: pass
to_economics_handoff()or the net series toneqsim-asset-value-npv-screening,neqsim-field-economicsandneqsim-capex-opex-screening. - Tie-in and host studies:
neqsim-ncs-infrastructure-networkfor hosts and routes; equity decides who carries the tariff and host costs. - Governed internal sources (portfolio registers, signed agreements) belong to the enterprise layer and override the public record where they differ.
Validation Checklist
basisandas_ofare stated in the report.is_completeis true, or the shortfall is explained.- A discovery with
included_in_fieldwas evaluated through the field's equity. - Unit (business arrangement area) equity was used, not the pre-unit licence equity.
- Prospect equity is labelled user-provided or licence proxy, never public.
last_updatedis recent; any known pending transfer is noted separately.- Net figures sum back to the gross figure across all partners.
Common Mistakes
- Using the licence equity for a field that has been unitised: the unit equity differs after redetermination. Read the field, not the licence.
- Reading a discovery that is already part of a field as a standalone asset.
- Treating
sdfi_pctas extra: it sits inside a partner's share and is informational. - Scaling a gross tax number by equity instead of taxing each company's net flow.
- Using a company name that matches two legal entities; pass the company id.
- Assuming a pending sale is in the data. Sodir shows approved transfers only.
- Presenting the licence proxy as prospect equity.
Limitations
- Sodir publishes approved ownership; announced or pending transfers, farm-in carries, back-in rights and private side agreements are not in it.
- Prospect-level equity and cost-sharing are not public.
- Norwegian shelf only. Other provinces need their own source.
- Data currency follows Sodir's update date (
last_updated). - Screening only: a qualified commercial review is required before any investment use.
Related NeqSim Functionality
neqsim.process.fielddevelopment.economics classes (cash flow, fiscal regime) accept the
net series; equity itself is bookkeeping and has no Java counterpart.
References
- Sodir DataService (ArcGIS REST), layers 3003, 3007, 3304, 7000, 7006, 7007, 7100, 7108, 7110;
FactPages tables
field_licensee_hst,licence_licensee_hst. NLOD 2.0. - Sodir FactPages sections: application, wellbore, storage, licence, bsns_arr_area, field, discovery, company, survey, facility, tuf, strat (no prospect section).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

