xiaoqianran/kaggle-demo / docs/skills/write-kaggle-benchmarks
write-kaggle-benchmarks
VerifiedWrite, push, run, publish, and manage Kaggle Benchmark tasks using the kaggle CLI and the kaggle-benchmarks Python SDK. Use when the user wants to create or push a benchmark task (optionally with attached Kaggle datasets), run benchmarks against LLM models, check task/run status, stream or fetch execution logs, download results and source notebooks, publish a task to make it public, or troubleshoot benchmark workflows.
README.md
View on GitHub# Write Kaggle Benchmarks Skill
This skill teaches AI coding agents how to write, push, run, and manage Kaggle Benchmark tasks using the `kaggle` CLI and the `kaggle-benchmarks` Python SDK.
## What this skill enables
With this skill installed, an agent can go from a blank file to a deployed benchmark in a single conversation:
```bash
# Write a task → validate locally → push → run → download results
kaggle b init -y
python task.py
kaggle b t push my-task -f task.py --wait
kaggle b t run my-task -m google/gemini-3.5-flash --wait
kaggle b t download my-task -o ./results
```
## Prerequisites
- Python 3.11+
- `kaggle` CLI installed (`pip install kaggle`)
- `kaggle-benchmarks` SDK installed (`pip install kaggle-benchmarks`)
- Valid Kaggle credentials (`kaggle auth login`, `KAGGLE_API_TOKEN` env var, or `~/.kaggle/access_token`)
## Structure
```
write-kaggle-benchmarks/
├── SKILL.md # Complete skill file — quick reference, CLI docs, and core workflow
└── README.md # This file
```
## Installation
Point your AI coding agent to read `SKILL.md`.
**Gemini CLI** — Copy to the auto-discovery location:
```bash
cp -r write-kaggle-benchmarks ~/.gemini/skills/write-kaggle-benchmarks
```
**Other tools** — Ask your agent to read `write-kaggle-benchmarks/SKILL.md`.
## Official resources
- [kaggle-benchmarks SDK](https://github.com/Kaggle/kaggle-benchmarks) — full source, API reference, and examples
- [SDK auto-generated docs](https://deepwiki.com/Kaggle/kaggle-benchmarks)
- [CLI benchmarks docs](https://github.com/Kaggle/kaggle-cli/blob/main/docs/benchmarks.md)
## Advanced use cases
`SKILL.md` is a focused recipe for the common write-push-run-download loop. For deeper SDK and CLI surface area not covered here, point your agent at the upstream skill files:
- [`kaggle-benchmarks/SKILL.md`](https://github.com/Kaggle/kaggle-benchmarks/blob/ci/skills/kaggle-benchmarks/SKILL.md) — complete SDK reference for benchmarks: every class, method, and pattern beyond the core workflow shown here.
- [`kaggle-cli/skills/references/benchmarks.md`](https://github.com/Kaggle/kaggle-cli/blob/main/skills/references/benchmarks.md) — complete CLI reference for benchmarks: every subcommand, flag, and option beyond the core workflow shown here.
## Version
`0.2`
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 |