well-forecasting

A workflow for forecasting future oil and gas well production from past output and comparable wells. It is intended for reservoir engineers working on deals or valuations.

In plain words
What is it for?
Use it to assess well performance, choose decline assumptions, test their effects, and produce forecasts for deal valuation.
Why use it?
It helps turn incomplete production history into a reasoned forecast, while avoiding false precision and overfitting past results. The forecast can then support an economic valuation.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/crude-code/mcp-app/well-forecasting
Any agent
npx skills add crude-code/mcp-app --skill well-forecasting
Clone the repo
git clone --depth 1 https://github.com/crude-code/mcp-app

Made for: Claude Code, Codex.

Per session 57 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 7,949 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00057 $0.07949
Opus 5 $0.00028 $0.03974
Sonnet 5 $0.00011 $0.01590
Haiku 4.5 $0.00006 $0.00795

Measured 2d ago against content hash 433e445c3030, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

well-forecasting scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/well-forecasting/SKILL.md · 631 lines

How it starts

The opening of the file, as written. The whole thing — 631 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Well Forecasting

The job

You are the reservoir engineer on this deal. The server is your calculator and your filing cabinet — it evaluates curves exactly, echoes consequences, and remembers what you committed. It never chooses a parameter. Every judgment is yours.

The objective is to predict future production. Fit against historical data is never the objective and never evidence that a forecast is good. History is evidence to be weighed, not a target to be matched.

Optimize the next 12 months. This forecast feeds a valuation that gets redone every month as new production arrives, and present value front-loads the near term — so the job is to be right about the next year, every time, not to be precious about year 15.

Where evidence is thin, borrow from the population or carry a range. Never fake precision.

Forecasting is not two methods — a decline-curve branch for producers and a type-curve branch for everything else. It is one method on a continuum: every forecast blends what the well has said with what its population says, weighted by how much the well has said. One reported month — you don't even know it's the peak — is forecast almost entirely from analogs. Seven months in, the level is the well's own but Di and b still come from the population, checked against what little slope the well shows. Three clean years and the well carries its forecast. The analog method (below) is not the non-producer branch; it is the population end of every forecast.

Know the documented bias of this profession: lookback studies consistently find production forecasts skew high — flush-anchored qi's, transient declines ridden too long, analog sets built from survivors. When your well-trend read and your analog-constrained read diverge, take the lower unless you can say why this well earns the higher one.

This is not pattern recognition. The worked examples at the end demonstrate a procedure — the same questions answered on different wells with different outcomes. They are not templates. Never classify a well as "like" an example and import its treatment or numbers. A rationale that argues by analogy to an example instead of from this well's own months is wrong even if the numbers land fine.

Read the full file on GitHub · 631 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 631 lines · 57 tokens per session scan A 433e445c3030

Subscribe to this mod's changes

well-forecasting is a skill published in the GitHub repository crude-code/mcp-app (4 stars, last pushed 3d ago), licensed Apache-2.0. It adds 57 tokens to every session and 7,949 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

monte-carlo

Use when the user wants Monte Carlo simulation of a PlanExe model — sampling from bounds to produce output distributions (mean/std/percentiles), threshold pass probabilities, and Pearson-correlation sensitivity rankings — given an extract-parameters-from-full JSON, a generate-bounds JSON, a generate-calculations…

PlanExeOrg/PlanExe · 71 tokens

fin-paper-figure

Generate academic-quality figures (>=300 DPI) for economics and finance papers.

csmar432/finai-research · 14 tokens

de-portfolio-opt

差分进化(DE)组合优化。用户说「DE组合优化」「差分进化权重」「/de-portfolio-opt」时使用。长仅权重最大化样本夏普;纯 Python。默认 createweb。.

Travisun/Opptrix · 56 tokens

hht-timing

改进 HHT 择时(相位代理)。用户说「HHT」「希尔伯特」「EMD择时」「/hht-timing」时使用。无 EMD 库时用包络/相位近似并 meta.degraded。默认 createweb。.

Travisun/Opptrix · 65 tokens

quant-experiment-runtime

Quant research experiment executor: discover an offline source database under the workdir's code-repo, build a panel, run a Research Artifact's entry point to compute research-object values, and evaluate IC/ICIR/RANKIC/coverage metrics. Runtime = Experiment Executor; it runs a Research Artifact via a Python-native…

CamusGIT/EvoQuant · 179 tokens

fin-paper-writing

经济金融论文写作编排器。根据PAPEROUTLINE.md和REFINEDDESIGN.md,编排调用fin-paper-draft(正文写作)、fin-paper-figure(图表生成)、fin-review-loop(review循环),管理版本并确保章节间的一致性。.

csmar432/finai-research · 65 tokens