Agent skill

Commodity Profile

by lamm-mit in lamm-mit/scienceclaw

Generate comprehensive one-page commodity profiles with production, trade, risk, research, policy, and web intelligence data

Apache-2.0Auto-check passed

Install Commodity Profile

skills CLI
$ npx skills add lamm-mit/scienceclaw --skill commodity-profile -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lamm-mit/scienceclaw commodity-profile --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lamm-mit/scienceclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/commodity-profile .claude/skills/commodity-profile && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
commodity-profile
GitHub stars
244
Token cost
~705 tokens
SKILL.md length
195 words
Files
2 (incl. scripts)
Skills in repo
85
Repo updated
First seen
Licence
Apache-2.0

At a glance

Generate comprehensive one-page commodity profiles with production, trade, risk, research, policy, and web intelligence data

  • SKILL.md covers Usage, Parameters, Profile Sections and Examples, plus 1 more section
  • Runs Python scripts from its folder; calls python3; needs UNCOMTRADE_API_KEY and SERPAPI_KEY

What it does

Commodity Profile is an agent skill from lamm-mit/scienceclaw. Generate comprehensive one-page commodity profiles with production, trade, risk, research, policy, and web intelligence data

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/generate_profile.py`).

The licence is Apache-2.0.

Example prompts

  • “/commodity-profile”

Requirements

  • Python 3
  • A credential in UNCOMTRADE_API_KEY
  • A credential in SERPAPI_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit ab9aba1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • UNCOMTRADE_API_KEY
    • SERPAPI_KEY
    • FIRECRAWL_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Commodity Profile loads about 705 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 195 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~705

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from lamm-mit/scienceclaw at commit ab9aba1, republished under its Apache-2.0 licence (© lamm-mit). 195 words, ~705 tokens.

Download SKILL.mdSave it as .claude/skills/commodity-profile/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
commodity-profile
description
Generate comprehensive one-page commodity profiles with production, trade, risk, research, policy, and web intelligence data

Commodity Profile Generator

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.

Usage

Full profile:
bash
python3 {baseDir}/scripts/generate_profile.py --commodity "Lithium"
Select sections:
bash
python3 {baseDir}/scripts/generate_profile.py --commodity "Cobalt" --sections production,risk,intel
JSON output:
bash
python3 {baseDir}/scripts/generate_profile.py --commodity "Rare earths" --format json

Parameters

ParameterDescriptionDefault
--commodityCommodity name (BGS naming)Required
--yearTarget yearlatest available
--sectionsComma-separated sections: production, trade, risk, research, policy, intelall
--intel-max-resultsMax web-intel records to process20
--formatOutput format: summary, jsonsummary

Profile Sections

SectionData SourceDescription
productionbgs-productionTop producers, global output, rankings
tradecomtrade-tradeImport/export flows, major partners
risksupply-chain-analysisHHI, NIR, top-3 share, trend
researchliterature-meta-searchRecent publications, citation leaders
policyexport-restrictionsActive restrictions, policy changes
intelminerals-news-monitor + minerals-gov-monitor + minerals-web-ingestRecent web signals, policy tags, high-confidence findings

Examples

bash
# 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

Notes

  • Orchestrates multiple skill scripts (may take 30-90 seconds)
  • Some sections may fail if API keys are not set (warnings printed to stderr)
  • Trade section requires UNCOMTRADE_API_KEY
  • Research section requires SERPAPI_KEY for Scholar results
  • Intel section requires requests and beautifulsoup4 in the active Python environment
  • Intel ingest can optionally use Firecrawl when FIRECRAWL_API_KEY is set
  • For individual data queries, use source skills directly

© lamm-mit, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in skills/commodity-profile of lamm-mit/scienceclaw.

  • SKILL.md
  • scripts/generate_profile.py

Open the folder on GitHubat commit ab9aba1

Compare with similar skills

Commodity Profile next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Commodity Profile compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Commodity Profile this skilllamm-mit/scienceclaw244—~705Automated safety check: PassApache-2.0
Trade Journal AnalysisHKUDS/Vibe-Trading35k—~1.8kAutomated safety check: PassMIT
Agent Trading Predictorruvnet/ruflo74k3 repos~2.5kAutomated safety check: PassMIT
LLM Trading Agent Securityaffaan-m/ECC274k2 repos~1.2kAutomated safety check: PassMIT
Trading Ledgersickn33/agentic-awesome-skills47k1 repos~2.2kAutomated safety check: PassMIT
Profileccusage/ccusage19k—~430Automated safety check: PassCustom licence

Similar skills

  • Trade Journal Analysis

    HKUDS/Vibe-Trading

    Reads a broker export of your trades (CSV or Excel), builds a trading profile and runs four behavior checks: disposition effect, overtrading, chasing and anchoring.

    35k GitHub stars~1.8k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Agent skill for trading-predictor - invoke with $agent-trading-predictor

    74k GitHub starsUsed in 3 repos~2.5k tokens
    Business, Finance & HRAuto-check passed
  • Security patterns for autonomous trading agents with wallet or transaction authority.

    274k GitHub starsUsed in 2 repos~1.2k tokens
    SecurityAuto-check passed
  • Trading Ledger

    sickn33/agentic-awesome-skills

    A trading journal that captures the decision, not just the fill: thesis, plan, and emotion at the moment of entry, written to the user's own Notion database; reviews grade decisions, not P&L.

    47k GitHub starsUsed in 1 repo~2.2k tokens
    Business, Finance & HRAuto-check passed
  • Profile

    ccusage/ccusage

    Profiles ccusage performance. An agent skill from ccusage/ccusage.

    19k GitHub stars~430 tokensUpdated today
    Auto-check passed
  • Pair Trading Signals

    HKUDS/Vibe-Trading

    Trades mean reversion between two correlated instruments using the Z-score of their price ratio, going long one leg and short the other when the ratio stretches.

    35k GitHub stars~651 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from lamm-mit/scienceclaw

All 85 skills in this repo
  • Fred Economic Data

    lamm-mit/scienceclaw

    Query FRED (Federal Reserve Economic Data) API for 800,000+ economic time series from 100+ sources.

    244 GitHub starsUsed in 4 repos~3k tokens
    Auto-check passed
  • Drug Research

    lamm-mit/scienceclaw

    Generates comprehensive drug research reports with compound disambiguation, evidence grading, and mandatory completeness sections.

    244 GitHub starsUsed in 3 repos~1.7k tokens
    Auto-check passed
  • Imaging Data Commons

    lamm-mit/scienceclaw

    Query and download public cancer imaging data from NCI Imaging Data Commons using idc-index.

    244 GitHub starsUsed in 5 repos~11k tokens
    Auto-check passed
  • Rowan

    lamm-mit/scienceclaw

    Cloud-based quantum chemistry platform with Python API. An agent skill from lamm-mit/scienceclaw.

    244 GitHub starsUsed in 4 repos~3.1k tokens
    Auto-check: warnings
  • Infographics

    lamm-mit/scienceclaw

    Create professional infographics using Nano Banana Pro AI with smart iterative refinement.

    244 GitHub starsUsed in 6 repos~4.4k tokens
    Auto-check: notes
  • Disease Research

    lamm-mit/scienceclaw

    Generate comprehensive disease research reports using 100+ ToolUniverse tools.

    244 GitHub stars~946 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Commodity Profile

What does Commodity Profile do?

Generate comprehensive one-page commodity profiles with production, trade, risk, research, policy, and web intelligence data. Commodity Profile is an agent skill from lamm-mit/scienceclaw.

How do I install Commodity Profile in Claude Code?

Run `npx skills add lamm-mit/scienceclaw --skill commodity-profile -a claude-code`. Or copy the skill folder (skills/commodity-profile in lamm-mit/scienceclaw) into .claude/skills/commodity-profile in your project. Claude Code loads it when a task matches its description.

How do I install Commodity Profile in Codex?

Run `npx skills add lamm-mit/scienceclaw --skill commodity-profile -a codex`. Or copy the skill folder (skills/commodity-profile in lamm-mit/scienceclaw) into .agents/skills/commodity-profile in your project. Codex loads it when a task matches its description.

Can I use Commodity Profile in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lamm-mit/scienceclaw --skill commodity-profile -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/commodity-profile, .gemini/skills/commodity-profile, .github/skills/commodity-profile and .opencode/skills/commodity-profile in your project.

What does Commodity Profile need to run?

Going by SKILL.md and its folder, Commodity Profile needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named UNCOMTRADE_API_KEY, SERPAPI_KEY and FIRECRAWL_API_KEY. Our summary lists: Python 3; A credential in UNCOMTRADE_API_KEY; A credential in SERPAPI_KEY.

Does Commodity Profile access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Commodity Profile safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Commodity Profile use?

Commodity Profile is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Commodity Profile use?

About 705 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Commodity Profile?

Skills that share tags, products or a category with Commodity Profile: Trade Journal Analysis (HKUDS/Vibe-Trading, 35k stars), Agent Trading Predictor (ruvnet/ruflo, 74k stars), LLM Trading Agent Security (affaan-m/ECC, 274k stars) and Trading Ledger (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Commodity Profile?

lamm-mit (a GitHub user) maintains it in lamm-mit/scienceclaw, which has 244 GitHub stars. The repository holds 85 skills in this directory. The repository was last updated on August 21, 2026.

Source: lamm-mit/scienceclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.