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/setup/scripts/check_all_credentials.py

View on GitHub
#!/usr/bin/env python3
"""Report which Kaggle credentials are configured.

Looks in the same places, in the same order, as the Kaggle CLI:

  1. API token   KAGGLE_API_TOKEN, then ~/.kaggle/access_token
  2. Legacy key  KAGGLE_USERNAME + KAGGLE_KEY, then kaggle.json
  3. OAuth       ~/.kaggle/credentials.json, written by `kaggle auth login`

The script only reads. It never writes, moves or prints a credential.

Usage:
    python3 modules/setup/scripts/check_all_credentials.py
    python3 modules/setup/scripts/check_all_credentials.py --verify
    python3 modules/setup/scripts/check_all_credentials.py --json

Finding a credential does not prove the server accepts it. --verify makes one
call that needs a signed-in account (`kaggle quota`) and reports the account.

For the packages, the CLI and the network as well, run doctor.py.

Exit codes:
    0  a credential was found (and accepted, with --verify)
    2  no credential was found, or --verify failed
"""

from __future__ import annotations

import argparse
import json
import os
import sys
from pathlib import Path

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

from shared import credentials, script  # noqa: E402

LABELS = {
    "api_token": "API token",
    "legacy_key": "Legacy API key",
    "oauth": "OAuth login",
}
SETUP_HELP = """No Kaggle credentials found. Pick one:

  1. Sign in with OAuth (recommended by the Kaggle CLI):
       kaggle auth login

  2. Use an API token from https://www.kaggle.com/settings ("Generate New Token"):
       mkdir -p ~/.kaggle && chmod 700 ~/.kaggle
       (umask 077 && cat > ~/.kaggle/access_token)   # paste the token, then Ctrl-D
     or export KAGGLE_API_TOKEN in your shell profile.

Public reads (competition pages, public datasets) work without credentials.
Full guide: modules/setup/references/kaggle-setup.md"""


def _loose_permissions(path: Path) -> str | None:
    """Return the file mode as text when group or others can read it."""
    try:
        mode = path.stat().st_mode & 0o777
    except OSError:
        return None
    return oct(mode)[-3:] if mode & 0o077 else None


def _credential_files() -> list[Path]:
    home = Path.home() / ".kaggle"
    return [
        home / "access_token",
        home / "access_token.txt",
        home / "credentials.json",
        credentials.config_dir() / "kaggle.json",
    ]


def collect(verify: bool = False) -> dict:
    """Gather the report as plain data. No secret values are included."""
    found = credentials.discover()
    report: dict = {
        "credentials": [
            {
                "kind": cred.kind,
                "label": LABELS[cred.kind],
                "source": cred.source,
                "username": cred.username or None,
                "token_type": credentials.describe_token(cred.secret) if cred.secret else None,
            }
            for cred in found
        ],
        "active": None,
        "warnings": [],
        "verified": None,
        "username": None,
    }
    if found:
        report["active"] = {"kind": found[0].kind, "source": found[0].source}

    for path in _credential_files():
        mode = _loose_permissions(path)
        if mode:
            report["warnings"].append(
                f"{path} is readable by other users (mode {mode}); run: chmod 600 {path}"
            )
    if os.environ.get("KAGGLE_TOKEN") and not os.environ.get("KAGGLE_API_TOKEN"):
        report["warnings"].append(
            "KAGGLE_TOKEN is set, but no Kaggle tool reads it; use KAGGLE_API_TOKEN"
        )

    if verify:
        ok, username = credentials.verify()
        report["verified"] = ok
        report["username"] = username or None
    return report


def print_report(report: dict) -> None:
    creds = report["credentials"]
    for cred in creds:
        details = [f"from {cred['source']}"]
        if cred["kind"] == "api_token" and cred["token_type"] not in (None, "token", "API token"):
            details.append(f"looks like: {cred['token_type']}")
        if cred["username"]:
            details.append(f"user: {cred['username']}")
        print(f"[OK] {cred['label']}: found ({', '.join(details)})")
    for warning in report["warnings"]:
        print(f"[WARN] {warning}")

    print()
    if not creds:
        print(SETUP_HELP)
        return

    active = report["active"]
    print(f"The Kaggle CLI will try the {LABELS[active['kind']]} from {active['source']} first.")
    if report["verified"] is True:
        who = f" as {report['username']}" if report["username"] else ""
        print(f"[OK] Verified: Kaggle accepted the credential{who}.")
    elif report["verified"] is False:
        print("[FAIL] Kaggle did not accept what is configured.")
        print("       The credential may be revoked or expired, or the Kaggle CLI is missing")
        print("       or older than 2.2.4.")
    else:
        print("Found is not the same as accepted: run again with --verify to check.")


def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(description="Report which Kaggle credentials are configured.")
    parser.add_argument("--json", action="store_true", help="Print the report as JSON only")
    parser.add_argument(
        "--verify", action="store_true", help="Ask the Kaggle CLI to authenticate with the server"
    )
    args = parser.parse_args(argv)

    credentials.load_configured_env_file()
    report = collect(verify=args.verify)

    if args.json:
        print(json.dumps(report, indent=2))
    else:
        print_report(report)

    if not report["credentials"]:
        return script.EXIT_NO_CREDENTIAL
    if args.verify and not report["verified"]:
        return script.EXIT_NO_CREDENTIAL
    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