---

name: configuration-ui description: "Guide JSON config editing, smoke configs, CLI override precedence, stage command construction, metrics JSONL inspection, and the Streamlit control panel/job manager." disable-model-invocation: true metadata: disco-role: operating license: MIT

configuration-ui

Use this sub-skill when a future Researcher needs to edit or inspect this repo's JSON stage configs, build safe training/UI command lines, use smoke configs, inspect metrics JSONL, or operate the Streamlit control panel.

Read first

• For config precedence, dataclass fields, smoke/full JSON behavior, and CLI override rules, read references/configuration.md.
• For Streamlit pages, job registry behavior, GPU-busy guarding, logs, and UI metrics, read references/control-panel-ui.md.
• For common config/UI/metrics failures, read references/troubleshooting.md.

Safe bundled helpers

• scripts/print_config_summary.py summarizes one or more JSON config files and compares explicit keys against a base JSON without importing the repo.
• scripts/inspect_metrics_jsonl.py summarizes metrics JSONL columns, last row, numeric ranges, and malformed-line counts without pandas or repo imports.

Both helpers are read-only by default, have --help, and include --demo tiny fixture modes.

Route elsewhere

• Algorithm choices, loss interpretation, RLHF stage sequencing, KL/reward tuning, and training-stage failure analysis: use ../post-training-rlhf/SKILL.md.
• Base architecture, legacy pretraining, DDP/bf16 pretraining, checkpoint structure, and memory planning: use ../model-pretraining/SKILL.md.
• Dataset schemas, packed HDF5 validation, preference JSONL validation, and RL prompt validation: use ../data-preparation/SKILL.md.
• GSM8K evaluation details, direct chat/raw inference, checkpoint loading, and sampling controls: use ../evaluation-chat/SKILL.md.

Operating guardrails

• Prefer configs/smoke/*.json for command/config smoke checks; those use a sibling configs/smoke/base.json and are CPU-oriented.
• Use --print-config before launching long jobs when changing JSON or CLI overrides.
• Treat UI launches as process-spawning operations: check the UI job registry status and the GPU-busy guard before starting GPU jobs.
• Treat Weights & Biases as optional. The repo always writes metrics JSONL under the configured log directory even when W&B is disabled or unavailable.