用途:该技能用于 Kaggle 竞赛相关工作,包括竞赛背景收集、writeup、讨论、kernel、本地复现、提交与数据集上传。资料明确说明,除非用户将任务明确关联到 Kaggle,否则不用于无关的 ML 训练、通用 notebook 编辑、通用数据分析或非 Kaggle 数据集管理。
主要能力:可获取竞赛概览、规则、评估方式、时间线与数据集描述;可抓取单篇或 top-k writeup、发现排行榜 writeup 链接并总结解法;可摄取和查询竞赛讨论、评论与话题,结果缓存于 data/discussions.db;可摄取、查询、阅读 kernel,研究热门公开 kernel、抓取分数并分析 kernel 血缘;可下载并本地复现 Kaggle notebook 及其输入;可将 kernel 推送或提交到竞赛;可从本地文件创建或更新 Kaggle 数据集。
必要用法:需在技能目录下运行命令;仅在当前环境安装所需运行时包;API/CLI/kernel/讨论/数据集/提交流程需先设置 KAGGLE_API_TOKEN,且该令牌视为机密,不得打印、记录或回显。竞赛数据、kernel 输入或压缩包下载前需确认本地磁盘空间。提交竞赛、上传数据集或创建公开数据集等对外可见的敏感操作,须获用户明确确认,每次提交会消耗每日提交名额。API 任务可用命令验证凭据:: "${KAGGLE_API_TOKEN:?ERROR: KAGGLE_API_TOKEN environment variable is not set}"。运行时依赖安装命令为:if command -v uv >/dev/null 2>&1; then uv pip install httpx kaggle kagglesdk nbformat pydantic python-dotenv rich; else python -m pip install httpx kaggle kagglesdk nbformat pydantic python-dotenv rich; fi。
典型命令:python ./scripts/fetch_competition_info.py <competition-slug-or-url>;python ./scripts/fetch_dataset_info.py <competition-slug-or-url>;python ./scripts/discussion_ingest.py <competition_id> [--max-pages N] [--sort-by hotness|votes|comments|created|updated] [--page-size N] [--nofetch-comments];python ./scripts/discussion_query.py <competition_id> [--search TERM] [--min-votes N] [--author NAME] [--limit N] [--as-json];python ./scripts/discussion_read.py <discussion_id> [--competition-id ID];python ./scripts/discussion_db_info.py [competition_id];python ./scripts/upload_dataset.py <path-to-data-folder> [--title "My Dataset"] [--public] [--version-notes "notes"] [--dir-mode zip|tar|skip] [--collaborator user:reader]。数据集默认私有,除非显式指定 --public;未提供 --title 时由文件夹名推导;已有 dataset-metadata.json 的 description、keywords、subtitle、license 字段会保留;数据集已存在时不静默覆盖,需请求或使用 --version-notes。
适用场景:竞赛信息获取与总结、策略简报撰写、讨论与 kernel 调研、本地复现、提交与数据集上传。限制:需要有效 Kaggle 凭据和足够磁盘空间;私有、受限或不可用内容可能无法访问;存在 API/速率限制与页面结构变更风险;提交状态不确定或重试时需先读日志并获用户意图;运行兼容遵循 Agent Skills 约定的代理运行时。