shepsci/kaggle-skill / skills/kaggle
kaggle
FlaggedUnified Kaggle skill. Use when the user explicitly mentions Kaggle, kaggle.com, a Kaggle URL, Kaggle competitions, Kaggle datasets/models/notebooks, Kaggle forums/discussions/writeups, Kaggle benchmarks, hackathons hosted on Kaggle, Kaggle badges, or Kaggle account setup. Do not use for generic ML, GPU/TPU, notebook, dataset, benchmark, or data-science tasks unless the user clearly ties them to Kaggle.
modules/datasets/README.md
View on GitHub# Datasets
Dataset downloads, new datasets, and new versions.
## Download
```bash
python3 scripts/kaggle_skill.py dataset-download owner/dataset-name
python3 scripts/kaggle_skill.py dataset-download owner/dataset-name ./data --file train.csv
python3 scripts/kaggle_skill.py dataset-download owner/dataset-name ./data --via cli
```
By default kagglehub downloads. A public dataset needs no credential, the
files go to the kagglehub cache (`~/.cache/kagglehub`) unless you give a
folder, and a version can be named as `owner/name/versions/3`.
The folder must be new or empty. kagglehub deletes what is in a folder when
it downloads into it, so a folder with files in it is refused (exit status
5). With `--file` only that one file is replaced, and only with `--force`.
`--via cli` uses the Kaggle CLI, which needs a credential, downloads into
`./downloads/<owner>-<name>` unless a folder is given, and unpacks the
archive.
## Publish
```bash
python3 scripts/kaggle_skill.py dataset-publish owner/dataset-name ./data --notes "Version notes"
python3 scripts/kaggle_skill.py dataset-publish owner/dataset-name ./data --notes "Version notes" --yes
python3 scripts/kaggle_skill.py dataset-publish owner/dataset-name ./data --via cli --yes
```
Without `--yes` nothing is uploaded: the command prints the dataset, the
number of files and their size, and stops. Publishing changes the account, so
get the user's go-ahead before `--yes`.
- Everything in the folder is uploaded. The command stops with exit status 5
if the folder holds a credential file such as `.env` or `kaggle.json`, or a
link to a file or folder outside it (the uploaders follow links).
- By default kagglehub uploads: it creates the dataset if it is new and adds
a version if it exists.
- `--via cli` needs `dataset-metadata.json` in the folder, and its `id` must
be the dataset you name. Write a template with
`kaggle datasets init -p <dir>`. Without `--notes` the dataset is created;
with `--notes` a version is added.
- New datasets are private.
The scripts are `scripts/dataset_download.py` and `scripts/dataset_publish.py`.
## References
- [kagglehub-datasets.md](references/kagglehub-datasets.md)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |