dev-machine-setup
Dev Machine Setup
Bring any machine to a clean, ready-to-develop state: a factory laptop, a half-configured work box, or a daily driver that has drifted. Phase 1 builds a gap report of what is missing and misconfigured, and every later phase acts only on that report.
Gap-driven is the whole design. Each phase self-skips when its slice of the report is empty, so a re-run on an already-good machine installs nothing and still verifies: idempotent by construction.
Self-contained: no external scripts repo is cloned. The shell config the skill deploys ships in assets/.
This SKILL.md is the spine; per-OS command tables and per-phase detail live in references/, so only the
current platform loads and the token budget stays on the machine in front of you.
Modes
Mode comes from the user's intent, not from machine state. A machine with gaps is not permission to fill them when the user only asked for a tune-up.