By jpfielding
Produced-water geochemistry and treatment: PHREEQC brine speciation and mineral-scaling prediction, NIST thermodynamic properties, material/energy balance (Rachford-Rice flash), tNavigator-style reservoir-fluid tooling. Includes water-chem-qaqc, lab-method-planner, and pnge-pw-treatment agents plus /water-chem-compare command for side-by-side brine chemistry comparisons.
Analytical chemistry and sampling plan designer for produced water characterization. Recommends sampling protocols, preservation methods, ICP-OES/ICP-MS/IC analytical methods, detection limits, QA/QC plans including blanks, duplicates, and spike recovery targets, and flags high-TDS matrix interference risks. Use when the user asks how to sample produced water, what analytical methods to use for brine Li/Mg analysis, how to preserve produced water samples, what detection limits are needed, how to design a QA/QC plan for water chemistry, what interferences to expect from high-TDS matrices, or how to plan a field sampling campaign. Trigger phrases include sampling plan for produced water, analytical methods for brine, ICP-OES vs ICP-MS for lithium, sample preservation protocol, QA/QC plan water chemistry, high-TDS matrix interference, detection limits for produced water, or field sampling design for brine characterization.
Produced water treatment engineering agent that evaluates treatment options for reuse, disposal, and critical mineral recovery from oilfield brines. Orchestrates produced water chemistry data, environmental compliance data, water stress context, and engineering calculations to provide treatment pathway assessments. Use when the user asks about treating produced water for beneficial reuse, evaluating treatment options for a specific brine composition, assessing DLE applicability, or needs an engineering assessment of produced water management options. Trigger phrases include produced water treatment options, brine treatment for reuse, DLE feasibility assessment, produced water chemistry treatment design, Class II injection vs. reuse economics, zero liquid discharge for produced water, desalination of oilfield brine, scaling and fouling prediction, treatment train design, or NEWTS produced water data.
Water chemistry QA/QC specialist agent for produced water and brine geochemical data. Harmonizes units, flags censored and below-detection values, calculates charge balance errors, identifies duplicate samples, normalizes formation names across datasets, and validates ionic balance. Use when the user asks to clean or validate produced water chemistry data, check charge balance, harmonize units between datasets, flag data quality issues in brine analyses, normalize formation names, identify outliers or duplicates, or convert ppm to mg/L with specific gravity correction. Trigger phrases include QA/QC water chemistry, charge balance check, ionic balance error, unit harmonization ppm mg/L, data quality screening, formation name normalization, censored data handling, or duplicate sample detection.
Perform material balance, energy balance, and reaction stoichiometry calculations for chemical and petroleum engineering courses. Covers steady-state and transient material balances on single and multiple components, energy balances with heat of reaction, heating and cooling, phase equilibria basics, combustion calculations for natural gas, separator design balances, flash calculations, and reaction extent for refinery and gas processing applications. Use this skill when the user needs to solve mass balance problems, energy balance problems, stoichiometry, combustion air calculations, separator flash calculations, heat duty estimation, or reaction engineering calculations for ChBE 211, ChBE 321, or petroleum processing coursework. Trigger for phrases like "material balance on separator", "energy balance for heater treater", "combustion air for natural gas", "flash calculation", "reaction stoichiometry", "heat of combustion methane", "steady state mass balance", "recycle stream balance", "excess air calculation", or "heat duty for reboiler". Produces step-by-step solutions with labeled equations and Python code.
Query NIST WebBook for thermodynamic and transport properties of pure fluids including natural gas components, CO2, water, and hydrocarbon solvents. Provides vapor pressure, density, viscosity, thermal conductivity, heat capacity, enthalpy, entropy, and phase equilibrium data. Use this skill when the user asks about thermodynamic properties of a fluid, vapor pressure at a given temperature, density of methane at reservoir conditions, viscosity of CO2 for injection design, heat capacity of natural gas components, steam tables, equation of state properties, or any physical property of a pure substance. Trigger for phrases like "viscosity of methane at 200F and 3000 psi", "density of CO2 at reservoir conditions", "vapor pressure of water at 150C", "heat capacity of ethane", "enthalpy of methane at wellhead conditions", "steam table properties", "natural gas component properties", "thermodynamic properties of propane", or any pure fluid property query. Returns tabulated saturation or single-phase properties with units.
Run PHREEQC (USGS geochemical modeling code) to compute aqueous speciation, mineral saturation indices, and scaling/precipitation predictions for produced waters and oilfield brines. Use this skill whenever the user asks about brine chemistry modeling, scaling prediction (barite, calcite, gypsum, celestite, halite, anhydrite), saturation index (SI), aqueous speciation, activity coefficients, ion interference in direct lithium extraction (DLE), produced water treatability, or any question needing thermodynamic equilibrium calculations. Trigger phrases: PHREEQC, speciation, saturation index, SI, scaling prediction, scaling tendency, barite scaling, calcite scaling, gypsum scaling, brine chemistry, aqueous geochemistry, Pitzer model, activity coefficient, high-TDS brine, will this brine scale, DLE interference, equilibrium speciation, mineral solubility, sulfate scaling, carbonate scaling. Selects the right thermodynamic database for the ionic strength, builds the input deck, runs PHREEQC, and interprets the SI table.
Emulate tNavigator reservoir simulation workflows for PNGE students. Use this skill when asked to build .DATA files, run material balance, calculate PVT properties, do decline curve analysis, history matching, nodal analysis, VFP tables, IPR curves, kriging, petrophysics, or anything involving reservoir simulation, black oil models, compositional models, Arps decline, Vogel IPR, Beggs-Brill, Peng-Robinson EOS, Z-factor, bubble point, formation volume factor, water saturation, Archie equation, or sensitivity studies on reservoir parameters. Trigger phrases: "reservoir simulation", "build a DATA file", "PVT calc", "decline curve", "material balance", "history match", "nodal analysis", "IPR curve", "VFP table", "Z-factor", "bubble point", "Bo calc", "kriging", "Archie", "skin factor sensitivity", "recovery factor". Educational tool — not a replacement for full tNavigator or Eclipse runs.
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
A Claude Code marketplace of petroleum-engineering research plugins for WVU PNGE, focused on lithium/magnesium recovery from produced waters, state and federal oil-and-gas data, well completions and production engineering, water geochemistry, and ChBE engineering-science tutoring.
Marketplace version: v1.0.0 · Plugins: 8 · Skills: 76 · Agents: 12 · Commands: 12
If you were previously running
pnge@jpfielding/claude.pnge(v0.9.x), seeCHANGELOG.mdfor the short migration.
# Point Claude Code at the marketplace
claude plugin marketplace add jpfielding/claude.pnge
# Install only what you need (list below)
claude plugin install pnge-core@claude-pnge
For local development:
git clone https://github.com/jpfielding/claude.pnge.git
claude plugin marketplace add ./claude.pnge
claude plugin install pnge-core@claude-pnge
| Plugin | Purpose | Skills | Agents | Commands |
|---|---|---|---|---|
pnge-core | Flagship Li/Mg workflow: EIA + USGS produced waters/minerals + federated literature + DataCite DOIs + shared HTML visualizer + /doctor. Install first. | 6 | 1 | 4 |
pnge-federal-data | Non-regulatory federal datasets (USGS, NETL, EPA regulatory stack, BOEM, BLM, FracFocus, NASA Earthdata, EJScreen/CEJST/SVI, WRI Aqueduct) + GIS mapper + research synthesis writer. | 15 | 2 | 1 |
pnge-state-regulatory | State O&G regulators for WV/PA/OH/TX/NM/ND/LA/AR/OK/CA/CO + Appalachian mineral parcels + OSPAR offshore discharge standards + regulatory-disposal-analyst. | 13 | 1 | 2 |
pnge-economics | FRED, BLS, BEA, Census, World Bank, UN Comtrade, IEA + pnge-geopolitics + tea-lca-analyst. | 7 | 2 | 2 |
pnge-patents | USPTO / PatentsView DLE patent landscape + dle-patent-scout + /patent-landscape. | 1 | 1 | 1 |
pnge-well-engineering | Completions + production wellwork as one workflow (frac design, petrophysics, DFIT, tubing/lift, flow assurance, nodal analysis, RTA/DCA, well-test, production chemistry, integrity, PVT) + KGS well-logs + Macrostrat. | 23 | 1 | 1 |
pnge-geochem-pw | Produced-water geochemistry and treatment: PHREEQC + NIST + mass/energy balance + tNavigator-style reservoir-fluid tools, water-chem-qaqc, lab-method-planner, pnge-pw-treatment. | 4 | 3 | 1 |
pnge-engineering-science | ChBE/MAE tutoring mapped to WVU courses: fluid mechanics, reaction engineering, thermo + EOS, heat transfer, mass transfer, aqueous chemistry / electrochem, materials / fracture mechanics + pnge-tutor agent. | 7 | 1 | 0 |
Full skill-by-skill listing: docs/DATA_SOURCES.md.
# Everything (old monolith behavior)
for p in pnge-core pnge-federal-data pnge-state-regulatory pnge-economics \
pnge-patents pnge-well-engineering pnge-geochem-pw pnge-engineering-science; do
claude plugin install $p@claude-pnge
done
# Li/Mg prospecting (most common)
claude plugin install pnge-core@claude-pnge
claude plugin install pnge-state-regulatory@claude-pnge
claude plugin install pnge-geochem-pw@claude-pnge
# Field / well engineering
claude plugin install pnge-core@claude-pnge
claude plugin install pnge-state-regulatory@claude-pnge
claude plugin install pnge-well-engineering@claude-pnge
# ChBE coursework only
claude plugin install pnge-engineering-science@claude-pnge
# TEA / LCA + supply chain
claude plugin install pnge-core@claude-pnge
claude plugin install pnge-economics@claude-pnge
claude plugin install pnge-patents@claude-pnge
Only 6 of the 43 data skills require a free API key. See docs/TOKENS.md for signup steps. Quick setup:
# Required
mkdir -p ~/.config/{eia,netl-edx,fred,openei,bea,census} && chmod 700 ~/.config/{eia,netl-edx,fred,openei,bea,census}
echo "api_key=YOUR_KEY" > ~/.config/eia/credentials && chmod 600 ~/.config/eia/credentials
echo "api_key=YOUR_KEY" > ~/.config/netl-edx/credentials && chmod 600 ~/.config/netl-edx/credentials
echo "api_key=YOUR_KEY" > ~/.config/fred/credentials && chmod 600 ~/.config/fred/credentials
echo "api_key=YOUR_KEY" > ~/.config/openei/credentials && chmod 600 ~/.config/openei/credentials
echo "api_key=YOUR_KEY" > ~/.config/bea/credentials && chmod 600 ~/.config/bea/credentials
echo "api_key=YOUR_KEY" > ~/.config/census/credentials && chmod 600 ~/.config/census/credentials
# Optional (raise rate limits)
mkdir -p ~/.config/{epa,bls,comtrade} && chmod 700 ~/.config/{epa,bls,comtrade}
# ... same pattern ...
After install, run /doctor (ships with pnge-core) to verify credentials and endpoint reachability across the marketplace.
npx claudepluginhub jpfielding/claude.pnge --plugin pnge-geochem-pwEconomic and trade datasets for TEA/LCA and energy geopolitics: Federal Reserve FRED prices, BLS producer price indices, BEA regional income, U.S. Census ACS demographics, World Bank Open Data, UN Comtrade critical-minerals trade flows, and IEA free datasets. Includes pnge-geopolitics and tea-lca-analyst agents and /well-economics, /tea-dle commands.
Core PNGE research workflow: Li/Mg prospector agent, EIA energy data, USGS produced waters + mineral commodity summaries, federated literature search (OpenAlex/CrossRef/USGS Pubs/OSTI) with DataCite dataset DOIs, shared HTML visualizer, and the /doctor preflight command. Install this first.
USPTO / PatentsView patent landscape analysis focused on direct lithium extraction (DLE) technologies: sorbent, membrane, electrochemical, solvent-extraction. Includes dle-patent-scout agent and /patent-landscape command for assignee tracking, technology-class breakdowns, and white-space analysis.
ChBE and MAE engineering-science tutoring mapped to WVU courses: fluid mechanics (ChBE 311), reaction engineering (ChBE 321), thermodynamics + equations of state (ChBE 231), heat transfer, mass transfer and separations, aqueous chemistry + electrochemistry, and materials / fracture mechanics. Includes pnge-tutor Socratic agent.
State oil and gas regulators and cross-border discharge compliance: WV/PA/OH Appalachia stack (WVGES, PADEP, ODNR, mineral parcels), TX RRC, NM OCD, ND DMR, LA SONRIS, AR AOGC, OK OCC (Arbuckle seismicity), CA CalGEM (Salton Sea), CO ECMC (DJ/Niobrara), plus OSPAR offshore discharge standards. Includes regulatory-disposal-analyst agent and /regulatory-screen, /disposal-screen commands.
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Comprehensive PR review agents specializing in comments, tests, error handling, type design, code quality, and code simplification
Comprehensive feature development workflow with specialized agents for codebase exploration, architecture design, and quality review
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
Comprehensive startup business analysis with market sizing (TAM/SAM/SOM), financial modeling, team planning, and strategic research
v9.44.1 — Patch release for Gemini environment/version detection and qwen auth gating. Run /octo:setup.