yolo-tuning
Installation
SKILL.md
Improving models & hyperparameter tuning
The improvement playbook (follow in order — tuning is the LAST step)
Hyperparameter tuning is expensive and usually not the bottleneck. Escalate in this order, re-validating after each step:
- Fix the data — check
confusion_matrix.pngandtrain_batch*.jpgfor label noise; review the top false-negative/false-positive val images; add examples of failing classes and true-background images. Data quality beats every other lever. - Train longer — if val mAP was still rising at the end: more
epochs, higherpatience. - Bigger input — small objects or mAP50 ≫ mAP50-95: raise
imgsz(640 → 960/1280). - Bigger model — underfitting (train and val both mediocre): n → s → m → l.
- Domain-matched augmentation — aerial
degrees=180 flipud=0.5, crowded scenescopy_paste=0.3/mixup=0.1, color-critical classes lowerhsv_h(see yolo-training'straining-args.md). - Only now: hyperparameter tuning — worth ~0.5–2 mAP when everything above is exhausted.