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/badges/scripts/utils.py

View on GitHub
"""Shared utilities for the badges workflow."""

from __future__ import annotations

import os
import subprocess
import sys
import tempfile
import time
from pathlib import Path

# Rate limiting: seconds between API calls
API_DELAY = 5

# Prefix for all created resources
RESOURCE_PREFIX = "kaggle-badges-"

# Skill root: skills/kaggle
SKILL_ROOT = Path(__file__).resolve().parents[3]
REPO_ROOT = SKILL_ROOT.parent.parent
SETUP_SCRIPTS = SKILL_ROOT / "modules" / "setup" / "scripts"
TEMPLATES_DIR = Path(__file__).resolve().parent / "templates"

# Where progress and scratch files go. The default is the skill folder, as in
# earlier releases. Set KAGGLE_BADGES_STATE_DIR to keep them somewhere else,
# for example when the skill is installed in a read-only plugin cache.
_STATE_OVERRIDE = os.environ.get("KAGGLE_BADGES_STATE_DIR", "")
STATE_DIR = Path(_STATE_OVERRIDE).expanduser() if _STATE_OVERRIDE else SKILL_ROOT

sys.path.insert(0, str(SKILL_ROOT))

from shared import credentials, kaggle_cli, untrusted  # noqa: E402

credentials.load_configured_env_file()


def get_username() -> str:
    """Kaggle username from the shared credential resolver."""
    return credentials.username()


def get_kaggle_cli() -> str:
    """Path of the kaggle CLI binary."""
    return kaggle_cli.kaggle_bin()


def run_kaggle_cli(
    args: list[str], check: bool = True, timeout: int = 120
) -> subprocess.CompletedProcess:
    """Run a kaggle CLI command with rate limiting.

    The CLI runs through the shared runner, so a failure it reports with exit
    status 0 ("Kernel push error: ...") comes back as a non-zero return code
    and raises when ``check`` is set. A badge is never recorded from a command
    that did not succeed.
    """
    print(f"  $ kaggle {' '.join(args)}")
    result = kaggle_cli.run(args, timeout=timeout)
    if check and result.returncode != 0:
        show_cli_output(result)
        raise subprocess.CalledProcessError(
            result.returncode, ["kaggle", *args], result.stdout, result.stderr
        )
    time.sleep(API_DELAY)
    return result


def show_cli_output(result: subprocess.CompletedProcess) -> None:
    """Print what the CLI said about a failure. The text comes from Kaggle, so it is wrapped."""
    message = (
        result.stderr.strip() or kaggle_cli.find_failure(result.stdout) or result.stdout.strip()
    )
    with untrusted.Block(source="kaggle-cli", tool="badges") as block:
        block.write(message[:500] or "(no output)")


def kernel_status(kernel: str) -> str:
    """Status word of a notebook run, e.g. COMPLETE, RUNNING, ERROR. '' if unknown."""
    result = kaggle_cli.run(["kernels", "status", kernel], timeout=120)
    if result.returncode != 0:
        return ""
    marker = ' has status "'
    for line in reversed(result.stdout.splitlines()):
        if marker in line:
            status = line.split(marker, 1)[1].split('"', 1)[0]
            return status.rsplit(".", 1)[-1].upper()
    return ""


def make_temp_dir(suffix: str = "") -> Path:
    """Create a temporary directory under badge-tmp/."""
    tmp_base = STATE_DIR / "badge-tmp"
    tmp_base.mkdir(parents=True, exist_ok=True)
    return Path(tempfile.mkdtemp(prefix=RESOURCE_PREFIX, suffix=suffix, dir=tmp_base))


def check_credentials() -> bool:
    """True when a Kaggle credential is configured. Reads only; writes nothing."""
    found = credentials.discover()
    if not found:
        print("No Kaggle credentials found.")
        return False
    print(f"Kaggle credentials found: {found[0].kind} from {found[0].source}")
    return True


def resource_name(kind: str, suffix: str = "") -> str:
    """Generate a unique resource name with prefix."""
    ts = int(time.time())
    name = f"{RESOURCE_PREFIX}{kind}-{ts}"
    if suffix:
        name += f"-{suffix}"
    return name


def slug(name: str) -> str:
    """Convert a name to a Kaggle-compatible slug."""
    return name.lower().replace(" ", "-").replace("_", "-")
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