| name | sparkstation-config-lint |
| description | Validate models.yaml profiles for correctness, consistency, and resource feasibility. Checks memory limits, alias collisions, required args, backend compatibility. Use when asked to "lint config", "validate models.yaml", "check config", or before deploying a new profile. |
Sparkstation Config Lint
Validates models.yaml for correctness before deployment.
Usage
python3 .pi/skills/sparkstation-config-lint/scripts/lint.py
python3 .pi/skills/sparkstation-config-lint/scripts/lint.py --profile image-indexing
python3 .pi/skills/sparkstation-config-lint/scripts/lint.py --json
What It Checks
- Memory feasibility: Total memory per profile fits within MEMORY_HARD_LIMIT_GB
- Alias collisions: No duplicate aliases within a profile
- Required fields: Each model has backend, name at minimum
- Backend compatibility: Extra args match the backend type (e.g., tool_call_parser only for chat models)
- Cross-profile consistency: Same model alias doesn't have conflicting backends across profiles
- Port range: Model count doesn't exceed available port range
- Docker images: Validates docker_image references exist for models that need them
- Memory declarations: Warns on missing memory_gb for non-trivial models