Skip to content
cccskills
FreePublished on GitHub

kaggle-research

Search Kaggle datasets, competitions, notebooks, and models through its official command-line tool. Download public data into a chosen directory and preserve audit records and file hashes, identifiers used to check downloaded files.

OriginalShow the original description

Use when a research task needs reproducible Kaggle discovery, metadata inspection, bounded public-data downloads, competition or kernel discovery, model discovery, or an explicitly approved Kaggle write/delete operation through the official CLI.

Run score Not tested

See how to install

Good for

  • Finding Kaggle datasets and inspecting metadata
  • Downloading public data into a chosen directory
  • Discovering competitions, notebooks, and models
  • Keeping reproducible research records

Files included (25)

  • SKILL.md3.4 KB
  • references/authentication.md996 B
  • references/competitions.md765 B
  • references/datasets.md859 B
  • references/kernels.md735 B
  • references/models.md724 B
  • references/testing-and-safety.md1.6 KB
  • scripts/kaggle_research.py6.7 KB
  • scripts/kaggle_runtime/__init__.py476 B
  • scripts/kaggle_runtime/artifacts.py3.9 KB
  • scripts/kaggle_runtime/commands.py8.6 KB
  • scripts/kaggle_runtime/result.py2.3 KB
  • scripts/kaggle_runtime/runner.py6.9 KB
  • scripts/kaggle_runtime/security.py3.4 KB
  • scripts/kaggle_runtime/smoke.py7.6 KB
  • tests/__init__.py55 B
  • tests/_support.py239 B
  • tests/test_artifacts.py3.8 KB
  • tests/test_cli.py3.4 KB
  • tests/test_commands.py9.2 KB
  • tests/test_live_readonly.py982 B
  • tests/test_runner.py7.3 KB
  • tests/test_security.py2.6 KB
  • tests/test_skill_contract.py2.0 KB
  • tests/test_smoke.py4.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Kaggle Research

Use the official Kaggle CLI through the policy-enforcing wrapper in this skill. The wrapper records bounded, redacted audit data; confines downloads to an approved directory; and blocks remote mutation unless the user explicitly authorizes it.

Required workflow

  1. Confirm the requested Kaggle resource and whether the action is read, download, write, or delete. Do not broaden user authority.

  2. Use an isolated Python 3.11+ environment with kaggle>=2.2,<3.

  3. Configure Kaggle authentication outside commands and source files. Never read, print, echo, log, or commit credential values.

  4. Run the non-mutating prerequisite check:

    python scripts/kaggle_research.py doctor --json
    
  5. Run discovery commands before downloads or mutations. Keep every download under an explicitly chosen output root.

  6. Preserve generated audit JSON and artifact hashes with the research outputs.

  7. Report exact commands, resource references, timestamps, failures, and generated artifacts. Distinguish verified observations from assumptions.

Safe command execution

Pass Kaggle arguments after -- so their order is preserved:

python scripts/kaggle_research.py run --audit artifacts/audit.json -- datasets list -s iris -v
python scripts/kaggle_research.py run --output-root artifacts/kaggle -- datasets download -d owner/dataset

Preview any potentially mutating command first:

python scripts/kaggle_research.py run --dry-run --allow-write -- datasets create -p dataset-package

An actual remote write additionally requires explicit user authorization and --allow-write. A delete additionally requires --allow-delete and --confirm-resource matching the exact resource classified by the wrapper. The runtime never retries writes or deletes.

Real read-only verification

The live smoke workflow calls Kaggle's real service, inspects all supported resource groups, downloads a small public dataset, and verifies its hash:

python scripts/kaggle_research.py smoke-readonly --output-root artifacts/kaggle-smoke --report artifacts/kaggle-smoke-report.json

The corresponding integration test is opt-in so normal unit tests do not depend on network access:

AERS_KAGGLE_LIVE=1 python -m unittest discover -s tests -p "test_live_readonly.py" -v

Only run the live lane when credentials are already available in the process environment. It must remain read/download-only.

Reference routing

Read only the reference page required for the active task.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

a1

FreeSummary

Turn a broad research idea into clear, testable questions. Compare familiar and less conventional approaches, structure the selected question around its population and methods, and assess variables, feasibility, and potential theoretical contributions.

  • Turn a research topic into testable questions
  • Narrow an overly broad research question
  • Compare alternative research angles
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

a2

FreeSummary

Helps build a research framework by comparing theories, mapping relationships between variables, and deriving testable hypotheses. Explores less conventional options, examines weaknesses and competing explanations, and produces diagrams with anticipated reviewer objections.

  • Comparing theories for a research question
  • Deriving hypotheses from relationships between variables
  • Examining weaknesses and anticipated reviewer objections
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

a5

FreeSummary

Clarify the philosophical assumptions behind a research project and check whether they fit the proposed methods. Get a reasoned research stance, draft proposal wording, and guidance for explaining how the researcher's background and values shape the study.

  • Clarifying philosophical foundations for a research proposal
  • Explaining why the chosen research methods fit the study
  • Drafting a statement about the researcher's position
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

academic-paper

FreeSummary

Plan and draft academic papers through specialized agent roles covering literature, arguments, citations, and review. Get chapter guidance, revision roadmaps, Traditional Chinese and English abstracts, and documents formatted as LaTeX, DOCX, PDF, or Markdown.

  • Planning a paper chapter by chapter
  • Drafting a paper from research materials
  • Turning reviewer comments into a revision roadmap
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

Turn a detailed outline into a philosophy or interdisciplinary manuscript. Draft chapters with repeated quality reviews, check terminology and arguments across sections, and prepare the manuscript, evaluation reports, abstract, and metadata for submission.

  • Draft a full paper from a detailed outline
  • Review argument and citation quality chapter by chapter
  • Check terminology and argument flow across chapters
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

Simulate academic peer review through five reviewer roles tailored to the paper's field. Receive separate critiques, an editorial decision, and a prioritized revision roadmap, or check whether a revised manuscript addresses earlier comments.

  • Review a manuscript before journal submission
  • Examine research methods and statistical validity
  • Challenge core arguments and alternative explanations
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

See all skills by brycewang-stanford

Report a problem with this skill