NVIDIA Kaggle Plugin

NVIDIA Kaggle Plugin gives agents end-to-end Kaggle competition workflows through a single skill, nvidia-kaggle-skill. It can gather competition context, study public writeups and notebooks, reproduce kernels locally, submit to competitions, and manage Kaggle datasets.

The skill accepts whatever’s natural — a competition slug, a Kaggle URL, a kernel ref, a writeup URL, or a local path — and picks the right script to run based on the request.

Examples of supported workflows include:

Requirements

• Python 3.10 or newer.
• An agent runtime with plugin or Agent Skills support, such as Codex, Claude Code, or another compatible harness.
• A Kaggle account and KAGGLE_API_TOKEN for API-backed workflows, including dataset access, kernels, submissions, and dataset uploads.

Examples

Top Solution Writeups

What this does: Scrapes the competition leaderboard, opens the top-N solution discussions, and summarizes the techniques each top team used. Useful when starting a new competition and you want to know what has historically won.

/nvidia-kaggle:nvidia-kaggle-skill Get the top 3 solution writeups from the AI Mathematical Olympiad - Progress Prize 2 competition and summarize the key strategies.

Competition Overview And Dataset

What this does: Fetches the competition’s overview, rules, evaluation metric, timeline, and dataset description in one pass. This is usually the first thing to run for a new competition — it gives the agent the framing it needs before writing any code.

/nvidia-kaggle:nvidia-kaggle-skill Fetch the competition overview and dataset description for the ARC Prize 2025 competition.

Public Kernel Research

What this does: Indexes the public kernels for a competition into a local cache, then queries and reads the highest-ranked ones to summarize the modeling approaches, feature engineering patterns, and common pitfalls. Useful for getting up to speed on what the community has already tried before you write your own baseline.

/nvidia-kaggle:nvidia-kaggle-skill Research the top public kernels for the Home Credit Default Risk competition and summarize the modeling approaches used.

Kernel Setup

What this does: Downloads a public Kaggle notebook along with the competition data and any dataset inputs it depends on, and lays them out in a local workspace that’s ready to run. Handy when you want to start from an existing baseline instead of from scratch.

/nvidia-kaggle:nvidia-kaggle-skill Download and set up this notebook locally so I can run it: https://www.kaggle.com/code/cdeotte/titanic-wcg-xgboost-0-84688

Demo: Competition Strategy Brief

This demo chains the skill’s research workflows — overview, discussions, kernels, writeups — into a single strategy brief: the metric and constraints, the winning techniques (each linked to its source), a baseline→top score ladder, and a few plots. Give the skill a natural-language prompt:

Research the rogii-wellbore-geology-prediction Kaggle competition with the nvidia-kaggle skill and write me a strategy brief on what it takes to do well. Include the key public notebooks and discussions as links, and a few plots for insight. Save the brief to brief.md and put any plots under plots/.

Sample output briefs:

• Codex run
• Claude run

Quick Install

Install the marketplace for your agent runtime.

Codex

codex plugin marketplace add https://github.com/NVIDIA/nvidia-kaggle.git

Then open a Codex session, run /plugins, choose the nvidia-kaggle marketplace, and install nvidia-kaggle.

Claude Code

claude plugin marketplace add https://github.com/NVIDIA/nvidia-kaggle.git
claude plugin install nvidia-kaggle@nvidia-kaggle --scope user

Local Install

Codex

codex plugin marketplace add .

Then open a Codex session, run /plugins, choose the local nvidia-kaggle marketplace, and install nvidia-kaggle.

Claude Code

claude plugin marketplace add .
claude plugin install nvidia-kaggle@nvidia-kaggle --scope user

Other Harnesses

For any agent runtime that supports Agent Skills directly, copy the whole skill directory into that runtime’s skills directory:

cp -R skills/nvidia-kaggle-skill /

The copied directory must include SKILL.md, the workflow markdown files, and the scripts/ directory.

Credentials

Kaggle API workflows require KAGGLE_API_TOKEN, expected to contain a KGAT token string. Keep it in your environment, .env.

Evaluation

See BENCHMARK.md for the skill evaluation summary, including evaluated agents, task coverage, metrics, and with-skill uplift against baseline runs.

Development

Run the default test suite:

uv run pytest

Run Claude Code marketplace install coverage:

uv run pytest --run-claude-plugin tests/test_claude_plugin_install.py

Run Kaggle integration tests only when credentials and network access are available:

uv run pytest --run-integration

Before a release-facing change:

uv sync
uv run pytest
claude plugin validate .

Contributor guidance is in CONTRIBUTING.md.