# Well Log Interpreter

> A Claude skill from ttracx/oil-and-gas-claude-skills.

- **Type:** Skill
- **Install:** `agentstack add skill-ttracx-oil-and-gas-claude-skills-well-log-interpreter`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ttracx](https://agentstack.voostack.com/s/ttracx)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ttracx](https://github.com/ttracx)
- **Source:** https://github.com/ttracx/oil-and-gas-claude-skills/tree/main/skills/well_log_interpreter

## Install

```sh
agentstack add skill-ttracx-oil-and-gas-claude-skills-well-log-interpreter
```

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

## About

# Well Log Interpreter

## What this skill does

Parses LAS 2.0/3.0 and DLIS well log files, identifies and normalizes curve mnemonics, computes standard petrophysical properties, picks formation tops, identifies net pay intervals, and generates an interpreted log summary. Flags data quality issues and zones requiring manual review.

## When to use

- User uploads or references LAS or DLIS files
- User asks to interpret well logs, compute porosity, or find pay zones
- User needs formation tops picked or updated
- User wants petrophysical properties for a specific interval
- User is building a reservoir summary and needs log-derived inputs

## Trigger phrases

- "Interpret this LAS file"
- "Analyze the well logs for this well"
- "Find pay zones in these logs"
- "Compute porosity and water saturation from the log"
- "Pick formation tops from this log"
- "What formations are present in this LAS file?"
- "Calculate net pay for the Eagle Ford interval"
- "Summarize the petrophysical properties for the target zone"

## Inputs

- LAS 2.0 or LAS 3.0 file (`.las`)
- DLIS log container (`.dlis`)
- Optional: formation top depths from offset wells or geological model
- Optional: fluid contacts (OWC, GOC, GWC)
- Optional: cutoff parameters (GR cutoff, Sw cutoff, porosity cutoff)

## Outputs

- Curve inventory: mnemonics, units, depth range, data quality
- Formation top picks with depth in MD and TVD
- Net pay summary per zone (gross, net, N/G ratio)
- Petrophysical properties per zone (Vsh, PHIE, Sw, pay flag)
- Zone-by-zone interpretation summary
- Data quality report (bad hole, rugosity, statistical outliers)
- Quality flags per curve and per zone

## Curves interpreted

### Input curves (auto-detected by mnemonic alias)
| Curve family | Common mnemonics |
|---|---|
| Depth | DEPT, DEPTH, MD, TVDSS |
| Gamma ray | GR, GRC, SGR, CGR |
| Deep resistivity | RT, RD, RILD, RDEEP, ILD |
| Density | RHOB, DEN, RHOZ |
| Neutron porosity | NPHI, TNPH, CNCF, APLC |
| Sonic | DT, DTCO, AC |
| Caliper | CAL, CALI, C1, C2 |
| Photoelectric | PE, PEF |
| Spontaneous potential | SP |

### Computed curves (derived outputs)
| Curve | Formula | Units |
|---|---|---|
| Vsh_GR | (GR - GR_clean) / (GR_shale - GR_clean) | fraction |
| PHID | (RHOB_ma - RHOB) / (RHOB_ma - RHOB_fl) | fraction |
| PHIN | Directly from NPHI curve | fraction |
| PHIE | (PHID + PHIN) / 2 — Vsh correction applied | fraction |
| Sw_Archie | (a / (Rw × PHIE^m))^(1/n) from Rt | fraction |
| pay_flag | 1 if Vsh  cutoff | binary |

## Default cutoffs (overridable)

| Parameter | Default | Description |
|---|---|---|
| GR_clean | 20 GAPI | Clean sand/carbonate gamma ray |
| GR_shale | 120 GAPI | Pure shale gamma ray |
| Vsh_cutoff | 0.40 | Maximum shale volume for pay |
| PHIE_cutoff | 0.06 | Minimum effective porosity for pay |
| Sw_cutoff | 0.60 | Maximum water saturation for pay |
| RHOB_matrix | 2.65 g/cc | Quartz sandstone default |
| RHOB_fluid | 1.00 g/cc | Fresh water default |
| Rw | 0.05 ohm-m | Formation water resistivity |
| a | 0.62 | Archie tortuosity factor |
| m | 2.15 | Archie cementation exponent |
| n | 2.00 | Archie saturation exponent |

All defaults are overridable per zone or for the full well.

## Formation top picking logic

1. Compute smoothed GR, density, and resistivity trends
2. Identify significant inflection points or step changes
3. Match inflection depths against user-provided top list or known regional markers
4. Assign confidence score based on sharpness of the transition
5. Flag picks within bad hole intervals (caliper > 2× bit size)

## Pay identification

A zone is flagged as pay when all three conditions are met:
- `Vsh  PHIE_cutoff` (sufficient porosity)
- `Sw  (bit size + 2 inches) as rugose or washed out. In bad hole:
- Density readings are unreliable
- Neutron readings may be high
- Computed Vsh and porosity should be used with caution
- Mark affected depth ranges in quality flags

## Example response

```
WELL LOG INTERPRETATION — Eagle Ford A12H
══════════════════════════════════════════
Log depth range:  7,500 – 9,200 ft MD
Curves present:   GR, RT, RHOB, NPHI, DT, CAL (6 curves)

FORMATION TOPS PICKED
──────────────────────
Austin Chalk:     7,500 ft MD   (confidence 0.82)
Eagle Ford Shale: 7,840 ft MD   (confidence 0.91)
Buda Limestone:   8,650 ft MD   (confidence 0.87)

NET PAY SUMMARY — Eagle Ford Interval (7,840 – 8,650 ft)
───────────────────────────────────────────────────────
Gross interval:   810 ft
Net pay:          380 ft
N/G ratio:        0.47
Avg Vsh:          0.28
Avg PHIE:         0.09
Avg Sw:           0.42

⚠ Quality flags:
  - Bad hole interval 8,100–8,180 ft (caliper > 12.5 in): density interpretation unreliable
  - NPHI missing below 8,500 ft: porosity computed from density only
```

## Source & license

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

- **Author:** [ttracx](https://github.com/ttracx)
- **Source:** [ttracx/oil-and-gas-claude-skills](https://github.com/ttracx/oil-and-gas-claude-skills)
- **License:** MIT

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-ttracx-oil-and-gas-claude-skills-well-log-interpreter
- Seller: https://agentstack.voostack.com/s/ttracx
- 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%.