# Neqsim Economy Basis Screening

> Educational economy-basis assembly and range-check screening for prices, discount rate, currency, inflation, and tax regime. USE WHEN: a task needs a public, screening-level economic assumptions basis with sanity flags before an asset-value (NPV) screening or detailed NeqSim field-economics modelling.

- **Type:** Skill
- **Install:** `agentstack add skill-equinor-neqsim-community-skills-economy-basis-screening`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [equinor](https://agentstack.voostack.com/s/equinor)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [equinor](https://github.com/equinor)
- **Source:** https://github.com/equinor/neqsim-community-skills/tree/main/skills/field-development/economy-basis-screening
- **Website:** https://equinor.github.io/neqsimhome/

## Install

```sh
agentstack add skill-equinor-neqsim-community-skills-economy-basis-screening
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Economy Basis Screening

Use this skill to assemble and sanity-check the economic assumptions that feed a
downstream asset-value (NPV) screening: gas and oil prices, discount rate,
currency, inflation, and tax regime. It echoes a normalized basis, range-checks
the discount rate against an indicative public band, checks the tax regime
against a small public name set, and raises consistency flags. It is
intentionally simple and should guide users toward the validated NeqSim
field-economics workflow and the NeqSim MCP `runFieldEconomics` tool.

## When to Use

- When a user needs a clean, documented economic-assumptions basis before NPV work.
- When an early concept needs a discount-rate and tax-regime sanity check.
- When an agent needs an upstream "economy basis" feed for an asset-value screening chain.

## Inputs

- `gas_price_per_sm3`: gas price in the chosen currency per Sm3.
- `oil_price_per_bbl`: oil price in the chosen currency per barrel.
- `discount_rate`: real or nominal discount rate (fraction, 0-1).
- `currency`: currency code (default `USD`).
- `inflation_rate`: inflation rate (fraction, default 0).
- `real_terms`: whether the basis is in real terms (default `True`).
- `tax_regime`: tax-regime label (`generic`, `norwegian-ncs`, `uk`, `us`, `none`).

## Outputs

- `currency`, `gas_price_per_sm3`, `oil_price_per_bbl`, `discount_rate`,
  `real_terms`, `inflation_rate`, `tax_regime`.
- `discount_rate_flag`: `ok`, `low`, or `high` vs the indicative band.
- `tax_regime_recognized`: whether the regime is in the public name set.
- `basis_warning`: `ok` or `watch`.
- `flags`: human-readable consistency warnings.
- `neqsim_available`: whether the optional NeqSim package is importable.
- `assumptions`: public assumptions and required follow-up.

## Engineering Method

The skill normalizes the supplied assumptions and applies transparent checks:
the discount rate is compared against an indicative public band (default
6%-12%); the tax regime is checked against a small public name set; and
consistency flags are raised for zero-revenue, or nominal terms with zero
inflation. The verdict is `watch` when any flag is raised, otherwise `ok`.

This skill performs no fiscal, financing, currency-forward, or escalation
modelling. It is a transparent placeholder that must be replaced by a validated
NeqSim field-economics workflow for any quantitative use.

## Python Usage Pattern

```python
from economy_basis_screening import EconomyBasisModel

model = EconomyBasisModel()
result = model.evaluate(
    gas_price_per_sm3=0.30,
    oil_price_per_bbl=70.0,
    discount_rate=0.08,
    currency="USD",
    tax_regime="norwegian-ncs",
)

print(result.discount_rate_flag, result.tax_regime_recognized)
print(result.basis_warning)
for flag in result.flags:
    print(flag)
```

## Validated NeqSim Path

This screening is a placeholder. For real economic evaluation use:

- `neqsim.process.util.fielddevelopment` discounted cash-flow and field-economics
  calculators (NPV, IRR, payback) with tax-regime support.
- The NeqSim MCP `runFieldEconomics` tool for an orchestrated economic evaluation.
- The community `asset-value-npv-screening` skill for a screening NPV from a
  net cash-flow profile that uses this economy basis.

## Escalation

Escalate any `watch` verdict, and any quantitative use, to a validated NeqSim
field-economics workflow and qualified commercial review.

## Validation Checklist

- [ ] Inputs are validated and within stated ranges.
- [ ] Examples use public data only.
- [ ] Screening assumptions are stated explicitly.
- [ ] Limitations are respected.
- [ ] Quantitative use is escalated to validated NeqSim models.

## Common Mistakes

| Symptom | Cause | Fix |
| --- | --- | --- |
| Unrealistic result | Inputs outside the screening range | Keep inputs within the stated bounds |
| Misused for design | Screening output taken as final | Escalate to validated NeqSim models |

## Limitations

- Educational screening only; not a validated design method.
- No confidential data or proprietary methods are included.
- Escalate any quantitative or design use to validated NeqSim workflows.

## References

- NeqSim repository: https://github.com/equinor/neqsim
- NeqSim Skills Guide: https://github.com/equinor/neqsim/blob/master/docs/integration/skills_guide.md

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [equinor](https://github.com/equinor)
- **Source:** [equinor/neqsim-community-skills](https://github.com/equinor/neqsim-community-skills)
- **License:** Apache-2.0
- **Homepage:** https://equinor.github.io/neqsimhome/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-equinor-neqsim-community-skills-economy-basis-screening
- Seller: https://agentstack.voostack.com/s/equinor
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.