geox-basin-interpreter (Ψ_GEOX Domain Layer)
Purpose
Subsurface reasoning for basin screening, petroleum systems analysis, trap/seal/reservoir framing, and evidence-led interpretations.
Use When
- Screening basins or prospects for petroleum systems presence (source rock, migration pathway, reservoir, trap, and seal).
- Interpretations are requested based on seismic sections, structural maps, or well-log correlations.
- Conducting subsurface risk assessments (e.g. calculation of Geological Chance of Success - GCoS).
- Verifying subsurface candidate validity against structural or stratigraphic constraints.
- Ingesting or synthesizing geologic domain lit reviews, papers, or basin reports.
Do Not Use When
- The task is purely focused on petrophysical QC, well-log curve normalization, or curve sanity checks (use
geox-well-log-audit instead).
- The task requires calculating specific fluid-flow dynamic parameters inside well casings (use standard production engineering tools).
- The task requires writing standard system scripts or web designs (use generic engineering or design skills instead).
Inputs
- Seismic/Map Data: Grid coordinates, structural mapping files, or interpretive cross-sections.
- Well Context: Core descriptions, formation picks, or petrophysical summaries.
- Geochemical Context: Total Organic Carbon (TOC) levels, thermal maturity data (Ro%), or pressure profiles.
The Five-Box GCoS Evaluation Template
Every basin/prospect screening report must output the following five-box risk matrix:
### 1. Geological Chance of Success (GCoS) Matrix
| Element | Probability (Pg) | Primary Evidence | Key Risks & Contradictions |
| :--- | :---: | :--- | :--- |
| **Source (Charge)** | `0.0 - 1.0` | e.g. TOC/Ro% measurements from analogs | e.g. Kitchen thermal migration shadow |
| **Reservoir** | `0.0 - 1.0` | e.g. Core porosity, turbidite facies maps | e.g. Deep diagenetic quartz cementation |
| **Trap** | `0.0 - 1.0` | e.g. 3D seismic horizon closure amplitude | e.g. Lateral fault seal leakage risk |
| **Seal** | `0.0 - 1.0` | e.g. Continuous regional shale interval | e.g. Crestal fault breaching |
| **Timing & Migration** | `0.0 - 1.0` | e.g. Basin modeling maturation curves | e.g. Late trap deformation |
**Composite Geological Chance of Success (GCoS):**
`Pg_total = Pg_source × Pg_reservoir × Pg_trap × Pg_seal × Pg_timing`
`Pg_total = [Calculated Value]%` (Apply Humility Band: uncertainty margin of ±0.03 to ±0.05)
Procedure
- Framework Screening: Map the active geologic basin setting (e.g., extensional rift, passive margin, foreland basin) to set stratigraphic expectations.
- Petroleum Systems Element Audit: Evaluate each of the 5 crucial elements using the Five-Box GCoS Evaluation Template.
- STDP Geologic Evidential Loop: Verify all claims. Distinguish directly measured evidence (e.g., core plugs, DST tests) from indirect indicators (e.g. seismic amplitude anomalies) and speculative inference.
- GCoS Calculation: Compute probability metrics for each element. Multiply the elements to obtain the total Chance of Success (Pg_total).
- Evidence Matrix Serialization: Document all structural contradictions or faults mapped across the basin.
Postconditions
- All geologic inferences are explicitly tagged with their data source and confidence level.
- The resulting basin interpretation maps exact GCoS risk elements with empirical justification.
- All trap/seal/reservoir maps comply with physical compaction and pressure gradients.
Failure Modes & Escalation
- Data Scarcity: No well or seismic control exists for the screened block. Action: Rely strictly on analog basins. Tag all findings as "Estimate Only - Analog Grounded" and set GCoS risk margins to conservative bounds.
- Structural Discontinuity: Mapped faults show contradictory sealing history. Action: Flag the seal parameter as a critical system hazard, degrade interpretation class to
CAUTION, and escalate for expert validation.
Telemetry per Run
{
"skill_name": "geox-basin-interpreter",
"version": "1.1.0",
"trigger_phrase": "{{trigger_phrase}}",
"selected_reason": "{{selected_reason}}",
"latency_ms": 0,
"token_in": 0,
"token_out": 0,
"commands_run": 0,
"artifacts_written": 1,
"postcondition_pass": false,
"human_approval_required": false,
"hold_code": "{{hold_code}}"
}
Recursive Scorecard
- Activation Precision: [0.0 - 1.0] (Target: >0.90)
- Task Completion Rate: [0.0 - 1.0] (Target: >0.95)
- Rollback Safety: [0.0 - 1.0] (Target: 1.00)
- Context Efficiency: [0.0 - 1.0] (Target: >0.90)
- Doc Freshness: [0.0 - 1.0] (Target: 1.00)
- Cross-Skill Collision Rate: [0.0 - 1.0] (Target: <0.02)
- Human Trust Score: [0.0 - 1.0] (Target: >0.98)
1---2name: geox-basin-interpreter3description: Subsurface reasoning for basin screening, petroleum systems analysis, trap/seal/reservoir framing, and evidence-led interpretations. Load when geology, geophysics, or petrophysics tasks appear.4version: 1.0.05---67# geox-basin-interpreter (Ψ_GEOX Domain Layer)89## Purpose10Subsurface reasoning for basin screening, petroleum systems analysis, trap/seal/reservoir framing, and evidence-led interpretations.1112## Use When131. Screening basins or prospects for petroleum systems presence (source rock, migration pathway, reservoir, trap, and seal).142. Interpretations are requested based on seismic sections, structural maps, or well-log correlations.153. Conducting subsurface risk assessments (e.g. calculation of Geological Chance of Success - GCoS).164. Verifying subsurface candidate validity against structural or stratigraphic constraints.175. Ingesting or synthesizing geologic domain lit reviews, papers, or basin reports.1819## Do Not Use When201. The task is purely focused on petrophysical QC, well-log curve normalization, or curve sanity checks (use `geox-well-log-audit` instead).212. The task requires calculating specific fluid-flow dynamic parameters inside well casings (use standard production engineering tools).223. The task requires writing standard system scripts or web designs (use generic engineering or design skills instead).2324## Inputs25* **Seismic/Map Data:** Grid coordinates, structural mapping files, or interpretive cross-sections.26* **Well Context:** Core descriptions, formation picks, or petrophysical summaries.27* **Geochemical Context:** Total Organic Carbon (TOC) levels, thermal maturity data (Ro%), or pressure profiles.2829## The Five-Box GCoS Evaluation Template3031Every basin/prospect screening report must output the following five-box risk matrix:3233```markdown34### 1. Geological Chance of Success (GCoS) Matrix3536| Element | Probability (Pg) | Primary Evidence | Key Risks & Contradictions |37| :--- | :---: | :--- | :--- |38| **Source (Charge)** | `0.0 - 1.0` | e.g. TOC/Ro% measurements from analogs | e.g. Kitchen thermal migration shadow |39| **Reservoir** | `0.0 - 1.0` | e.g. Core porosity, turbidite facies maps | e.g. Deep diagenetic quartz cementation |40| **Trap** | `0.0 - 1.0` | e.g. 3D seismic horizon closure amplitude | e.g. Lateral fault seal leakage risk |41| **Seal** | `0.0 - 1.0` | e.g. Continuous regional shale interval | e.g. Crestal fault breaching |42| **Timing & Migration** | `0.0 - 1.0` | e.g. Basin modeling maturation curves | e.g. Late trap deformation |4344**Composite Geological Chance of Success (GCoS):**45`Pg_total = Pg_source × Pg_reservoir × Pg_trap × Pg_seal × Pg_timing`46`Pg_total = [Calculated Value]%` (Apply Humility Band: uncertainty margin of ±0.03 to ±0.05)47```4849## Procedure501. **Framework Screening:** Map the active geologic basin setting (e.g., extensional rift, passive margin, foreland basin) to set stratigraphic expectations.512. **Petroleum Systems Element Audit:** Evaluate each of the 5 crucial elements using the **Five-Box GCoS Evaluation Template**.523. **STDP Geologic Evidential Loop:** Verify all claims. Distinguish *directly measured evidence* (e.g., core plugs, DST tests) from *indirect indicators* (e.g. seismic amplitude anomalies) and *speculative inference*.534. **GCoS Calculation:** Compute probability metrics for each element. Multiply the elements to obtain the total Chance of Success (Pg_total).545. **Evidence Matrix Serialization:** Document all structural contradictions or faults mapped across the basin.5556## Postconditions571. All geologic inferences are explicitly tagged with their data source and confidence level.582. The resulting basin interpretation maps exact GCoS risk elements with empirical justification.593. All trap/seal/reservoir maps comply with physical compaction and pressure gradients.6061## Failure Modes & Escalation62* **Data Scarcity:** No well or seismic control exists for the screened block. *Action:* Rely strictly on analog basins. Tag all findings as *"Estimate Only - Analog Grounded"* and set GCoS risk margins to conservative bounds.63* **Structural Discontinuity:** Mapped faults show contradictory sealing history. *Action:* Flag the seal parameter as a critical system hazard, degrade interpretation class to `CAUTION`, and escalate for expert validation.6465## Telemetry per Run66```json67{68 "skill_name": "geox-basin-interpreter",69 "version": "1.1.0",70 "trigger_phrase": "{{trigger_phrase}}",71 "selected_reason": "{{selected_reason}}",72 "latency_ms": 0,73 "token_in": 0,74 "token_out": 0,75 "commands_run": 0,76 "artifacts_written": 1,77 "postcondition_pass": false,78 "human_approval_required": false,79 "hold_code": "{{hold_code}}"80}81```8283## Recursive Scorecard84* **Activation Precision:** [0.0 - 1.0] (Target: >0.90)85* **Task Completion Rate:** [0.0 - 1.0] (Target: >0.95)86* **Rollback Safety:** [0.0 - 1.0] (Target: 1.00)87* **Context Efficiency:** [0.0 - 1.0] (Target: >0.90)88* **Doc Freshness:** [0.0 - 1.0] (Target: 1.00)89* **Cross-Skill Collision Rate:** [0.0 - 1.0] (Target: <0.02)90* **Human Trust Score:** [0.0 - 1.0] (Target: >0.98)