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/configuration.md

View on GitHub
# Configuration CLI Reference

Use `kaggle config` to view, set, and unset local Kaggle CLI configuration. The
CLI reads config from a JSON file plus `KAGGLE_` environment variables.

## Prerequisites

- Python 3.11+ with the `kaggle` package installed.
- Write access to the Kaggle config directory when setting or unsetting values.

## Command Hierarchy

```text
kaggle config
├── view
├── set
└── unset
```

## Configuration File Location

- If `KAGGLE_CONFIG_DIR` is set, the CLI uses that directory.
- Otherwise it normally uses `~/.kaggle`.
- On Linux, when `~/.kaggle` does not exist, it follows the XDG config path:
  `${XDG_CONFIG_HOME:-~/.config}/kaggle`.
- The config file name is `kaggle.json`.
- Newly created config files are chmodded to `0600`.
- Environment variables beginning with `KAGGLE_` are merged into config values
  after file values are read.

## `kaggle config view`

Prints current config values.

**Usage:**

```bash
kaggle config view
```

**Options:**

- None.

**Examples:**

```bash
kaggle config view
```

**Purpose:** Inspect configured username, auth method, path, proxy, and default
competition.

## `kaggle config set`

Sets a configuration value.

**Usage:**

```bash
kaggle config set -n <NAME> -v <VALUE>
```

**Options:**

- `-n, --name <NAME>`: Config key.
- `-v, --value <VALUE>`: Config value.

**Common names:**

- `competition`: Default competition slug.
- `path`: Default download folder.
- `proxy`: Proxy for HTTP requests.

**Examples:**

```bash
kaggle config set -n competition -v titanic
kaggle config set -n path -v /tmp/kaggle-downloads
kaggle config set -n proxy -v http://proxy.example:8080
```

**Purpose:** Persist default values used by other commands.

## `kaggle config unset`

Removes a configuration value from the config file.

**Usage:**

```bash
kaggle config unset -n <NAME>
```

**Options:**

- `-n, --name <NAME>`: Config key to remove.

**Examples:**

```bash
kaggle config unset -n competition
```

**Purpose:** Clear a persisted default and return to fallback behavior.

## Behavior Details

- `set` updates both the in-memory config and the JSON config file.
- `unset` removes a key only from the config file; environment variables can
  still provide a value on the next load.
- Download commands use configured `path` as the base default when no explicit
  path is provided.
- Competition commands that accept optional competition slugs can use configured
  `competition` as the default.

## Notes

- CLI help text names `competition`, `path`, and `proxy` as valid config names.
  Authentication-related keys may also appear in config output.
- If the config file is world-readable on non-Windows systems, the CLI prints a
  permissions warning.
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