xiaoqianran/kaggle-demo / skills
kaggle-cli
VerifiedUse the local Kaggle CLI skill for command guidance, workflows, and troubleshooting across competitions, datasets, kernels/notebooks, models, model variations and versions, inbox file uploads, forums/discussions, benchmarks, configuration, OAuth/API-token authentication, and accelerator quota. Activate this skill when the user asks about kaggle CLI commands, examples, flags, metadata files, download/upload flows, submissions, benchmark tasks, or Kaggle CLI behavior.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.2 KB |
| references/auth.md | markdown | 3.5 KB |
| references/benchmarks.md | markdown | 25.1 KB |
| references/competitions.md | markdown | 11.3 KB |
| references/configuration.md | markdown | 2.7 KB |
| references/datasets.md | markdown | 7.5 KB |
| references/files.md | markdown | 2.0 KB |
| references/forums.md | markdown | 2.9 KB |
| references/kernels.md | markdown | 6.0 KB |
| references/model_variations.md | markdown | 4.2 KB |
| references/model_variations_versions.md | markdown | 3.5 KB |
| references/models.md | markdown | 4.8 KB |
| references/quota.md | markdown | 1.2 KB |
| references/search.md | markdown | 2.4 KB |
references/models.md
View on GitHub# Models CLI Reference
Use `kaggle models` or alias `kaggle m` to list, initialize, create, retrieve,
update, and delete Kaggle Model records, and to browse model discussion topics.
Model files normally live under model variations; see the model variation
references for variation and version upload/download flows.
## Prerequisites
- Python 3.11+ with the `kaggle` package installed.
- Kaggle credentials for create/update/delete and private model access.
- For create/update flows, prepare `model-metadata.json`. Use
`kaggle models init -p <FOLDER>` to generate a starter file.
## Command Hierarchy
```text
kaggle models (alias: kaggle m)
├── list
├── init
├── create
├── get
├── update
├── delete
├── topics
│ ├── list
│ └── show
└── variations | instances | v | i
```
## `kaggle models list`
Lists public models.
**Usage:**
```bash
kaggle models list [options]
```
**Options:**
- `--sort-by <SORT>`: Sort order.
- `-s, --search <TERM>`: Search text.
- `--owner <OWNER>`: Models owned by a user or organization.
- `--page-size <SIZE>`: Page size.
- `--page-token <TOKEN>`: Page token.
- `-v, --csv`: Print CSV.
**Examples:**
```bash
kaggle models list
kaggle models list --owner google --sort-by downloadCount
kaggle m list -s gemma -v
```
**Purpose:** Find model handles in `<owner>/<model-name>` format.
## `kaggle models init`
Creates a starter `model-metadata.json`.
**Usage:**
```bash
kaggle models init [options]
```
**Options:**
- `-p, --path <FOLDER>`: Folder where metadata will be written.
**Examples:**
```bash
kaggle models init -p my-model
```
**Purpose:** Bootstrap model metadata before creation.
## `kaggle models create`
Creates a new Kaggle Model.
**Usage:**
```bash
kaggle models create [options]
```
**Options:**
- `-p, --path <FOLDER>`: Folder containing `model-metadata.json`.
**Examples:**
```bash
kaggle models create -p my-model
```
**Purpose:** Create a model record. Files are managed through variations and
versions.
## `kaggle models get`
Gets model metadata.
**Usage:**
```bash
kaggle models get <MODEL> [options]
```
**Arguments:**
- `<MODEL>`: Model handle in `<owner>/<model-name>` format.
**Options:**
- `-p, --path <FOLDER>`: Folder to download model metadata to.
**Examples:**
```bash
kaggle models get google/gemma -p metadata
```
**Purpose:** Download metadata for an existing model.
## `kaggle models update`
Updates model metadata.
**Usage:**
```bash
kaggle models update [options]
```
**Options:**
- `-p, --path <FOLDER>`: Folder containing updated `model-metadata.json`.
**Examples:**
```bash
kaggle models update -p my-model
```
**Purpose:** Change model metadata without changing variation files. The model
identity is read from `ownerSlug` and `slug` inside `model-metadata.json`.
## `kaggle models delete`
Deletes a model.
**Usage:**
```bash
kaggle models delete <MODEL> [options]
```
**Options:**
- `-y, --yes`: Skip confirmation.
**Examples:**
```bash
kaggle models delete owner/model-slug -y
```
**Purpose:** Remove a model and its associated resources.
## Model Discussion Commands
### `kaggle models topics list`
Lists discussion topics for a model.
**Usage:**
```bash
kaggle models topics list [MODEL] [options]
```
**Arguments:**
- `[MODEL]`: Model handle in `<owner>/<model-slug>` format.
**Options:**
- `--sort-by <SORT>`: One of `hot`, `top`, `new`, `recent`, `active`, `relevance`.
- `-s, --search <TERM>`: Search text.
- `--page-size <SIZE>`: Number of topics to return.
- `--page-token <TOKEN>`: Page token.
- `-v, --csv`: Print CSV.
- `-q, --quiet`: Suppress extra output.
**Examples:**
```bash
kaggle models topics list owner/model-slug
kaggle models topics list owner/model-slug --sort-by recent --page-size 50
```
**Purpose:** Browse model discussions before opening a specific topic.
`kaggle models topics` without `list` works as a shortcut for listing
topics.
### `kaggle models topics show`
Shows a model discussion topic and comments in tree form.
**Usage:**
```bash
kaggle models topics show <TOPIC_REF> [TOPIC_ID] [options]
```
**Arguments:**
- `<TOPIC_REF>`: Topic reference, or model handle when using the two-argument
form.
- `[TOPIC_ID]`: Optional topic ID for the two-argument form.
**Options:**
- `--page-size <SIZE>`: Number of comments to return.
- `--page-token <TOKEN>`: Page token.
- `-v, --csv`: Print CSV.
- `-q, --quiet`: Suppress extra output.
**Examples:**
```bash
kaggle models topics show owner/model-slug/12345
kaggle models topics show owner/model-slug 12345
```
**Purpose:** Read a model discussion topic and its comments.
## Notes
- The CLI supports both `models variations` and legacy `models instances`
naming. They behave as the same model variation command family.
- Use `model_variations.md` for creating and managing framework-specific model
variations.
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 |