skills/supply-chain-analysis/SKILL.md
Compute supply chain risk metrics for critical minerals — HHI concentration, net import reliance, top-3 share, and trend analysis
npx skillsauth add lamm-mit/scienceclaw supply-chain-analysisInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Compute supply chain risk metrics for critical minerals including the Herfindahl-Hirschman Index (HHI) for production concentration, net import reliance (NIR), top-3 country share, and multi-year trend analysis. Combines data from BGS World Mineral Statistics and USGS Mineral Commodity Summaries.
python3 {baseDir}/scripts/supply_chain_metrics.py --commodity "Lithium"
python3 {baseDir}/scripts/supply_chain_metrics.py --commodity "Cobalt" --metrics hhi,nir,top3share
python3 {baseDir}/scripts/supply_chain_metrics.py --commodity "Rare earths" --metrics trend --year-from 2015
python3 {baseDir}/scripts/supply_chain_metrics.py --commodity "Graphite" --format json
| Parameter | Description | Default |
|-----------|-------------|---------|
| --commodity | Commodity name (BGS naming) | Required |
| --year | Target year for analysis | latest available |
| --year-from | Start year for trend analysis | - |
| --metrics | Comma-separated metrics: hhi, nir, top3share, trend, all | all |
| --format | Output format: summary, json | summary |
| Metric | Description | Risk Thresholds | |--------|-------------|-----------------| | HHI | Herfindahl-Hirschman Index (0-10000) | <1500 low, 1500-2500 moderate, >2500 high | | NIR | US Net Import Reliance (%) | <25% low, 25-75% moderate, >75% high | | Top-3 Share | Combined share of top 3 producers | <50% low, 50-75% moderate, >75% high | | Trend | Year-over-year production change | Increasing/stable/declining |
# Comprehensive lithium supply chain risk assessment
python3 {baseDir}/scripts/supply_chain_metrics.py --commodity "Lithium" --format json
# Cobalt concentration analysis
python3 {baseDir}/scripts/supply_chain_metrics.py --commodity "Cobalt" --metrics hhi,top3share
# Rare earth NIR trend
python3 {baseDir}/scripts/supply_chain_metrics.py --commodity "Rare earths" --metrics nir,trend --year-from 2018
bgs-production skilltools
Onboard and manage Paperclip AI for research-paper knowledge and agent orchestration
development
Perform AI-powered web searches with real-time information using Perplexity models via LiteLLM and OpenRouter. This skill should be used when conducting web searches for current information, finding recent scientific literature, getting grounded answers with source citations, or accessing information beyond the model knowledge cutoff. Provides access to multiple Perplexity models including Sonar Pro, Sonar Pro Search (advanced agentic search), and Sonar Reasoning Pro through a single OpenRouter API key.
testing
Generate a structured scientific PDF report from a JSON description. Accepts a JSON file specifying title, authors, abstract, sections (headings, text, tables, figures), and inline data panels (heatmap, bar, scatter, line). Produces a publication-style A4 PDF using reportlab with no LaTeX dependency. All figures are either loaded from PNG paths or generated on-the-fly from inline data.
development
Execute arbitrary Python code and return stdout. NumPy, pandas, scipy, matplotlib, and other scientific libraries are available.