Skip to content

xiaoqianran/kaggle-demo / skills

kaggle-cli

Verified

Use 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.

FileKindSize
SKILL.mdskill md4.2 KB
references/auth.mdmarkdown3.5 KB
references/benchmarks.mdmarkdown25.1 KB
references/competitions.mdmarkdown11.3 KB
references/configuration.mdmarkdown2.7 KB
references/datasets.mdmarkdown7.5 KB
references/files.mdmarkdown2.0 KB
references/forums.mdmarkdown2.9 KB
references/kernels.mdmarkdown6.0 KB
references/model_variations.mdmarkdown4.2 KB
references/model_variations_versions.mdmarkdown3.5 KB
references/models.mdmarkdown4.8 KB
references/quota.mdmarkdown1.2 KB
references/search.mdmarkdown2.4 KB

references/files.md

View on GitHub
# Files CLI Reference

Use `kaggle files` to upload local files or directories to a Kaggle inbox path.
This command is separate from dataset/model/kernel uploads and uses the inbox
file API.

## Prerequisites

- Python 3.11+ with the `kaggle` package installed.
- Kaggle credentials.
- Local filesystem paths to upload.

## Command Hierarchy

```text
kaggle files
└── upload | u
```

## `kaggle files upload`

Uploads one or more local paths to the server inbox.

**Usage:**

```bash
kaggle files upload [options] <LOCAL_PATH> [LOCAL_PATH ...]
```

**Arguments:**

- `<LOCAL_PATH>`: One or more local files or directories. Each path creates a
  separate inbox file.

**Options:**

- `-i, --inbox-path <PATH>`: Virtual path on the server where uploaded files are stored.
- `--no-resume`: Skip resumable uploads.
- `--no-compress`: Do not zip directories; upload directories as tar archives.

**Examples:**

```bash
kaggle files upload report.csv
kaggle files upload -i experiments/run-1 output.csv metrics.json
kaggle files upload --no-resume --no-compress local-directory
kaggle files u -i scratch data.zip
```

**Purpose:** Upload arbitrary local files to an inbox location.

## Behavior Details

- The command accepts up to `MAX_NUM_INBOX_FILES_TO_UPLOAD`, currently 1000
  local paths.
- Each provided local path is uploaded independently.
- Directory paths are compressed by default as zip archives.
- With `--no-compress`, directory paths are uploaded using tar mode.
- Uploads use resumable upload machinery unless `--no-resume` is set.
- After uploading each blob, the CLI creates an inbox file and prints
  `Inbox file created: <name>`.

## Error Scenarios And Notes

- Paths that fail upload are skipped by the upload helper; successfully uploaded
  paths still proceed to inbox file creation.
- This command does not create Kaggle Datasets. Use `kaggle datasets create` or
  `kaggle datasets version` for dataset uploads.
- This command does not accept `-q/--quiet`; progress/noise behavior comes from
  the upload behavior.
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: 119kUpdated Claude CodeCodexVerifiedInstall
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: 119kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall