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

View on GitHub
#!/usr/bin/env python3
"""Badge Collector orchestrator — main entry point.

Usage:
    python orchestrator.py --dry-run            # Show planned actions for every phase
    python orchestrator.py --dry-run --phase 2  # Dry-run for a specific phase
    python orchestrator.py --phase 1            # Run phase 1 only
    python orchestrator.py --phase all          # Run all phases (1-5)
    python orchestrator.py --resume             # Run every phase, retrying unfinished badges
    python orchestrator.py --status             # Show progress table
"""

import argparse
import sys
import traceback
from pathlib import Path

# Add scripts dir to path so imports work
sys.path.insert(0, str(Path(__file__).resolve().parent))

from badge_registry import get_badges_by_phase  # noqa: E402
from badge_tracker import (  # noqa: E402
    load_progress,
    print_status_table,
    set_resume,
    should_attempt,
)
from utils import check_credentials, get_username  # noqa: E402


def dry_run(phases: list[int]) -> None:
    """Show what would be done without executing."""
    print("\n[DRY RUN] Planned actions:\n")
    total = 0
    for phase in phases:
        badges = get_badges_by_phase(phase)
        actionable = [b for b in badges if should_attempt(b.id)]
        if not actionable:
            continue
        print(f"  Phase {phase}: {len(actionable)} badge(s)")
        for badge in actionable:
            print(f"    - {badge.name}: {badge.description}")
            total += 1
    print(f"\n  Total: {total} badge(s) would be attempted\n")


def run_phase(phase: int, username: str) -> tuple[int, int]:
    """Run a single phase. Returns (attempted, succeeded)."""
    badges = get_badges_by_phase(phase)
    actionable = [b for b in badges if should_attempt(b.id)]

    if not actionable:
        print(f"\n  Phase {phase}: No badges to attempt (all earned/skipped)")
        return 0, 0

    print(f"\n{'=' * 60}")
    print(f"  Phase {phase}: Attempting {len(actionable)} badge(s)")
    print(f"{'=' * 60}\n")

    # Import the phase module (explicit imports for security auditability)
    if phase == 1:
        from phase_1_instant_api import run as phase_run
    elif phase == 2:
        from phase_2_competition import run as phase_run
    elif phase == 3:
        from phase_3_pipeline import run as phase_run
    elif phase == 4:
        from phase_4_browser import run as phase_run
    elif phase == 5:
        from phase_5_streaks import run as phase_run
    else:
        print(f"  Unknown phase: {phase}")
        return 0, 0

    attempted, succeeded = phase_run(username)
    print(f"\n  Phase {phase} complete: {succeeded}/{attempted} badges earned\n")
    return attempted, succeeded


def main() -> None:
    parser = argparse.ArgumentParser(description="Kaggle Badge Collector")
    parser.add_argument("--phase", type=str, default=None, help="Phase to run: 1-5, or 'all'")
    parser.add_argument("--status", action="store_true", help="Show badge progress table")
    parser.add_argument(
        "--resume",
        action="store_true",
        help="Also retry badges left as attempting or skipped; "
        "runs every phase unless --phase is given",
    )
    parser.add_argument(
        "--dry-run", action="store_true", help="Show planned actions without executing"
    )

    args = parser.parse_args()

    # --status: just show progress
    if args.status:
        print_status_table()
        return

    set_resume(args.resume)

    # Determine which phases to run. --dry-run and --resume cover every phase
    # when no --phase is given.
    if args.phase is None:
        if not (args.dry_run or args.resume):
            parser.print_help()
            return
        args.phase = "all"

    if args.phase == "all":
        phases = [1, 2, 3, 4, 5]
    else:
        try:
            phases = [int(args.phase)]
        except (ValueError, TypeError):
            print(f"Invalid phase: {args.phase}. Use 1-5 or 'all'.")
            sys.exit(1)

    # --dry-run: show what would be done
    if args.dry_run:
        dry_run(phases)
        return

    # Check credentials
    print("Checking Kaggle credentials...")
    if not check_credentials():
        print("\n[ERROR] Kaggle credentials not configured.")
        print("Run `kaggle auth login`, set KAGGLE_API_TOKEN, or create ~/.kaggle/access_token")
        sys.exit(1)

    username = get_username()
    if not username:
        print("\n[ERROR] Could not determine the Kaggle username.")
        print("The Kaggle CLI did not sign in with the configured credential.")
        sys.exit(1)

    print(f"  Username: {username}")
    print(f"  Phases: {phases}")
    print(f"  Resume mode: {args.resume}")

    # Initialize progress file
    load_progress()

    # Run phases
    total_attempted = 0
    total_succeeded = 0

    phase_errors = 0
    for phase in phases:
        try:
            attempted, succeeded = run_phase(phase, username)
            total_attempted += attempted
            total_succeeded += succeeded
        except Exception as e:
            phase_errors += 1
            print(f"\n  [ERROR] Phase {phase} failed: {e}")
            traceback.print_exc()
            continue

    # Final summary
    print(f"\n{'=' * 60}")
    print(f"  COMPLETE: {total_succeeded}/{total_attempted} badges earned")
    print(f"{'=' * 60}")
    print_status_table()
    if phase_errors:
        sys.exit(1)


if __name__ == "__main__":
    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