pnge-patents

claude-pnge

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), see CHANGELOG.md for the short migration.

Install

# 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

The 8 plugins

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.

Common install recipes

# 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

API keys

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.

Usage