Prediction

---
name: prediction
description: "Routes UltralyticsPro prediction workflows for YOLO image
  inference presets and their shared sample-image defaults."
disable-model-invocation: true
metadata:
  disco-role: operating
license: NO_LICENSE
---

# Prediction

Use this sub-skill when the user wants to run or adapt one of the repository's
single-image prediction wrappers.

## Typical triggers

- "predict on Zidane"
- "run the YOLOv11 inference example"
- "switch the model weight or confidence threshold"
- "why did the prediction script try to download a weight file?"
- "how do I save the output image?"

## What belongs here

- The prediction wrappers that mirror `predict_v8.py`, `predict_yolo11.py`, and
  `predict_yolov10.py`.
- Model weight selection, input source selection, image size, confidence,
  saving, and output naming for those examples.
- Dry-run planning before a real inference run.
- Troubleshooting for first-run weight downloads, missing source images, output
  paths, and device selection.

## What stays out

- Training, finetuning, or resume workflows. Use `sub-skills/training` instead.
- Upstream library source changes.
- Export, tracking, benchmark, or video-streaming workflows that the repository
  does not wrap directly.

## First reads

1. `references/workflows.md` for the preset-to-script map and the canonical
   command forms.
2. `references/troubleshooting.md` for weight, source, save-path, and device
   failures.
3. `../../references/interface-reference.md` when you need verified Ultralytics
   API or CLI details.
4. `../../references/model-family-map.md` when you need the broader source
   script inventory.

## Bundled helper

- `scripts/run_predict.py` — preferred wrapper for all prediction presets. It is
  safe by default and performs a dry run unless `--execute` is supplied.

## How to use the helper

- Start with `--list-presets` when you are mapping a source script to the
  bundled preset.
- Use `--preset predict-yolo11` or another preset when you want the same model
  and sample image pair as a source example.
- Override `--model`, `--source`, `--imgsz`, `--conf`, `--save`, `--device`,
  `--project`, or `--name` when a user asks for a variation.
- Pass `--execute` only after confirming that the model weights and source are
  available and that the user is willing to start a real inference run.

## Common decisions

- The default source is the packaged `ultralytics/assets/zidane.jpg` sample,
  which is shipped with the verified public Ultralytics install.
- If the model weight name ends in `.pt`, the first execution may download the
  pretrained weights when they are not already cached.
- If the user only needs to inspect the parameters, stay in dry-run mode and
  read the printed plan instead of launching inference.

## When to escalate to the root skill

Go back to `SKILL.md` if the task turns into general package inspection,
installation, or route selection across training and prediction.