By jpfielding
Completions and production wellwork as one workflow: frac design (PKN/KGD, Nolte-Smith), wellbore stability (Kirsch, mud window), petrophysics (Archie/Simandoux, brittleness), perforation design, DFIT/minifrac diagnostics, matrix acidizing, tubing design (Lubinski), artificial lift (rod/ESP/gas-lift/plunger), flow assurance (hydrates/scale/corrosion), surface facilities, RTA/DCA, well-test analysis, nodal analysis, production chemistry, well-integrity/SCP triage, PVT, stage-treatment + surveillance review, plus KGS well-log and Macrostrat stratigraphy references. Includes api-well-standards agent and /completions-design.
Based on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Review and extract engineering value from local PVT laboratory reports, spreadsheets, PDFs, and table exports including CCE, CVD, differential liberation, separator tests, viscosity tables, and black-oil summaries. Use when the user provides a PVT report and asks to extract bubble point, Rs, Bo, Bg, shrinkage, dewpoint, condensate dropout behavior, lab quality issues, or black-oil inputs for simulation and nodal analysis. Trigger phrases include PVT report, lab report review, CCE, CVD, differential liberation, separator test, black-oil table, fluid report, extract PVT data, or QC this lab report.
Design and analyze artificial lift systems for oil and gas wells including rod pumping, electric submersible pumps, gas lift, and plunger lift. Covers liquid loading prediction using Turner and Coleman critical velocity criteria, rod pump design per API RP 11L including polished rod load, gearbox torque, pump displacement and fillage, ESP selection and sizing including stage count, total dynamic head, motor horsepower and cable losses, gas lift design including single-point injection pressure, valve spacing by pressure traverse, kickoff requirements, and GLR effect on flowing gradient, and plunger lift cycle timing. Use when determining if a well is liquid loading, selecting an artificial lift method, sizing an ESP or rod pump, designing a gas lift system, or calculating lift performance for PNGE production courses. Trigger phrases include liquid loading, Turner criteria, rod pump design, ESP sizing, polished rod load, gas lift valve spacing, plunger lift timing, pump-off control, artificial lift selection, critical flow rate, or PBHFP calculation.
Interpret hydraulic fracturing diagnostics and stage execution data including DFIT and minifrac closure analysis, step-rate test interpretation, ISIP estimation, net pressure decomposition, cluster efficiency screening, and treatment-pressure troubleshooting. Use when the user asks about closure pressure, fracture gradient, G-function or square-root-time plots, step-rate breakdown pressure, screenout diagnosis, treating pressure analysis, cluster imbalance, frac calibration tests, or stage-by-stage completion performance. Trigger phrases include DFIT, minifrac, ISIP, closure pressure, step-rate, net pressure, treatment pressure matching, cluster efficiency, screenout, pressure signature, tortuosity, or diagnostic fracture injection test.
Predict and mitigate flow assurance problems in oil and gas wellbores and pipelines including hydrate formation, CO2 and H2S corrosion, wax deposition, and carbonate and sulfate scale. Covers hydrate prediction using the Katz chart gravity method and Hammerschmidt inhibitor dosage equation for methanol and glycol injection, CO2 partial pressure calculation and corrosion rate using the de Waard-Milliams equation, H2S partial pressure and NACE MR0175 ISO 15156 sour service threshold determination, wax appearance temperature estimation and inhibition strategies, downhole carbonate scale LSI calculation and BaSO4 sulfate scale ion product, and chemical inhibitor selection and injection rate sizing. Use when evaluating hydrate risk in gas wells or pipelines, sizing methanol or glycol injection systems, assessing CO2 corrosion and material selection, checking H2S sour service requirements, predicting wax or scale problems, or selecting production chemicals. Trigger phrases include hydrate prediction, methanol injection rate, CO2 corrosion rate, H2S sour service, wax appearance temperature, scale inhibitor, NACE MR0175, Hammerschmidt equation, flow assurance, or production chemistry.
Perform hydraulic fracture design and analysis calculations for PNGE 341 completions engineering. Covers fracture geometry estimation using PKN and KGD analytical models, net treating pressure, fluid efficiency, proppant transport and settling, Nolte-Smith pressure diagnostics, fracture closure pressure from ISIP analysis, step-rate test interpretation, and post-frac production analysis. Use this skill when the user needs to estimate fracture length or width, analyze treating pressure trends, calculate fluid loss coefficient, determine closure pressure, design proppant schedules, evaluate net pressure and fracture containment, or work through hydraulic fracturing calculations for coursework or research. Trigger for phrases like "fracture half-length estimate", "PKN model fracture width", "net treating pressure", "fluid efficiency calculation", "closure pressure from ISIP", "Nolte-Smith plot", "proppant settling velocity", "G-function analysis", "step-rate test", or "hydraulic fracture geometry". Produces design parameter tables, step-by-step calculations, and pressure diagnostic interpretations.
Uses power tools
Uses Bash, Write, or Edit tools
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.
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 claimnpx claudepluginhub jpfielding/claude.pnge --plugin pnge-well-engineeringEconomic 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.
A growing collection of Claude-compatible academic workflow bundles. Covers scientific figures, manuscript writing and polishing, reviewer assessment, citation retrieval, data availability, paper reading, literature search, response letters, paper-to-PPTX conversion, and evidence-grounded Chinese invention patent drafting. Rules are organized as reusable skill folders with explicit workflows and quality checks.
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 feature development workflow with specialized agents for codebase exploration, architecture design, and quality review
Tools to maintain and improve CLAUDE.md files - audit quality, capture session learnings, and keep project memory current.
Comprehensive PR review agents specializing in comments, tests, error handling, type design, code quality, and code simplification
Harness-native ECC operator layer - 67 agents, 271 skills, 92 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses