---

name: installers-and-platforms description: "Route ODS Linux, macOS, and Windows installer work, phase ordering, platform dry-runs, quickstarts, generated-config writer review, and install troubleshooting." disable-model-invocation: true metadata: disco-role: operating license: Apache 2.0

Installers And Platforms

Use this sub-skill when the task touches ODS installer entry points, platform dispatch, ordered install phases, dry-run behavior, quickstart guidance, or install-time troubleshooting.

First Moves

1. Read references/installer-architecture.md before changing installer structure, phase order, or generated config writers.
2. Read references/platform-workflows.md before advising a Linux, macOS, Windows, WSL, dry-run, update, or uninstall workflow.
3. Read references/troubleshooting.md when diagnosing failed installs, Docker/PowerShell/WSL/macOS issues, port conflicts, phase handoffs, or generated config drift.
4. Use the bundled read-only checker when reviewing layout changes:

python3 sub-skills/installers-and-platforms/scripts/check_installer_layout.py --repo <ODS checkout>

Run it from the generated repo-skill root or pass the path to a source checkout. The script is static and read-only; it does not install packages, start Docker, download models, or edit files.

Route Here For

• install.sh, install.ps1, ods/install.sh, ods/install-core.sh, ods/installers/dispatch.sh, and platform installer entry-point behavior.
• Linux installer libraries in ods/installers/lib/ and ordered phase files in ods/installers/phases/ when the task is about installer orchestration rather than hardware/model internals.
• macOS installer behavior in ods/installers/macos/install-macos.sh, macOS helper libraries, native llama-server launch, and ods-macos.sh install-management workflows.
• Windows installer behavior in ods/installers/windows/install-windows.ps1, Windows installer libraries/phases, install.ps1 wrapper forwarding, and ods.ps1 install-management workflows.
• Host-mutating install review: identify safer dry-run, syntax, contract, or smoke checks before running real installers.
• Cross-platform generated config writer review for .env, SearXNG, OpenCode, Hermes, Perplexica, LiteLLM/Lemonade, and external-LLM route changes.

Route Elsewhere

• Hardware tier thresholds, model catalog selection, GPU backend internals, and compose backend overlays: use ../hardware-and-models/SKILL.md.
• Service manifest schema, extension compose mechanics, extension enable/disable, and compose security scanning: use ../services-and-extensions/SKILL.md.
• Operator CLI command families after install (ods start, ods enable, backups, doctor/support bundle depth): use ../ops-cli-and-host-tools/SKILL.md.
• Validation lane selection, CI/release gates, full smoke/simulate/gate interpretation: use ../testing-and-release/SKILL.md.

Safety Rules

• Treat real installers as host-mutating. They can create runtime directories, generate secrets, install or configure Docker/tooling, download large models/images, change user groups/LaunchAgents/Scheduled Tasks/systemd units, tune AMD Linux hosts, and start services.
• Prefer static checks, --dry-run, syntax checks, and contract tests unless the user explicitly authorizes a real install or lifecycle operation.
• Do not ask a future agent to depend on the original checkout docs or scripts as runtime dependencies. Use these bundled references and scripts; source repo paths named here are evidence and provenance.
• Do not leak local absolute paths, private environment names, temporary API keys, generated secrets, or command logs into user-facing advice.
• When a generated config writer changes, check every platform writer and relevant upgrade/runtime writer before calling the fix complete.

Verification Shortlist

Safe first-pass checks for installer/platform work:

# Static layout check supplied by this skill.
python3 sub-skills/installers-and-platforms/scripts/check_installer_layout.py --repo <ODS checkout>

# Native source-check candidates from ODS when available and appropriate.
cd <ODS checkout>/ods
bash -n install.sh install-core.sh installers/dispatch.sh installers/common.sh installers/phases/*.sh installers/lib/*.sh
bash tests/contracts/test-installer-contracts.sh
bash tests/contracts/test-preflight-fixtures.sh
bash tests/smoke/linux-nvidia.sh
bash tests/smoke/linux-amd.sh
bash tests/smoke/macos-dispatch.sh
bash tests/smoke/wsl-logic.sh

Only run platform-specific PowerShell, Docker, full smoke, or real installer commands after confirming host impact and user intent.