ods
Route ODS repository work for local AI stack installers, GPU/model backends, Docker services and extensions, dashboard API/UI, operator CLI, host tools, and validation lanes.
SKILL.mdskills/repositories/repo-skills/ods/SKILL.md
GitHubODS Repo Skill
Use this skill for tasks involving ODS (Osmantic Deployment System): a local AI server stack with shell/PowerShell installers, GPU-aware model routing, Docker Compose services, extension manifests, a FastAPI/React dashboard, an operator CLI, host helpers, and a large validation surface.
This root file is a router. Read the smallest sub-skill that owns the requested workflow, then use the linked references and bundled helper scripts there.
First checks
- If the task touches a repository checkout, run
scripts/check_ods_repo.py --helpand optionallyscripts/check_ods_repo.py --root <checkout>to see whether the layout still matches this skill's assumptions. - Read
references/repo-provenance.mdbefore deciding whether this skill is stale for a newer ODS commit. - Use
references/architecture-map.mdwhen the task spans multiple ODS areas. - Use
references/troubleshooting.mdfor cross-cutting symptoms, then route to the nearest sub-skill troubleshooting file. - Treat real install, update, service lifecycle, backup/restore, Docker, model download, GPU smoke, and fleet commands as host-mutating unless a sub-skill explicitly marks a check read-only.
Sub-skill routes
| User task | Read this |
|---|---|
| Installers, platform entry points, installer phases, preflight, generated config writers, install/update/uninstall flow, Linux/macOS/Windows install troubleshooting | sub-skills/installers-and-platforms/SKILL.md |
| GPU/backend detection, hardware tiers, model catalogs/profiles, context policy, inference backend overlays, model download/load/swap, model switchboard | sub-skills/hardware-and-models/SKILL.md |
| Service manifests, extension catalog/library, compose fragments and GPU overlays, compose resolver/security scanner, service registry, extension install/update/rollback semantics | sub-skills/services-and-extensions/SKILL.md |
| Dashboard API routes, FastAPI auth/session behavior, dashboard frontend pages/components/hooks, Vite/uvicorn dev workflow, dashboard tests | sub-skills/dashboard-and-api/SKILL.md |
ods CLI, lifecycle/status/logs/config/mode/model commands, backup/restore/update, doctor/support bundle, host-agent, remote-provider, mDNS, memory-shepherd |
sub-skills/ops-cli-and-host-tools/SKILL.md |
| Selecting focused tests, interpreting Make targets and CI, release validation, smoke/simulate/fleet lanes, secret scanning, test troubleshooting | sub-skills/testing-and-release/SKILL.md |
Common workflow routing
Modify an installer or platform path
Read installers-and-platforms first. Cross-check:
hardware-and-modelsif detection, tier, backend, model, context, or compose overlay selection changes.services-and-extensionsif service manifests or compose layers change.ops-cli-and-host-toolsif installedodsbehavior changes after install.testing-and-releaseto choose syntax, contract, preflight, smoke, or simulation lanes.
Add or debug a service extension
Read services-and-extensions first. Cross-check:
dashboard-and-apifor Dashboard extension portal, API endpoints, progress, update, rollback, and UI behavior.ops-cli-and-host-toolsforods enable,ods disable,ods list,ods audit, logs, and lifecycle effects.hardware-and-modelsfor GPU-only or LLM-consuming services.testing-and-releasefor manifest audit, compose resolver, integration, and smoke tests.
Change model or backend behavior
Read hardware-and-models first. Cross-check:
installers-and-platformsfor.envgeneration and platform detection paths.ops-cli-and-host-toolsforods model,ods mode, and runtime route reconciliation.dashboard-and-apifor model pages, model-route probes, and API state.testing-and-releasefor tier-map parity, model-library, overlay, and runtime-tunable tests.
Work on Dashboard API or UI
Read dashboard-and-api first. Cross-check:
services-and-extensionswhen catalog/extension semantics change.hardware-and-modelsfor model, GPU, and route data displayed by the dashboard.ops-cli-and-host-toolsfor host-agent-backed actions, keys, update/model/lifecycle calls, and diagnostics.testing-and-releasefor dashboard pytest/Vitest/build lanes.
Operate or debug an installed ODS instance
Read ops-cli-and-host-tools first for safe command classification and diagnostics. Route symptoms to installer, hardware/model, services/extensions, or dashboard sub-skills as needed. Do not run destructive repair, purge, uninstall, delete-data, backup/restore, or update flows without explicit user intent.
Choose validation for a change
Read testing-and-release first. It maps changed paths to focused lanes and marks expensive or host-mutating checks. Then use the owning sub-skill to understand why that lane matters.
Public prerequisites and install model
ODS is not a single Python library. It is a source/runtime stack built from Bash, PowerShell, Python, React/Vite, Docker Compose, service manifests, and config files. Public operation usually starts from one of these entry paths:
- Linux/macOS shell bootstrap or clone-based
install.sh. - Windows PowerShell bootstrap or source checkout
install.ps1/platform installer. - Installed runtime
odsCLI for status, logs, config, models, mode, extensions, diagnostics, backup/restore, and updates. - Dashboard UI/API for browser-based control.
For repo maintenance, use focused syntax/tests instead of installing the stack unless the task specifically requires an installed-system run.
Bundled references and scripts
references/architecture-map.md— repository map, sub-skill boundaries, cross-skill workflows, and safety policy.references/troubleshooting.md— cross-cutting triage and high-risk operation warnings.references/repo-provenance.md— source commit/version/evidence paths and refresh baseline.references/repo-routing-metadata.json— structured routing metadata for managed imports; retained even though this run was not imported.scripts/check_ods_repo.py— read-only layout checker for current or future ODS checkouts.
Verification baseline
This skill was generated with a private Python inspection environment for dashboard-api import and route inspection plus source/test evidence for the rest of ODS. Required repo-skill verification uses CPU/host-safe checks. Live GPU, Docker service launch, model download, full smoke, fleet, and release gates are optional product validation lanes, not prerequisites for using this skill.