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

View on GitHub
"""Phase 5: Streak badges (4 badges).

Runs today's streak actions and generates a reusable daily script:
  - 7-Day Login Streak
  - 30-Day Login Streak
  - Submission Streak (7 days)
  - Super Submission Streak (30 days)

The script is generated for the user to schedule themselves if desired.
No cron jobs or launchd plists are installed automatically.
"""

import platform
import shlex
import stat
from pathlib import Path

from badge_tracker import set_status, should_attempt
from utils import SKILL_ROOT, STATE_DIR, TEMPLATES_DIR, get_kaggle_cli, run_kaggle_cli

if STATE_DIR == SKILL_ROOT:
    DAILY_SCRIPT_PATH = SKILL_ROOT / "modules" / "badges" / "scripts" / "daily_streak.sh"
else:
    DAILY_SCRIPT_PATH = STATE_DIR / "daily_streak.sh"


def _create_daily_script() -> Path:
    """Create the daily streak script (no credentials embedded)."""
    kaggle_cli = shlex.quote(get_kaggle_cli())
    submission_file = shlex.quote(str(TEMPLATES_DIR / "submission_titanic.csv"))

    script = f"""#!/usr/bin/env bash
# Daily Kaggle streak script — auto-generated by kaggle-badges
# Makes an API call (counts as login) and submits to Titanic
# Credentials are read by the Kaggle CLI at runtime; none are stored here.

set -uo pipefail

KAGGLE={kaggle_cli}
SUBMISSION={submission_file}
# The CLI prints request headers when VERBOSE is set; keep them out of logs.
unset VERBOSE VERBOSE_OUTPUT KAGGLE_API_ENVIRONMENT

# 1. API activity = login
if ! "$KAGGLE" datasets list --page 1 > /dev/null 2>&1; then
    echo "[$(date)] API call failed" >&2
fi

# 2. Daily Titanic submission (if submission file exists)
if [ -f "$SUBMISSION" ]; then
    if ! "$KAGGLE" competitions submit titanic \\
        -f "$SUBMISSION" \\
        -m "Daily streak submission $(date +%Y-%m-%d)" \\
        > /dev/null 2>&1; then
        echo "[$(date)] Titanic submission failed" >&2
    fi
fi

echo "[$(date)] Streak script completed"
"""
    DAILY_SCRIPT_PATH.parent.mkdir(parents=True, exist_ok=True)
    DAILY_SCRIPT_PATH.write_text(script)
    # Owner-only read/write/execute (no group or world access)
    DAILY_SCRIPT_PATH.chmod(stat.S_IRWXU)
    return DAILY_SCRIPT_PATH


def _run_today() -> bool:
    """Run today's streak actions inline. True when both actions succeeded."""
    print("  Running today's streak actions...")
    ok = True

    # 1. API activity (counts as login)
    result = run_kaggle_cli(["datasets", "list", "--page", "1"], check=False)
    if result.returncode == 0:
        print("    API login activity: OK")
    else:
        ok = False
        print("    API login activity: FAILED")

    # 2. Titanic submission
    submission_file = TEMPLATES_DIR / "submission_titanic.csv"
    if submission_file.exists():
        result = run_kaggle_cli(
            [
                "competitions",
                "submit",
                "titanic",
                "-f",
                str(submission_file),
                "-m",
                "Daily streak submission",
            ],
            check=False,
        )
        if result.returncode == 0:
            print("    Titanic submission: OK")
        else:
            ok = False
            print("    Titanic submission: FAILED")
    else:
        ok = False
        print(f"    Titanic submission: SKIPPED (no {submission_file})")

    return ok


def _print_scheduling_instructions(script_path: Path) -> None:
    """Print instructions for the user to set up their own daily scheduling."""
    system = platform.system()

    print("\n  --- Manual scheduling instructions ---")
    print(f"  Daily script created at: {script_path}")
    print()

    if system == "Darwin":
        print("  To schedule on macOS (launchd):")
        print("    1. Create a plist at ~/Library/LaunchAgents/com.kaggle.streak.plist")
        print(f"       with ProgramArguments pointing to: /bin/bash {script_path}")
        print("    2. Load it: launchctl load ~/Library/LaunchAgents/com.kaggle.streak.plist")
        print()
        print("  Or use cron:")
        print("    crontab -e   # then add:")
        print(f"    0 10 * * * {script_path}")
    else:
        print("  To schedule on Linux (cron):")
        print("    crontab -e   # then add:")
        print(f"    0 10 * * * {script_path}")

    print()
    print("  Credentials are read by the Kaggle CLI at runtime (API token,")
    print("  kaggle.json or OAuth login); none are stored in the script.")
    print("  Badges will be earned after 7/30 days of daily execution.")


def run(username: str) -> tuple[int, int]:
    """Run today's streak actions and generate reusable script.

    Returns (attempted, succeeded).
    """
    badge_ids = [
        "seven_day_login_streak",
        "thirty_day_login_streak",
        "submission_streak",
        "super_submission_streak",
    ]

    actionable = [b for b in badge_ids if should_attempt(b)]
    if not actionable:
        print("  All streak badges already earned/skipped")
        return 0, 0

    print("\n  --- Phase 5: Streak badges ---")

    # Run today's actions immediately
    today_ok = _run_today()

    # Generate the reusable daily script
    script_path = _create_daily_script()

    # Print instructions for manual scheduling
    _print_scheduling_instructions(script_path)

    # A streak is earned over 7 or 30 days, so nothing is earned today. The
    # badges stay "attempting"; run again with --resume to do the next day.
    details = (
        "today's actions done; repeat daily for the full streak"
        if today_ok
        else "today's actions failed; fix the error and run again"
    )
    for bid in actionable:
        set_status(bid, "attempting", details)

    return len(actionable), 0
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