running-hyperparameter-sweep

Design hyperparameter sweeps with search-space design, sampler selection, and compute budgeting.

2|Updated May 23, 2026
One-click install
npx skills add https://github.com/rocklambros/rcs --skill running-hyperparameter-sweep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: running-hyperparameter-sweep
Source: https://github.com/rocklambros/rcs/tree/main/skills/ml-datasci/running-hyperparameter-sweep
Command: npx skills add https://github.com/rocklambros/rcs --skill running-hyperparameter-sweep

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill turns ad hoc model tuning into a disciplined hyperparameter sweep, helping you improve performance without accidentally optimizing on the test set or trusting a single noisy run.

Core Features & Use Cases

  • Search-space design: Chooses appropriate distributions for learning rate, weight decay, batch size, optimizer, and related knobs.
  • Sampler and pruner selection: Recommends practical Optuna or Ray Tune strategies such as TPE, random, ASHA, median pruning, or Hyperband based on compute and dimensionality.
  • Compute budgeting: Splits time between the sweep and the final retrain so the best candidate is validated with multiple fresh seeds before winner selection.
  • Safety guardrails: Enforces a training-versus-validation-versus-test firewall, flags boundary solutions, and warns when the sweep is too small or the landscape is flat.
  • Use case: Ideal for expensive deep learning runs where defaults are weak, manual tuning has stalled, or you need a repeatable process for comparing top configurations.

Quick Start

Use this skill to plan a safe hyperparameter sweep for my model and tell me the search space, sampler, pruner, budget split, and retraining protocol.

Frequently Asked Questions about running-hyperparameter-sweep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a hyperparameter sweep without leaking test data?

To prevent leaking test data during a hyperparameter sweep, you must enforce a strict training-versus-validation-versus-test firewall and lock the test set before final reporting. This ensures evaluation data remains untouched during tuning.

When should I use ASHA versus median pruning for hyperparameter tuning?

You should choose ASHA or median pruning for hyperparameter tuning based on your compute budget and dimensionality. The Skill recommends practical Optuna or Ray Tune pruners like Hyperband to efficiently allocate resources across expensive training runs.

How do I set up a search space for learning rate and weight decay in PyTorch?

To set up a search space for learning rate and weight decay in PyTorch, use logarithmic distributions for these multiplicative parameters. The Skill helps choose appropriate distributions for batch size and optimizer knobs to ensure effective sampling.

Can I use Ray Tune and Optuna for expensive deep learning model training?

Yes, you can use Ray Tune and Optuna for expensive deep learning model training. The Skill applies sampler and pruner selection strategies specifically designed for non-trivial PyTorch classifiers where manual tuning has stalled and defaults are weak.

Why does my hyperparameter sweep return a flat landscape or boundary solution?

A hyperparameter sweep returns a flat landscape or boundary solution when the search space is poorly configured or too small. The Skill flags boundary solutions and warns when the sweep lacks sufficient exploration to find optimal configurations.

What is the best way to validate the top configuration after a hyperparameter search?

The best way to validate a top configuration after a hyperparameter search is seed-stratified retraining. The Skill splits your compute budget so the winning candidate is retrained with multiple fresh seeds before final winner selection.