agentleFS
mxslrmxslr/mlcraft/skills/notebook-delivery/SKILL.md

notebook-delivery

Skill8 starsChanged 4 months agoMITView on GitHub

Use when producing a runnable deliverable for an ML task, to decide the target environment and author the notebook or script. Detects whether the user wants a Kaggle notebook, a Google Colab notebook, or a local GPU run, and adapts paths, data loading, and compute settings accordingly. Also enforces the writing style for generated notebooks: short and simple explanations, professional research tone, no em-dash, no emoji. Triggers on 'make a notebook', 'kaggle', 'google colab', 'run on my local gpu', 'run in vscode', 'ipynb', 'give me the code to run'.

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 7 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before writing a deliverable, decide WHERE it will run, then adapt to it.

    line 8
  2. Distinctive:

    Keep explanations short and simple.

    line 26
  3. Distinctive:

    Write in a professional research tone, like a methods section: state what and why, not chit-chat.

    line 27
  4. Distinctive:

    Do not use em-dash characters.

    line 28
  5. Distinctive:

    Do not use emoji anywhere in the notebook, comments, or markdown.

    line 29
  6. Distinctive:

    Prefer plain, precise wording.

    line 30
  7. Distinctive:

    Every claim about a result must come from an actual run, not an assumption.

    line 31

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Notebook and Environment Delivery

Before writing a deliverable, decide WHERE it will run, then adapt to it. If the user has not said, ask which of the three targets they want.

Detect the target environment

TargetSignal from userWhat to adapt
Kaggle"kaggle", "commit", "save version", dataset already on KagglePaths under /kaggle/input and /kaggle/working; note the weekly GPU quota and 12h commit limit; use Save and Run All (Commit) for long runs; preprocess once and reuse.
Google Colab"colab", "google colab", DriveMount Google Drive; read data and write checkpoints to Drive so a disconnect does not lose progress; note free-tier idle timeouts.
Local GPU (VSCode)"local gpu", "my laptop", "vscode", "run offline"Require an NVIDIA CUDA GPU; size resolution and batch to the local VRAM (usually far less than 16 GB); read data from a local folder path the user sets.

Make the notebook portable when possible: auto-detect the environment and set the working directory and data path from it, so the same file runs in more than one place.

Environment-specific cautions to state plainly

  • Kaggle: quota is total hours per week and resets weekly. A run must fit the budget; measure seconds per epoch on a quick test first. Do not run long jobs in an interactive session that dies when the tab closes; use a Commit.
  • Colab: free GPU disconnects on idle; always checkpoint to Drive and support resume.
  • Local: CPU-only cannot train these models in reasonable time. If no CUDA GPU, say so and recommend Kaggle or Colab.

Writing style for generated notebooks (required)

  • Keep explanations short and simple. One or two sentences per markdown cell is usually enough.
  • Write in a professional research tone, like a methods section: state what and why, not chit-chat.
  • Do not use em-dash characters. Use a normal hyphen, a comma, or a new sentence instead.
  • Do not use emoji anywhere in the notebook, comments, or markdown.
  • Prefer plain, precise wording. Avoid exclamation marks and filler.
  • Every claim about a result must come from an actual run, not an assumption.

Structure of a professional notebook

Config and imports, data preparation with the split and leakage checks, preprocessing, model definitions, training, evaluation with the right metrics and thresholds, visualizations, and a short results summary. Keep cells focused and reproducible with a fixed seed.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.