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/badge_tracker.py

View on GitHub
"""Badge progress tracker with JSON persistence.

Tracks each badge's status: pending, attempting, earned, failed, skipped.
"earned" means the action that earns the badge completed; the tracker cannot
see your Kaggle profile. Persists to badge-progress.json in the skill folder,
or in KAGGLE_BADGES_STATE_DIR when that is set.
"""

from __future__ import annotations

import json
from datetime import datetime, timezone
from typing import Optional

from badge_registry import ALL_BADGES
from utils import STATE_DIR

PROGRESS_FILE = STATE_DIR / "badge-progress.json"

# With --resume, badges left as "attempting" or "skipped" are tried again too.
_RESUME = False


def set_resume(enabled: bool) -> None:
    """Turn resume mode on or off for this process."""
    global _RESUME
    _RESUME = enabled


def _now() -> str:
    return datetime.now(timezone.utc).isoformat()


def load_progress() -> dict:
    """Load progress from disk, initializing any missing badges."""
    data: dict = {}
    if PROGRESS_FILE.exists():
        data = json.loads(PROGRESS_FILE.read_text())

    # Ensure all badges are tracked
    for badge in ALL_BADGES:
        if badge.id not in data:
            data[badge.id] = {
                "status": "pending",
                "updated": None,
                "details": None,
            }
    return data


def save_progress(data: dict) -> None:
    """Save progress to disk."""
    PROGRESS_FILE.parent.mkdir(parents=True, exist_ok=True)
    PROGRESS_FILE.write_text(json.dumps(data, indent=2) + "\n")


def set_status(badge_id: str, status: str, details: Optional[str] = None) -> None:
    """Update a badge's status."""
    data = load_progress()
    if badge_id not in data:
        data[badge_id] = {}
    data[badge_id]["status"] = status
    data[badge_id]["updated"] = _now()
    if details:
        data[badge_id]["details"] = details
    save_progress(data)


def get_status(badge_id: str) -> str:
    """Get a badge's current status."""
    data = load_progress()
    return data.get(badge_id, {}).get("status", "pending")


def is_earned(badge_id: str) -> bool:
    """Check if a badge has been earned."""
    return get_status(badge_id) == "earned"


def should_attempt(badge_id: str) -> bool:
    """Whether to attempt a badge now.

    Pending and failed badges are always attempted. In resume mode, badges
    left as "attempting" (an interrupted run, or a streak in progress) and
    "skipped" are attempted as well. Earned badges never are.
    """
    status = get_status(badge_id)
    if status in ("pending", "failed"):
        return True
    return _RESUME and status in ("attempting", "skipped")


def print_status_table() -> None:
    """Print a formatted status table of all badges."""
    data = load_progress()

    # Count by status
    counts: dict[str, int] = {}
    for info in data.values():
        s = info.get("status", "pending")
        counts[s] = counts.get(s, 0) + 1

    total = len(ALL_BADGES)
    earned = counts.get("earned", 0)

    print(f"\n{'=' * 60}")
    print(f"  Badge Progress: {earned}/{total} earned")
    print(f"{'=' * 60}")
    print(f"  Earned:     {counts.get('earned', 0)}")
    print(f"  Pending:    {counts.get('pending', 0)}")
    print(f"  Attempting: {counts.get('attempting', 0)}")
    print(f"  Failed:     {counts.get('failed', 0)}")
    print(f"  Skipped:    {counts.get('skipped', 0)}")
    print(f"{'=' * 60}\n")

    # Group by phase
    for phase in [1, 2, 3, 4, 5, None]:
        phase_label = f"Phase {phase}" if phase else "Not Automatable"
        phase_badges = [b for b in ALL_BADGES if b.phase == phase]
        if not phase_badges:
            continue

        print(f"  --- {phase_label} ---")
        for badge in phase_badges:
            info = data.get(badge.id, {})
            status = info.get("status", "pending")
            icon = {
                "earned": "[x]",
                "attempting": "[~]",
                "failed": "[!]",
                "skipped": "[-]",
                "pending": "[ ]",
            }.get(status, "[ ]")
            details = info.get("details", "")
            detail_str = f" ({details})" if details else ""
            print(f"    {icon} {badge.name}{detail_str}")
        print()
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