Skip to content

shepsci/kaggle-skill / skills/kaggle

kaggle

Flagged

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

FileKindSize
SKILL.mdskill md10.3 KB
modules/README.mdmarkdown2.3 KB
modules/badges/README.mdmarkdown1.6 KB
modules/badges/references/badge-catalog.mdmarkdown6.6 KB
modules/badges/scripts/badge_registry.pyscript8.5 KB
modules/badges/scripts/badge_tracker.pyscript4.1 KB
modules/badges/scripts/orchestrator.pyscript5.3 KB
modules/badges/scripts/phase_1_instant_api.pyscript24.0 KB
modules/badges/scripts/phase_2_competition.pyscript13.5 KB
modules/badges/scripts/phase_3_pipeline.pyscript11.7 KB
modules/badges/scripts/phase_4_browser.pyscript2.2 KB
modules/badges/scripts/phase_5_streaks.pyscript5.6 KB
modules/badges/scripts/templates/README_dataset.mdmarkdown573 B
modules/badges/scripts/templates/dataset-metadata.jsonconfig871 B
modules/badges/scripts/templates/kernel-metadata.jsonconfig412 B
modules/badges/scripts/templates/model-instance-metadata.jsonconfig253 B
modules/badges/scripts/templates/model-metadata.jsonconfig355 B
modules/badges/scripts/templates/python_notebook.ipynbother1.3 KB
modules/badges/scripts/templates/r_notebook.ipynbother1.1 KB
modules/badges/scripts/templates/submission_titanic.csvother2.8 KB
modules/badges/scripts/templates/utility_script.pyscript802 B
modules/badges/scripts/utils.pyscript3.9 KB
modules/benchmarks/README.mdmarkdown1.2 KB
modules/benchmarks/references/benchmark-endpoints.mdmarkdown1.6 KB
modules/benchmarks/references/benchmarks-cli.mdmarkdown4.4 KB
modules/competitions/README.mdmarkdown5.8 KB
modules/competitions/hackathons/README.mdmarkdown2.9 KB
modules/competitions/hackathons/references/episode-endpoints.mdmarkdown2.2 KB
modules/competitions/hackathons/references/hackathon-endpoints.mdmarkdown4.6 KB
modules/competitions/hackathons/scripts/fetch_writeup.pyexecutablescript10.5 KB
modules/competitions/hackathons/scripts/hackathon_overview.pyexecutablescript1.5 KB
modules/competitions/hackathons/scripts/list_writeups.pyexecutablescript9.9 KB
modules/competitions/references/competition-categories.mdmarkdown2.1 KB
modules/competitions/references/competition-operations.mdmarkdown5.7 KB
modules/competitions/references/competition-overview.mdmarkdown3.9 KB
modules/competitions/references/competition-research.mdmarkdown3.0 KB
modules/competitions/scripts/competition_brief.pyscript5.4 KB
modules/competitions/scripts/competition_details.pyscript8.2 KB
modules/competitions/scripts/competition_download.pyscript5.1 KB
modules/competitions/scripts/competition_episodes.pyscript9.2 KB
modules/competitions/scripts/competition_leaderboard.pyscript12.3 KB
modules/competitions/scripts/competition_ledger.pyscript3.3 KB
modules/competitions/scripts/competition_pages.pyexecutablescript1.7 KB
modules/competitions/scripts/competition_status.pyscript9.0 KB
modules/competitions/scripts/competition_submit.pyscript8.9 KB
modules/competitions/scripts/competition_validate.pyscript14.2 KB
modules/competitions/scripts/competition_watch.pyscript5.9 KB
modules/competitions/scripts/list_competitions.pyscript13.3 KB
modules/datasets/README.mdmarkdown2.1 KB
modules/datasets/references/kagglehub-datasets.mdmarkdown2.6 KB
modules/datasets/scripts/dataset_download.pyscript4.1 KB
modules/datasets/scripts/dataset_publish.pyscript5.5 KB
modules/discussions/README.mdmarkdown2.1 KB
modules/discussions/references/writeups.mdmarkdown5.8 KB
modules/discussions/scripts/forums.pyscript22.0 KB
modules/discussions/scripts/leaderboard_writeups.pyscript24.8 KB
modules/models/README.mdmarkdown2.6 KB
modules/models/references/kagglehub-models.mdmarkdown1.7 KB
modules/models/scripts/model_download.pyscript4.5 KB
modules/models/scripts/model_publish.pyscript8.7 KB
modules/notebooks/README.mdmarkdown2.6 KB
modules/notebooks/scripts/notebook_push.pyscript5.7 KB
modules/notebooks/scripts/notebook_run.pyscript2.8 KB
modules/notebooks/scripts/notebook_wait.pyscript3.7 KB
modules/references/README.mdmarkdown454 B
modules/references/cli-reference.mdmarkdown13.4 KB
modules/references/kaggle-knowledge.mdmarkdown7.6 KB
modules/references/mcp-reference.mdmarkdown18.9 KB
modules/setup/README.mdmarkdown3.0 KB
modules/setup/references/kaggle-setup.mdmarkdown6.7 KB
modules/setup/scripts/check_all_credentials.pyscript5.7 KB
modules/setup/scripts/doctor.pyscript10.2 KB
modules/setup/scripts/save_credentials.pyscript3.9 KB
scripts/kaggle_skill.pyscript11.5 KB
shared/__init__.pyscript0 B
shared/competition.pyscript20.0 KB
shared/credentials.pyscript9.6 KB
shared/hub.pyscript2.9 KB
shared/kaggle_cli.pyscript20.7 KB
shared/ledger.pyscript3.6 KB
shared/mcp_client.pyscript11.6 KB
shared/net.pyscript6.9 KB
shared/notebook.pyscript4.4 KB
shared/preflight.pyscript5.1 KB
shared/safe_extract.pyscript2.7 KB
shared/script.pyscript11.2 KB
shared/text.pyscript10.5 KB
shared/untrusted.pyscript7.6 KB

modules/notebooks/scripts/notebook_push.py

View on GitHub
#!/usr/bin/env python3
"""Push a notebook to Kaggle, which also runs it. A dry run unless --yes is given.

    notebook_push.py ./notebook-dir          dry run: what would be pushed
    notebook_push.py ./notebook-dir --yes    push

The folder holds the notebook and its kernel-metadata.json. Pushing creates a
new version and starts a run on Kaggle: with an accelerator switched on, that
run uses the account's weekly GPU hours. Get the user's go-ahead before --yes.

Kaggle receives the code file named in kernel-metadata.json and the settings
in that file, nothing else from the folder. The code file must be inside the
folder and must not look like a credential file (exit status 5). To wait for
the run and fetch its output, use the notebook-run or notebook-wait command.
"""

from __future__ import annotations

import argparse
import sys
from pathlib import Path

SKILL_ROOT = Path(__file__).resolve().parents[3]
sys.path.insert(0, str(SKILL_ROOT))

from shared import credentials, kaggle_cli, notebook, preflight, script  # noqa: E402

GPU_WORDS = ("gpu", "nvidia")
SOURCES = (
    ("competition_sources", "competition data"),
    ("dataset_sources", "datasets"),
    ("model_sources", "models"),
    ("kernel_sources", "notebooks"),
)


def plan(folder: Path) -> tuple[str, list[tuple[str, str]], str] | int:
    """What a push of ``folder`` would do: ``(notebook id, details, cost)``, or an exit code."""
    metadata = notebook.read_metadata(folder)
    if metadata is None:
        return script.fail(
            f"{folder / notebook.METADATA_FILE} is missing or unreadable. Write a template "
            f"with: kaggle kernels init -p {folder}",
            script.EXIT_USAGE,
        )
    slug = str(metadata.get("id") or "")
    if not script.is_handle(slug, 2):
        return script.fail(
            f"the id in {notebook.METADATA_FILE} is not owner/name", script.EXIT_USAGE
        )
    code = code_file(folder, metadata)
    if isinstance(code, int):
        return code

    def flag(name: str, default: bool) -> bool:
        value = metadata.get(name, default)
        return value if isinstance(value, bool) else str(value).lower() == "true"

    # kaggle 2.2.4 sends enable_gpu, enable_tpu and machine_shape; a machine
    # shape such as NvidiaTeslaT4 picks the accelerator by itself.
    shape = str(metadata.get("machine_shape") or "")
    tpu = flag("enable_tpu", False) or "tpu" in shape.lower()
    gpu = not tpu and (flag("enable_gpu", False) or any(w in shape.lower() for w in GPU_WORDS))
    accelerator = "TPU" if tpu else "GPU" if gpu else "none"
    details = [
        ("notebook", slug),
        ("code file", f"{code.relative_to(folder.resolve())} ({preflight.size_text(code)})"),
        ("visibility", "private" if flag("is_private", True) else "PUBLIC"),
        ("accelerator", f"{accelerator} (machine shape {shape})" if shape else accelerator),
        ("internet", "on" if flag("enable_internet", True) else "off"),
    ]
    for key, label in SOURCES:
        sources = metadata.get(key) or []
        if isinstance(sources, list) and sources:
            shown = ", ".join(str(source) for source in sources[:5])
            more = f" and {len(sources) - 5} more" if len(sources) > 5 else ""
            details.append((label, shown + more))
    cost = "starts a run on Kaggle"
    if tpu or gpu:
        cost += f"; uses the weekly {accelerator} hours"
    return slug, details, cost


def code_file(folder: Path, metadata: dict) -> Path | int:
    """The code file Kaggle will receive, checked: inside the folder, not a credential."""
    name = str(metadata.get("code_file") or "")
    if not name:
        return script.fail(f"{notebook.METADATA_FILE} names no code_file", script.EXIT_USAGE)
    base = folder.resolve()
    path = (folder / name).resolve()
    if base not in path.parents:
        return script.fail(
            f"the code_file in {notebook.METADATA_FILE} is outside {folder}; refusing to send it",
            script.EXIT_REFUSED,
        )
    if preflight.looks_secret(path.name) or preflight.looks_secret(Path(name).name):
        return script.fail(
            f"the code_file in {notebook.METADATA_FILE} looks like a credential file; "
            "refusing to send it",
            script.EXIT_REFUSED,
        )
    if not path.is_file():
        return script.fail(f"the code_file {name} is not in {folder}", script.EXIT_USAGE)
    return path


def push(folder: Path) -> int:
    """Run ``kaggle kernels push``. The caller has confirmed."""
    if not kaggle_cli.installed():
        return script.missing_package("kaggle", "pushing a notebook")
    if credentials.resolve() is None:
        return script.no_credential("pushing a notebook")
    return kaggle_cli.run_wrapped(["kernels", "push", "-p", str(folder)], tool="kernels.push")


def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(
        description="Push a notebook to Kaggle, which also runs it. A dry run unless --yes "
        "is given.",
        epilog="Starts a run on Kaggle. Needs the Kaggle CLI and a credential.",
    )
    parser.add_argument("dir", help="Folder with the notebook and its kernel-metadata.json")
    script.add_yes(parser)
    args = parser.parse_args(argv)
    folder = Path(args.dir)

    planned = plan(folder)
    if isinstance(planned, int):
        return planned
    slug, details, cost = planned
    gate = script.write_gate(
        args.yes, action="push a notebook version and run it", details=details, cost=cost
    )
    if gate is not None:
        return gate

    credentials.load_configured_env_file()
    status = push(folder)
    if status != 0:
        return status
    print(f"Pushed {slug}. It is running on Kaggle; wait for it with: notebook-wait {slug}")
    return script.EXIT_OK


if __name__ == "__main__":
    sys.exit(main())
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