Agent skill · nvidia
complexa-sweep
Agent runbook for Proteina-Complexa parameter sweeps through the separately installed first-party CLI and config generator. Use for cartesian-product hyperparameter scans, sweeper YAML authoring, configuration comparisons, ablations, tuning, success-rate ranking, or Pareto searches over quality and wall-clock cost. Do not use for a single existing-job launch or SLURM submission template. SKILL.md performs the orchestration; bundled executables only inspect local readiness and write a run manifest.
What it needs
About 9k tokens when loaded.
What this skill does
complexa-sweep Run cartesian-product parameter sweeps over Proteina-Complexa design pipelines. Pick or author a sweeper YAML in configs/sweeps/, expand it to N inference configs with scriptutils/generateinferenceconfigs.py, loop complexa design over those configs, then aggregate per-config success metrics into a ranked summary CSV plus a manifest. Important: The complexa design CLI does NOT accept --sweeper directly. Sweeps are driven by scriptutils/generateinferenceconfigs.py, which writes one configs/inferenceconfigs/inf{idx}{runname}.yaml per sweep combination. You then loop complexa design over those generated configs. Instructions Sweeper authoring, Cartesian enumeration, cost estimates, and analysis of supplied CSVs need only the relevant configs and data. Complete those artifacts without setting up inference. Read the relevant axis section in sweepaxes.md, then check the matching keys in the selected source config for current defaults. Summary CSVs with supplied counts and objective columns do not require the full inference or metric guides. For a partial snapshot, enumerate combinations locally and provide the future generator command; running that command requires the full project and its dependencies. For a requested launch, check readiness and the budget below. A single existing job or a SLURM template does not require a parameter sweep. Step 1: Pre-flight Before GPU execution, or when the request conditions its workflow on hardware, set SKILLDIR to the directory containing this manifest and run preflight once. Use a separate shell assignment; an inline environment assignment cannot set $SKILLDIR's expansion in the same command. Reuse an existing probe from the same request if the environment is unchanged: Read ./complexasetup/preflight.json. A sweep multiplies GPU time by the number of configs and targets. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nvidia/bionemo-complexa-sweep