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_brief.py

View on GitHub
#!/usr/bin/env python3
"""The facts about a Kaggle competition on one screen.

    competition_brief.py titanic
    competition_brief.py https://www.kaggle.com/competitions/titanic --json
    competition_brief.py titanic spaceship-titanic       several, one block each

Prints the metric and how the evaluation page starts, the deadline with the
time left, the host's timeline, the prize, the team size, the daily submission
limit, whether it is a code competition, and the names of its pages. A few hundred tokens, no
credential for a public competition. With a credential it also says whether
you have entered and your rank.

Read a page next with the pages command: pages <competition> --page NAME.
"""

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 competition, credentials, mcp_client, script, text, untrusted  # noqa: E402

SOURCE = "kaggle-mcp"
TOOL = competition.FACTS_TOOL


def data_facts(slug: str) -> dict | None:
    """How much data the competition has, or None when Kaggle does not say."""
    result = mcp_client.request(
        "get_competition_data_files_summary", {"competitionName": slug}, token=""
    )
    summary = result.data.get("file_summary_info") if isinstance(result.data, dict) else None
    if not result.ok or not isinstance(summary, dict):
        return None
    try:
        types = [
            {
                "extension": str(kind.get("extension") or ""),
                "files": int(kind.get("file_count") or 0),
                "bytes": int(kind.get("total_size") or 0),
            }
            for kind in summary.get("file_types") or []
        ]
        files = int(summary.get("total_file_count") or 0)
    except (TypeError, ValueError, AttributeError):
        return None
    types.sort(key=lambda kind: kind["bytes"], reverse=True)
    return {"files": files, "bytes": sum(kind["bytes"] for kind in types), "types": types}


def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(
        description="The facts about Kaggle competitions on one screen each.",
        epilog="No credential is needed for a public competition.",
    )
    script.add_competition(parser)
    parser.add_argument(
        "more", nargs="*", metavar="competition", help="More competitions, one block each"
    )
    script.add_json(parser)
    script.add_full(parser)
    args = parser.parse_args(argv)
    (slug,) = script.positionals(parser, args)
    slugs = [slug]
    for value in args.more:
        try:
            slugs.append(script.competition_slug(value))
        except ValueError as exc:
            parser.error(f"{exc}: {value}")

    credentials.load_configured_env_file()
    token = mcp_client.resolve_token()
    worst = script.EXIT_OK
    for name in dict.fromkeys(slugs):
        code = brief(name, token, args)
        worst = worst or code
    return worst


def brief(slug: str, token: str, args: argparse.Namespace) -> int:
    """Print one competition's brief. Returns its exit code."""
    result = competition.fetch_facts(slug, token)
    if not result.ok or not isinstance(result.data, dict):
        return result.fail(competition=slug)

    indent = 2 if args.pretty else None
    attrs = {"source": SOURCE, "tool": TOOL, "competition": slug}
    if args.full:
        untrusted.emit_json(result.data, indent=indent, **attrs)
        return script.EXIT_OK

    info = competition.facts(slug, result.data)
    # The page names tell the reader what there is to read next. A failure
    # here is not worth failing the brief for.
    pages = competition.pages_of(competition.fetch_pages(slug, token).data)
    info["pages"] = [{"name": p.get("name"), "chars": len(p.get("content") or "")} for p in pages]
    # "What is the metric?" usually needs a sentence more than the metric's name.
    info["evaluation"] = competition.page_summary(competition.find_page(pages, "evaluation"))
    # The host's own dates: entry, team merger and final submission deadlines.
    info["timeline"] = competition.timeline_summary(competition.find_page(pages, "timeline"))
    info["data"] = data_facts(slug)

    if script.hide_account():
        info = {**info, "user_has_entered": None, "user_rank": None}
    if args.json:
        untrusted.emit_json(info, indent=indent, **attrs)
        return script.EXIT_OK

    extra: list[tuple[str, str]] = []
    if info["data"]:
        kinds = ", ".join(
            f"{k['extension'] or 'other'} {text.human_size(k['bytes'])}"
            for k in info["data"]["types"][:4]
        )
        extra.append(
            (
                "data",
                f"{info['data']['files']:,} files, {text.human_size(info['data']['bytes'])} "
                f"({kinds})",
            )
        )
    if info["pages"]:
        first, *rest = info["pages"]
        names = [f"{first['name']} ({first['chars']:,} characters)"]
        names += [f"{p['name']} ({p['chars']:,})" for p in rest]
        extra.append(("pages", ", ".join(names)))

    with untrusted.Block(**attrs) as block:
        block.write(info["title"])
        if info["description"]:
            block.write(info["description"])
        signed_in = bool(token) and not script.hide_account()
        for line in competition.fact_lines(info, signed_in=signed_in, extra=extra):
            block.write(line)
    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