skills/commodity-profile/SKILL.md
Generate comprehensive one-page commodity profiles with production, trade, risk, research, policy, and web intelligence data
npx skillsauth add lamm-mit/scienceclaw commodity-profileInstall 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.
Generate comprehensive commodity profiles by orchestrating calls to multiple mineral-claw skills. Profiles cover production data (BGS), trade flows (Comtrade), supply chain risk metrics, recent research, export restriction policies, and web intelligence from news/blog/government sources.
python3 {baseDir}/scripts/generate_profile.py --commodity "Lithium"
python3 {baseDir}/scripts/generate_profile.py --commodity "Cobalt" --sections production,risk,intel
python3 {baseDir}/scripts/generate_profile.py --commodity "Rare earths" --format json
| Parameter | Description | Default |
|-----------|-------------|---------|
| --commodity | Commodity name (BGS naming) | Required |
| --year | Target year | latest available |
| --sections | Comma-separated sections: production, trade, risk, research, policy, intel | all |
| --intel-max-results | Max web-intel records to process | 20 |
| --format | Output format: summary, json | summary |
| Section | Data Source | Description |
|---------|------------|-------------|
| production | bgs-production | Top producers, global output, rankings |
| trade | comtrade-trade | Import/export flows, major partners |
| risk | supply-chain-analysis | HHI, NIR, top-3 share, trend |
| research | literature-meta-search | Recent publications, citation leaders |
| policy | export-restrictions | Active restrictions, policy changes |
| intel | minerals-news-monitor + minerals-gov-monitor + minerals-web-ingest | Recent web signals, policy tags, high-confidence findings |
# Full lithium profile
python3 {baseDir}/scripts/generate_profile.py --commodity "Lithium"
# Cobalt production, risk, and web-intel
python3 {baseDir}/scripts/generate_profile.py --commodity "Cobalt" --sections production,risk,intel
# Graphite profile in JSON
python3 {baseDir}/scripts/generate_profile.py --commodity "Graphite" --format json --year 2022
UNCOMTRADE_API_KEYSERPAPI_KEY for Scholar resultsrequests and beautifulsoup4 in the active Python environmentFIRECRAWL_API_KEY is settools
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.