Deep Learning ↔ SkillOpt Analogy

July 14, 2026 · View on GitHub

SkillOpt is designed around a core insight: optimizing natural-language prompts follows the same structure as training neural networks. This page maps every DL concept to its SkillOpt counterpart.

Complete Mapping

Deep LearningSkillOptDescription
Model weightsSkill document (Markdown)The thing being optimized
Forward passRolloutTarget executes tasks using current skill
Loss functionTask evaluatorScores task execution quality
BackpropagationReflectOptimizer analyzes failures → edit patches
GradientsEdit patchesProposed changes to the skill
Gradient aggregationPatch aggregationMerge similar edits
Gradient clippingEdit selectionCap max edits per step
Learning ratelearning_rateMax number of edits applied per step
LR schedulerlr_schedulerEdit-budget schedule: cosine, linear, constant, or autonomous
SGD stepSkill updateApply selected patches to document
Validation setSelection splitGate checks improvement before accepting
Training stepStepOne rollout → reflect → update cycle
EpochEpochFull pass with slow update + meta memory
MomentumSlow updateLongitudinal comparison at epoch boundary
Meta-learningMeta skillCross-epoch optimizer strategy memory
Batch sizebatch_sizeTasks sampled per rollout
Data parallelismanalyst_workersParallel reflection workers
Training setTrain splitItems used for rollout
Test setTest splitHeld-out final evaluation
Warm-up(implicit)High LR early steps explore broadly
CheckpointingSkill snapshotsSaved after each accepted step
Transfer learningSeed skill / cross-benchmark initStart from pre-trained skill

Why This Analogy Matters

  1. Familiar mental model: ML practitioners immediately understand how to tune SkillOpt
  2. Principled hyperparameter search: Grid search over learning_rate × lr_scheduler works just like in DL
  3. Reusable mechanisms: Gating provides validation-based model selection, while slow update plays a momentum-like role across epochs

The gate is a per-candidate accept/reject decision. SkillOpt does not implement a gate-patience counter or stop training after a run of rejected candidates.

Hyperparameter Transfer Rules

From our experiments, these DL intuitions transfer well:

!!! success "What transfers" - Cosine schedule > constant — same as in DL, cosine annealing helps convergence - Moderate LR (4-16) > very high/low — too few edits = slow learning, too many = noisy - Slow update helps — longitudinal comparison prevents catastrophic forgetting across epochs - Meta skill memory improves reflection — optimizer benefits from cross-epoch strategy notes

!!! warning "What doesn't transfer" - Batch size ≠ better — larger rollout batches have diminishing returns due to API costs - More epochs ≠ better — skills converge faster than neural networks (2-4 epochs usually enough)