A Claude Code plugin for petroleum engineering research data access, built for WVU PNGE with a focus on lithium/magnesium recovery from produced waters, completions engineering, wellbore stability, and sustainability.
66 skills · 6 agents · 6 commands
| # | Skill | Source | Key? |
|---|---|---|---|
| 1 | pnge:eia-data |
EIA Open Data API v2 | Yes (free) |
| 2 | pnge:usgs-produced-waters |
USGS Produced Waters Geochemical DB v3.0 | No |
| 3 | pnge:usgs-minerals |
USGS Mineral Commodity Summaries | No |
| 4 | pnge:netl-edx |
DOE NETL Energy Data eXchange (CKAN) | Yes (free) |
| 5 | pnge:wvges-wells |
WV Geological & Economic Survey | No |
| 6 | pnge:padep-wells |
PA DEP Unconventional Well Registry (Socrata) | No |
| 7 | pnge:odnr-wells |
Ohio DNR Oil and Gas Wells (Utica/Point Pleasant) | No |
| 8 | pnge:boem-offshore |
BOEM Federal Offshore Data | No |
| 9 | pnge:fracfocus |
FracFocus Chemical Disclosure | No |
| 10 | pnge:epa-enviro |
EPA Envirofacts & ECHO | No |
| 11 | pnge:epa-ghg |
EPA GHGRP Facility Emissions | No |
| 12 | pnge:epa-ghgrp-subpartw |
EPA GHGRP Subpart W Oilfield Methane | No |
| 13 | pnge:usgs-pubs |
USGS Publications Warehouse | No |
| 14 | pnge:doe-osti |
DOE OSTI Technical Reports | No |
| 15 | pnge:netl-carbon-storage |
NETL NATCARB Atlas / CCS Projects | Yes (free, optional) |
| 16 | pnge:kggs-well-logs |
KGS Wireline Log Repository (LAS 2.0) | No |
| 17 | pnge:macrostrat |
Macrostrat Formation Stratigraphy | No |
| 18 | pnge:openalex |
OpenAlex Open-Access Literature | No |
| 19 | pnge:usgs-earthquakes |
USGS ComCat (FDSN) | No |
| 20 | pnge:usgs-waterdata |
USGS NWIS + Water Quality Portal | No |
| 21 | pnge:fred-prices |
Federal Reserve FRED | Yes (free) |
| 22 | pnge:worldbank-energy |
World Bank Open Data | No |
| 23 | pnge:comtrade-minerals |
UN Comtrade | Optional (free) |
| 24 | pnge:doe-geothermal |
DOE GDR / OpenEI | Yes (free) |
| 25 | pnge:crossref-doi |
CrossRef REST API | No |
| 26 | pnge:opec-data |
OPEC Production via EIA STEO | Yes (free) |
| 27 | pnge:iea-open |
IEA Free Datasets | No |
| 28 | pnge:wri-aqueduct |
WRI Aqueduct Water Risk | No |
| 29 | pnge:wv-tax-minerals |
WV Delinquent Mineral Properties (ArcGIS) | No |
| 30 | pnge:pa-tax-minerals |
PA Mineral Parcels Near Active Wells (ArcGIS) | No |
| 31 | pnge:oh-tax-minerals |
OH Mineral Parcels via OGRIP Land Use Codes (ArcGIS) | No |
| Skill | Purpose |
|---|---|
pnge:pnge-mechanics |
Statics, axial/beam stress, Lamé thick-wall cylinders, Mohr's circle |
pnge:frac-design |
PKN/KGD fracture models, Nolte-Smith analysis, proppant transport |
pnge:wellbore-stability |
Kirsch equations, mud weight window, breakout and fracture prediction |
pnge:petrophysics |
Log interpretation: Vsh, porosity, Sw (Archie/Simandoux), brittleness index |
pnge:artificial-lift |
Rod pump, ESP sizing, gas lift design, plunger lift, liquid loading |
pnge:flow-assurance |
Hydrates (Katz/Hammerschmidt), CO2 corrosion, H2S sour service, wax/scale |
pnge:tubing-design |
Lubinski four-effect force analysis, buckling, seal assembly, velocity strings |
pnge:perforation-design |
Karakas-Tariq skin, phasing, underbalance criteria, limited entry diversion |
pnge:surface-facilities |
Separator sizing, TEG dehy, compression HP, backpressure effects |
pnge:rta-production |
Arps decline curves, EUR estimation, flowing material balance (Blasingame) |
pnge:well-test-analysis |
Horner plot, skin factor, Bourdet derivative, wellbore storage, Ei solution |
pnge:matrix-acidizing |
HCl carbonate design, HF/HCl sandstone design, Hawkins skin, Damkohler |
pnge:completion-diagnostics |
DFIT/minifrac, ISIP/closure picking, step-rate, cluster efficiency, pressure diagnostics |
pnge:nodal-analysis-multiphase |
IPR/VLP matching, tubing/choke sensitivity, compression impact, multiphase nodal analysis |
pnge:production-chemistry |
Emulsions, incompatibility, squeeze design, cleanup, corrosion program surveillance |
pnge:well-integrity-barriers |
SCP/annulus pressure triage, MIT interpretation, leak-path screening, barrier review |
pnge:petroleum-pvt |
Bubble point, Rs, Bo, Bg, separator shrinkage, condensate dropout screening |
pnge:stage-treatment-analysis |
Local frac stage export parsing, stage normalization, ISIP/screenout screening, cross-stage comparison |
pnge:production-surveillance |
SCADA/historian/test-separator trend analysis, anomaly detection, candidate ranking |
pnge:pvt-report-review |
PVT lab report extraction, QC, and black-oil input packaging |
pnge:integrity-log-review |
MIT, CBL/VDL, noise, temperature, and annulus report review for leak-path evidence |
| Skill | Purpose |
|---|---|
pnge:mass-energy-balance |
Material/energy balances, combustion, flash calculation (Rachford-Rice) |
pnge:nist-webbook |
NIST thermodynamic properties for oil/gas fluids |
pnge:tnav |
tNavigator-style reservoir simulation emulation (black oil, PVT, decline) |
pnge:pnge-visual-explainer |
Generate self-contained HTML visualizations of PNGE concepts and data |
| Skill | Purpose | WVU Course |
|---|---|---|
pnge:fluid-mechanics |
Reynolds number, Darcy-Weisbach, Bernoulli, Colebrook-White, pump sizing | ChBE 311 |
pnge:reaction-engineering |
CSTR/PFR/batch design, Arrhenius, Levenspiel plot, adiabatic T rise | ChBE 321 |
pnge:thermo-eos |
Peng-Robinson/SRK EOS, Z-factor, fugacity, VLE, Rachford-Rice flash | ChBE 231 |
pnge:heat-transfer |
Conduction, convection, overall U, LMTD, NTU, transient heating/cooling | ChBE transport / heat transfer |
pnge:mass-transfer-separations |
Diffusion, mass-transfer coefficients, HTU/NTU, absorption, distillation screening | ChBE separations |
pnge:aqueous-chemistry-electrochem |
pH, buffers, alkalinity, hardness, Nernst, Faraday, water chemistry | ChBE / water treatment |
pnge:materials-fracture-mechanics |
Stress intensity, fracture toughness, fatigue, Paris law, failure screening | MAE materials / integrity |
pnge:physics-mechanics |
Kinematics, Newton laws, energy, momentum, rotation, SHM | PHYS 111 |
pnge:physics-em |
Coulomb law, circuits, RC/RL/LC, Faraday induction, magnetic force | PHYS 112 |
pnge:diff-equations |
1st/2nd order ODEs, Laplace transforms, eigenvalue systems, RK4 | MATH 261 |
| Agent | Purpose |
|---|---|
li-mg-prospector |
Evaluate Li/Mg recovery potential across multiple data sources |
pnge-tutor |
Socratic tutor mapping PNGE/ChBE courses to relevant skills and real data |
pnge-pw-treatment |
Produced water treatment pathway assessment (DLE, ZLD, reuse, disposal) |
api-well-standards |
API 5CT/5C3 casing design, cementing standards, WV/PA regulatory requirements |
pnge-geopolitics |
Energy geopolitics, supply chain risks, and global resource dynamics |
pnge-gis-mapper |
Generate interactive Leaflet.js maps for spatial data visualization |
| Command | Usage |
|---|---|
/prospect |
/prospect Marcellus Shale WV — run the Li/Mg prospector agent |
/formation-profile |
/formation-profile Utica OH — geological + geochemical profile |
/literature-review |
/literature-review direct lithium extraction brines — multi-source lit search |
/well-economics |
/well-economics Marcellus WV 2024 — quick-look well economics with Li/Mg uplift |
/completions-design |
/completions-design Marcellus Monongalia WV — completions context and frac data |
/sustainability-profile |
/sustainability-profile Permian Basin TX — ESG / water / emissions summary |
# Direct from GitHub
claude plugin install pnge@jpfielding/claude.pnge
# Or clone and install locally
git clone https://github.com/jpfielding/claude.pnge.git
claude --plugin-dir ./claude-pngeEach skill can be packaged as a .skill ZIP and uploaded individually:
Settings > Customize > Skills > Upload
Only 4 of the 31 data skills require an API key (all free). Two more accept optional keys for higher rate limits. The remaining 25 data skills work with no authentication at all.
See docs/TOKENS.md for detailed step-by-step signup instructions for each service.
Quick setup using credential files (preferred):
# EIA -- https://www.eia.gov/opendata/
mkdir -p ~/.config/eia && chmod 700 ~/.config/eia
echo "api_key=YOUR_KEY" > ~/.config/eia/credentials && chmod 600 ~/.config/eia/credentials
# NETL EDX -- https://edx.netl.doe.gov/
mkdir -p ~/.config/netl-edx && chmod 700 ~/.config/netl-edx
echo "api_key=YOUR_KEY" > ~/.config/netl-edx/credentials && chmod 600 ~/.config/netl-edx/credentials
# FRED -- https://fred.stlouisfed.org/docs/api/api_key.html
mkdir -p ~/.config/fred && chmod 700 ~/.config/fred
echo "api_key=YOUR_KEY" > ~/.config/fred/credentials && chmod 600 ~/.config/fred/credentials
# OpenEI (for DOE GDR geothermal) -- https://openei.org/services/api/signup/
mkdir -p ~/.config/openei && chmod 700 ~/.config/openei
echo "api_key=YOUR_KEY" > ~/.config/openei/credentials && chmod 600 ~/.config/openei/credentialsOr set environment variables (EIA_API_KEY, NETL_EDX_API_KEY, FRED_API_KEY, OPENEI_API_KEY). Credential files take priority over environment variables.
# EPA -- https://api.data.gov/signup/ (works without key, key raises rate limit)
mkdir -p ~/.config/epa && chmod 700 ~/.config/epa
echo "api_key=YOUR_KEY" > ~/.config/epa/credentials && chmod 600 ~/.config/epa/credentials
# UN Comtrade -- https://comtradeapi.un.org/ (500 req/day without key)
mkdir -p ~/.config/comtrade && chmod 700 ~/.config/comtrade
echo "api_key=YOUR_KEY" > ~/.config/comtrade/credentials && chmod 600 ~/.config/comtrade/credentialsCheck with your PNGE department for access to:
- Enverus/DrillingInfo -- WVU may have an institutional license
- IHS Markit / S&P Global -- check library databases
- OnePetro -- available through WVU Library proxy
# --- Slash Commands ---
/prospect Marcellus Shale WV
/formation-profile Utica OH
/literature-review direct lithium extraction produced water
/well-economics Marcellus Monongalia WV 2024
/completions-design Marcellus Monongalia WV
/sustainability-profile Permian Basin TX
# --- Li/Mg Prospecting ---
"What is the lithium concentration in Smackover brines?"
"Evaluate DLE potential for Marcellus produced water in WV"
"Compare Li concentrations across Smackover, Marcellus, and Bakken"
# --- Completions & Well Engineering ---
"What casing grade should I use for a 9,000 ft Marcellus well?"
"Design a frac job for a Utica well with 3,000 ft lateral"
"Estimate closure pressure and net pressure from this DFIT falloff"
"Analyze this stage treatment CSV for ISIP and likely screenout behavior"
"Run a nodal analysis for a 7,500 ft gas well with 900 psi WHP"
"Diagnose sustained casing pressure on the A-annulus"
"Review this MIT and noise log package for the most likely leak path"
"What is the mud weight window for a Marcellus vertical well at 7,500 ft?"
"Calculate burst pressure for 4.5 in P-110 casing at 8,000 psi"
# --- Produced Water Treatment ---
"Evaluate treatment options for Marcellus brine with 180,000 mg/L TDS"
"Is DLE economically viable for a Marcellus water disposal operation?"
"What are the scale risks for mixing Marcellus PW with sulfate-rich water?"
"Will residual frac chemicals interfere with DLE sorbents or membranes?"
# --- Engineering Calculations ---
"Calculate the stress on a rod with 50 kips axial load and 2 in diameter"
"What is the bending stress at midspan of a 20 ft beam with 10 kip load?"
"Flash a gas at 1000 psia, 150°F using given component compositions"
"What are the thermodynamic properties of CO2 at 2000 psia and 120°F?"
"Estimate bubble point and Bo for a 42 API oil with 650 scf/STB gas"
"Review this PVT report PDF and extract black-oil inputs"
"Size a heat exchanger from U, A, and LMTD"
"Estimate fatigue life from Paris law between two crack sizes"
# --- Local File And Surveillance Workflows ---
"Rank these wells from a SCADA export by likely optimization value"
"Review this stage-by-stage frac spreadsheet for outlier stages"
"Extract the usable PVT inputs from this lab report"
"Compare annulus pressure tests and log evidence across this integrity package"
# --- Tax-Delinquent Mineral Screening ---
"Find delinquent mineral properties in Tyler County WV near active wells"
"Screen Ohio mineral parcels in Belmont County for dormant mineral rights"
"Show parcels near active unconventional wells in Greene County PA"
# --- Data Access ---
"Search NETL EDX for produced water treatment datasets"
"Show me USGS mineral commodity data for lithium production 2020-2024"
"Find PA DEP unconventional wells in Washington County with Marcellus permits"
"What are the Subpart W methane emissions for WV oil and gas facilities?"
# --- Environmental & Sustainability ---
"Show earthquakes near Oklahoma injection wells since 2020"
"What is the water stress index for the Permian Basin?"
"What is the CO2 storage capacity in the Appalachian basin?"
# --- Literature & Research ---
"Find DOE reports on direct lithium extraction from produced water"
"Search OpenAlex for papers on Marcellus Shale brine geochemistry since 2020"
"What does the USGS say about lithium in the Smackover Formation?"
# --- Geopolitics & Markets ---
"How do China's lithium refining dominance and DRC cobalt affect US supply chains?"
"Plot WTI crude oil prices and Henry Hub gas prices for 2024"# Test locally without installing
claude --plugin-dir ./claude-pnge
# Validate all skills
claude plugin validate .
# After changes, restart Claude Code to pick up updatesclaude-pnge/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest (name: pnge, v0.6.0)
├── skills/ # 66 skills total
│ │
│ ├── -- Data Access (31) --
│ ├── eia-data/ # EIA Open Data API v2
│ ├── usgs-produced-waters/ # USGS Produced Waters Geochemical DB v3.0
│ ├── usgs-minerals/ # USGS Mineral Commodity Summaries
│ ├── netl-edx/ # DOE NETL Energy Data eXchange
│ ├── netl-carbon-storage/ # NATCARB Atlas v5 CCS capacity
│ ├── wvges-wells/ # WV Geological & Economic Survey
│ ├── padep-wells/ # PA DEP Unconventional Well Registry
│ ├── boem-offshore/ # BOEM Federal Offshore Data
│ ├── fracfocus/ # FracFocus Chemical Disclosure
│ ├── epa-enviro/ # EPA Envirofacts & ECHO
│ ├── epa-ghg/ # EPA GHGRP Facility Emissions
│ ├── epa-ghgrp-subpartw/ # Subpart W Oilfield Methane
│ ├── usgs-pubs/ # USGS Publications Warehouse
│ ├── doe-osti/ # DOE OSTI Technical Reports
│ ├── kggs-well-logs/ # KGS Wireline Logs (LAS 2.0)
│ ├── macrostrat/ # Macrostrat Formation Stratigraphy
│ ├── openalex/ # OpenAlex Open-Access Literature
│ ├── usgs-earthquakes/ # USGS ComCat Earthquake Catalog
│ ├── usgs-waterdata/ # USGS NWIS + Water Quality Portal
│ ├── fred-prices/ # Federal Reserve FRED
│ ├── worldbank-energy/ # World Bank Open Data
│ ├── comtrade-minerals/ # UN Comtrade Trade Data
│ ├── doe-geothermal/ # DOE GDR / OpenEI Geothermal
│ ├── crossref-doi/ # CrossRef DOI/Citation API
│ ├── opec-data/ # OPEC Production via EIA STEO
│ ├── iea-open/ # IEA Free Datasets
│ ├── odnr-wells/ # Ohio DNR Wells (Utica/Point Pleasant)
│ ├── wri-aqueduct/ # WRI Aqueduct Water Risk
│ ├── wv-tax-minerals/ # WV Delinquent Mineral Properties
│ ├── pa-tax-minerals/ # PA Mineral Parcels Near Active Wells
│ ├── oh-tax-minerals/ # OH Mineral Parcels (OGRIP 200-series LUC)
│ │
│ └── -- Computational (35) --
│ ├── pnge-mechanics/ # Statics, Lamé cylinders, Mohr's circle
│ ├── frac-design/ # PKN/KGD fracture models, proppant transport
│ ├── wellbore-stability/ # Kirsch equations, mud weight window
│ ├── petrophysics/ # Log interpretation, Archie, brittleness
│ ├── artificial-lift/ # Rod pump, ESP, gas lift, plunger lift
│ ├── flow-assurance/ # Hydrates, CO2 corrosion, H2S, wax/scale
│ ├── tubing-design/ # Lubinski four-effect, buckling, seal assy
│ ├── perforation-design/ # Karakas-Tariq skin, limited entry
│ ├── surface-facilities/ # Separator, TEG dehy, compression
│ ├── rta-production/ # Arps DCA, EUR, flowing material balance
│ ├── well-test-analysis/ # Horner plot, skin, Bourdet derivative
│ ├── matrix-acidizing/ # HCl/HF design, Hawkins skin, Damkohler
│ ├── completion-diagnostics/ # DFIT, ISIP, closure, step-rate
│ ├── nodal-analysis-multiphase/ # IPR/VLP, tubing/choke sensitivity
│ ├── production-chemistry/ # Emulsions, squeeze jobs, cleanup
│ ├── well-integrity-barriers/ # SCP, MIT, barrier diagnostics
│ ├── petroleum-pvt/ # Bubble point, Rs, Bo, Bg, shrinkage
│ ├── stage-treatment-analysis/ # Stage CSV parsing and stage diagnostics
│ ├── production-surveillance/ # SCADA/test-separator surveillance
│ ├── pvt-report-review/ # PVT lab report extraction and QC
│ ├── integrity-log-review/ # MIT/log package review
│ ├── mass-energy-balance/ # Material/energy balance, flash calc
│ ├── nist-webbook/ # NIST thermodynamic properties
│ ├── tnav/ # Reservoir simulation emulation
│ ├── pnge-visual-explainer/ # HTML visualization generator
│ ├── fluid-mechanics/ # Reynolds, Darcy-Weisbach, Bernoulli (ChBE 311)
│ ├── reaction-engineering/ # CSTR/PFR/batch, Arrhenius (ChBE 321)
│ ├── thermo-eos/ # PR/SRK EOS, fugacity, VLE (ChBE 231)
│ ├── heat-transfer/ # Conduction, convection, exchangers
│ ├── mass-transfer-separations/ # Diffusion, HTU/NTU, distillation
│ ├── aqueous-chemistry-electrochem/ # pH, alkalinity, Nernst, Faraday
│ ├── materials-fracture-mechanics/ # KIC, Paris law, fatigue
│ ├── physics-mechanics/ # Kinematics, Newton, SHM (PHYS 111)
│ ├── physics-em/ # Circuits, E&M, induction (PHYS 112)
│ └── diff-equations/ # ODEs, Laplace, RK4 (MATH 261)
│
├── agents/ # 6 research and engineering agents
│ ├── li-mg-prospector.md # Li/Mg recovery assessment
│ ├── pnge-tutor.md # Socratic PNGE tutor
│ ├── pnge-pw-treatment.md # Produced water treatment assessment
│ ├── api-well-standards.md # API casing/cementing standards
│ ├── pnge-geopolitics.md # Energy geopolitics analysis
│ └── pnge-gis-mapper.md # Interactive map generation
│
├── commands/ # 6 slash commands
│ ├── prospect.md
│ ├── formation-profile.md
│ ├── literature-review.md
│ ├── well-economics.md
│ ├── completions-design.md
│ └── sustainability-profile.md
│
└── docs/
└── TOKENS.md # API key acquisition guide
┌──────────────────────────────────────────┐
│ claude-pnge Plugin v0.7.0 │
│ 66 Skills · 6 Agents · 6 Commands │
└─────────────────┬────────────────────────┘
│
┌─────────────────────────────┼──────────────────────────┐
│ │ │
U.S. Federal Global Sources Engineering Tools
───────────── ────────────── ─────────────────
· EIA · World Bank · Wellbore Stability
· USGS (5 skills) · UN Comtrade · Frac Design
· DOE NETL / OSTI / GDR · IEA Open · Mechanics/Statics
· EPA (3 skills) · OPEC (via EIA) · Mass/Energy Balance
· BOEM / BSEE · CrossRef / OpenAlex · NIST Thermodynamics
· FracFocus · FRED · tNavigator Sim
· WVGES / PA DEP / ODNR · WRI Aqueduct · Petrophysics
· Macrostrat · Comtrade · Artificial Lift
· KGS Well Logs · Flow Assurance
· Tubing Design
· Perf Design
· Surface Facilities
· RTA / Decline Curves
· Well Test Analysis
· Matrix Acidizing
· Completion Diagnostics
· Nodal Analysis
· Production Chemistry
· Well Integrity
· Petroleum PVT
· Stage Data Analysis
· Production Surveillance
· PVT Report Review
· Integrity Log Review
· Fluid Mechanics
· Heat Transfer
· Mass Transfer / Separations
· Aqueous Chem / Electrochem
· Fracture Mechanics
· Reaction Engineering
· Thermo EOS / VLE
· Physics I & II
· Diff Equations
· 6 Agents · 6 Cmds
Apache-2.0