NVIDIA/nvidia-kaggle

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 Ka

NVIDIA Kaggle 插件 – 端對端 Kaggle 工作流程的代理技能

是什麼 – 一個基於 Python 的 代理技能，讓大型語言模型代理（例如 Claude Code、Codex）能與 Kaggle 互動。透過單一自然語言指令（nvidia-kaggle-skill），代理可執行以下操作：

拉取競賽概覽、規則與資料集元資料。
搜尋並總結排行榜頂尖解法、討論串與公開筆記本。
下載筆記本（kernel）及其資料至本地工作區，準備執行。
提交筆記本至競賽，並輪詢取得結果。
由本地資料夾建立或更新 Kaggle 資料集。

此技能可解析您提供的任何內容——競賽代碼、Kaggle URL、內核參考、解法連結或本地路徑——並自動選擇適當的子指令。

主要功能（如 README 所示）

功能	技能作用
競賽背景	回傳概覽、規則、評估指標、時間軸與資料集描述。
解決方案解法	找出排名靠前的排行榜解法，並產出勝利策略的簡明摘要。
討論	索引 Kaggle 討論串，讓代理可搜尋並讀取選定文章。
內核	索引公開內核，查詢並提取最相關的筆記本。
內核重現	下載公開筆記本及其所有必要輸入，並整理至本地目錄，準備執行。
提交	將筆記本型態的提交推送到 Kaggle，並輪詢競賽頁面取得最終分數。
資料集上傳	由本地資料夾建立新 Kaggle 資料集或更新現有資料集。

快速入門（安裝技能）

前置條件
- Python 3.10+
- 支援插件／代理技能的代理執行環境（例如 Codex、Claude Code）
- 已設定 KAGGLE_API_TOKEN 環境變數的 Kaggle 帳號

市場安裝（支援的執行環境）

# Codex
codex plugin marketplace add https://github.com/NVIDIA/nvidia-kaggle.git
# Claude Code
claude plugin marketplace add https://github.com/NVIDIA/nvidia-kaggle.git
claude plugin install nvidia-kaggle@nvidia-kaggle --scope user

本地安裝（任何可讀取技能目錄的執行環境）
```
cp -R skills/nvidia-kaggle-skill <your-skills-directory>/
```
該目錄必須包含 SKILL.md、Markdown 工作流程檔案與 scripts/ 資料夾。

使用範例（來自 README）

總結頂尖解法

/nvidia-kaggle:nvidia-kaggle-skill 取得 AI 數學奧林匹克 – Progress Prize 2 競賽的前 3 筆解法解說，並總結關鍵策略。

取得競賽概覽與資料集描述

/nvidia-kaggle:nvidia-kaggle-skill 取得 ARC Prize 2025 競賽的競賽概覽與資料集描述。

研究公開內核

/nvidia-kaggle:nvidia-kaggle-skill 研究 Home Credit Default Risk 競賽的頂級公開內核，並總結所使用的建模方法。

在本地設定筆記本

/nvidia-kaggle:nvidia-kaggle-skill 將此筆記本下載至本地並設定好，以便我可執行：https://www.kaggle.com/code/cdeotte/titanic-wcg-xgboost-0-84688

這些指令展示了自然語言介面：代理會根據請求內容自動決定執行哪個內部腳本。

開發與測試

使用 uv run pytest 執行測試套件。
需要有效憑證才能執行的整合測試（會觸及真實 Kaggle API）需透過 --run-integration 選項啟用。
發布前，請同步相依性（uv sync）、執行完整測試套件，並使用 claude plugin validate . 驗證插件。

授權

MIT（參見 LICENSE）。

總結 – NVIDIA Kaggle 插件將對話式 AI 代理轉變為功能完整的 Kaggle 助手，無需使用者撰寫任何 API 程式碼，即可處理從資料探索到模型提交的全部流程。