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/competitions/scripts/competition_watch.py

View on GitHub
#!/usr/bin/env python3
"""Wait until Kaggle has scored a submission, then report and record the score.

    competition_watch.py titanic                    the newest submission
    competition_watch.py titanic --ref 53336045     a specific one
    competition_watch.py titanic --timeout 3600 --interval 60

Reads the submission every --interval seconds until Kaggle has scored it or
reported an error, or --timeout seconds have passed. The score goes into
./.kaggle-skill/ledger.jsonl. When the submit command recorded a score you
expected, the gap to it is printed.

Needs a credential: an API token or `kaggle auth login`. It only reads.

Exit status: 0 scored, 1 the submission failed or was not found, 124 still
pending at the timeout, 4 the submission could not be read.
"""

from __future__ import annotations

import argparse
import sys
import time
from pathlib import Path

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

from shared import competition, credentials, ledger, mcp_client, script, untrusted  # noqa: E402

SOURCE = "kaggle-mcp"
TOOL = competition.SUBMISSIONS_TOOL
MAX_FAILED_READS = 5
FINISHED = ("COMPLETE", "ERROR")


LISTED = 100  # submissions read to confirm that --ref belongs to the competition


def read(slug: str, token: str, ref: int | None):
    """The submission with this id, or your newest.

    Returns ``(row or None, result, in this competition)``. A submission read
    by its id alone cannot be tied to a competition: the answer does not name
    one. It is looked for among the competition's latest submissions first.
    """
    if ref is None:
        rows, result = competition.fetch_submissions(slug, token, limit=1)
        return (rows[0] if rows else None), result, True
    rows, result = competition.fetch_submissions(slug, token, limit=LISTED)
    if result.ok:
        for row in rows:
            if str(row["ref"]) == str(ref):
                return row, result, True
    row, result = competition.fetch_submission(ref, token)
    return row, result, False


def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(
        description="Wait until Kaggle has scored a submission, then report and record the score.",
        epilog="Needs a Kaggle credential: an API token or `kaggle auth login`.",
    )
    script.add_competition(parser)
    parser.add_argument("--ref", type=int, help="The submission id (default: your newest)")
    parser.add_argument(
        "--interval",
        type=script.positive_int,
        default=30,
        metavar="SECONDS",
        help="Time between checks (default: 30)",
    )
    parser.add_argument(
        "--timeout",
        type=int,
        default=1800,
        metavar="SECONDS",
        help="Stop waiting after this long; 0 checks once (default: 1800)",
    )
    args = parser.parse_args(argv)
    (slug,) = script.positionals(parser, args)

    credentials.load_configured_env_file()
    token = mcp_client.resolve_token()
    if not token:
        return script.no_credential("watching a submission")

    waited = 0
    failed_reads = 0
    while True:
        row, result, confirmed = read(slug, token, args.ref)
        if not result.ok:
            failed_reads += 1
            # A denial for --ref means the submission is someone else's: no use waiting.
            if result.status == "unauthenticated" or result.denied:
                return result.fail(competition=slug)
            if failed_reads >= MAX_FAILED_READS:
                result.fail(competition=slug)
                return script.EXIT_UNAVAILABLE
        else:
            failed_reads = 0
            if row is None:
                what = f"submission {args.ref}" if args.ref else "any submission of yours"
                return script.fail(f"{what} was not found in {slug}", script.EXIT_FAILED)
            if row["status"] in FINISHED:
                break
            print(f"[{time.strftime('%H:%M:%S')}] submission {row['ref']}: still being scored")
        if waited >= args.timeout:
            if failed_reads:
                # The last read failed, so whether it is still pending is not known.
                result.fail(competition=slug)
                return script.EXIT_UNAVAILABLE
            print(
                f"Still pending after {waited}s. Run this again to keep waiting.", file=sys.stderr
            )
            return script.EXIT_TIMEOUT
        time.sleep(args.interval)
        waited += args.interval

    score = row["public_score"]
    expected = ledger.expected_for(row["ref"])
    # The description and any error text were written by the user or by Kaggle.
    with untrusted.Block(source=SOURCE, tool=TOOL, competition=slug) as block:
        block.write(f"submission {row['ref']}: {row['status']}")
        block.write(f"  public score: {score or 'none'}")
        block.write(f"  sent:         {row['date']}")
        block.write(f"  message:      {row['description']}")
        if row["error"]:
            block.write(f"  error:        {row['error']}")
    value = competition.score_value(score)
    if expected is not None and value is not None:
        print(f"Expected {expected:g}, got {value:g}: a difference of {value - expected:+.5g}.")
    if not confirmed:
        script.warn(
            f"submission {row['ref']} is not among your latest {LISTED} in {slug}, so it "
            "may belong to another competition; its score is not recorded in the ledger"
        )
    elif not ledger.has_score(row["ref"]):
        record = {
            "event": "score",
            "competition": slug,
            "ref": row["ref"],
            "status": row["status"],
            "public_score": score,
        }
        try:
            print(f"Recorded in {ledger.append(record)}.")
        except OSError as exc:
            script.warn(f"the score was not recorded in the ledger: {exc}")
    return script.EXIT_OK if row["status"] == "COMPLETE" else script.EXIT_FAILED


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