Agent skill

Bgs Production

by lamm-mit in lamm-mit/scienceclaw

Query BGS World Mineral Statistics for production, imports, and exports by commodity, country, and year

Apache-2.0Auto-check passedData & Analytics

Install Bgs Production

skills CLI
$ npx skills add lamm-mit/scienceclaw --skill bgs-production -a claude-code

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

GitHub CLI
$ gh skill install lamm-mit/scienceclaw bgs-production --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/bgs-production .claude/skills/bgs-production && 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
bgs-production
GitHub stars
244
Token cost
~667 tokens
SKILL.md length
159 words
Files
2 (incl. scripts)
Skills in repo
86
Repo updated
First seen
Licence
Apache-2.0

At a glance

Query BGS World Mineral Statistics for production, imports, and exports by commodity, country, and year

  • Tasks that involve Statistics
  • SKILL.md covers Usage, Parameters, Examples and Notes
  • Runs Python scripts from its folder; calls python3

What it does

Bgs Production is an agent skill from lamm-mit/scienceclaw. Query BGS World Mineral Statistics for production, imports, and exports by commodity, country, and year

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

It sits in Data & Analytics, covering Statistics. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Statistics

Example prompts

  • “/bgs-production”

Requirements

  • Python 3

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 no API keys, tokens, secrets or passwords.

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

Context cost

Bgs Production loads about 667 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 159 words of instructions outside code blocks.

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

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). 159 words, ~667 tokens.

Download SKILL.mdSave it as .claude/skills/bgs-production/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
bgs-production
description
Query BGS World Mineral Statistics for production, imports, and exports by commodity, country, and year

BGS World Mineral Statistics

Query the British Geological Survey's World Mineral Statistics database for mineral production, imports, and exports by commodity, country, and year. Covers global mineral data with country-level breakdowns.

Usage

bash
python3 {baseDir}/scripts/bgs_query.py --query "lithium"
Production by country:
bash
python3 {baseDir}/scripts/bgs_query.py --query "Cobalt" --country "Congo"
Filter by year range:
bash
python3 {baseDir}/scripts/bgs_query.py --query "Copper" --year-from 2018 --year-to 2022
Get country ranking:
bash
python3 {baseDir}/scripts/bgs_query.py --query "Graphite" --ranking --top-n 10
Filter by statistic type:
bash
python3 {baseDir}/scripts/bgs_query.py --query "Nickel" --statistic-type "Exports"
JSON output:
bash
python3 {baseDir}/scripts/bgs_query.py --query "Rare earths" --format json --limit 20

Parameters

ParameterDescriptionDefault
--queryCommodity name to search forRequired
--countryFilter by country name-
--year-fromStart year for date filter-
--year-toEnd year for date filter-
--statistic-typeStatistic type: Production, Imports, ExportsProduction
--rankingShow country ranking by productionfalse
--top-nNumber of top countries in ranking15
--limitMaximum records to return50
--formatOutput format: summary, detailed, jsonsummary

Examples

bash
# Top lithium producers
python3 {baseDir}/scripts/bgs_query.py --query "Lithium" --ranking --top-n 10

# Cobalt production in Congo over time
python3 {baseDir}/scripts/bgs_query.py --query "Cobalt" --country "Congo" --year-from 2015 --format detailed

# Rare earth exports globally
python3 {baseDir}/scripts/bgs_query.py --query "Rare earths" --statistic-type "Exports" --format json

# Graphite production ranking for 2021
python3 {baseDir}/scripts/bgs_query.py --query "Graphite" --ranking --year-from 2021 --year-to 2021

Notes

  • Data from the BGS OGC API (free, no authentication required)
  • Covers global mineral production, imports, and exports statistics
  • Country names use BGS conventions (e.g., "Congo (Democratic Republic)" not "DRC")
  • Year filtering is applied client-side after fetching records
  • Rate limiting: be courteous, avoid excessive requests

© 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/bgs-production of lamm-mit/scienceclaw.

  • SKILL.md
  • scripts/bgs_query.py

Open the folder on GitHubat commit ab9aba1

Compare with similar skills

Bgs Production 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.

Bgs Production compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bgs Production this skilllamm-mit/scienceclaw244—~667Automated safety check: PassApache-2.0
Sandbox Benchvercel/next.js143k—~4.1kAutomated safety check: PassMIT
Statistical Analysisspacering-net/codeg3.9k3 repos~5kAutomated safety check: PassMIT
StatsmodelszLanqing/codex-claude-academic-skills4.7k15 repos~4.9kAutomated safety check: PassBSD-3-Clause
AI Daily DigestvigorX777/ai-daily-digest1.6k—~1.3kAutomated safety check: PassNone
Statistical Powerspacering-net/codeg3.9k1 repos~3.6kAutomated safety check: NotesMIT

Similar skills

  • Sandbox Bench

    vercel/next.js

    Official

    Benchmark React or Next.js changes on Vercel Sandbox VMs with paired A/B statistics: react PR/commit vs base, or Next.js PR/commit vs base, measured end-to-end through the bench/render-pipeline app…

    143k GitHub stars~4.1k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Statistical Analysis

    spacering-net/codeg

    Guided statistical analysis for research data - test selection, assumption checking, effect sizes, power analysis, Bayesian alternatives, and APA-formatted reporting.

    3.9k GitHub starsUsed in 3 repos~5k tokens
    Data & AnalyticsAuto-check passed
  • Statsmodels

    zLanqing/codex-claude-academic-skills

    Statistical models library for Python. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 15 repos~4.9k tokens
    Data & AnalyticsAuto-check passed
  • AI Daily Digest

    vigorX777/ai-daily-digest

    Fetches RSS feeds from 90 top Hacker News blogs (curated by Karpathy), uses AI to score and filter articles, and generates a daily digest in Markdown with Chinese-translated titles, category…

    1.6k GitHub stars~1.3k tokensUpdated 7 mo ago
    Data & AnalyticsAuto-check passed
  • Statistical Power

    spacering-net/codeg

    Sample-size and statistical power calculations for planning studies.

    3.9k GitHub starsUsed in 1 repo~3.6k tokens
    Data & AnalyticsAuto-check: notes
  • Agent Session Monitor

    higress-group/higress

    Real-time agent conversation monitoring - monitors Higress access logs, aggregates conversations by session, tracks token usage.

    9.5k GitHub stars~3.3k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed

More from lamm-mit/scienceclaw

All 86 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 Bgs Production

What does Bgs Production do?

Query BGS World Mineral Statistics for production, imports, and exports by commodity, country, and year. Bgs Production is an agent skill from lamm-mit/scienceclaw.

When should I use Bgs Production?

Bgs Production fits situations like: tasks that involve Statistics.

How do I install Bgs Production in Claude Code?

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

How do I install Bgs Production in Codex?

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

Can I use Bgs Production 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 bgs-production -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bgs-production, .gemini/skills/bgs-production, .github/skills/bgs-production and .opencode/skills/bgs-production in your project.

What does Bgs Production need to run?

Going by SKILL.md and its folder, Bgs Production needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Bgs Production 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 Bgs Production 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 Bgs Production use?

Bgs Production 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 Bgs Production use?

About 667 tokens (SKILL.md is roughly 2.7k 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 Bgs Production?

Skills that share tags, products or a category with Bgs Production: Sandbox Bench (vercel/next.js, 143k stars), Statistical Analysis (spacering-net/codeg, 3.9k stars), Statsmodels (zLanqing/codex-claude-academic-skills, 4.7k stars) and AI Daily Digest (vigorX777/ai-daily-digest, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bgs Production?

lamm-mit (a GitHub user) maintains it in lamm-mit/scienceclaw, which has 244 GitHub stars. The repository holds 86 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.