config-validator
Validate wavecapsdr.yaml configuration files for syntax errors, schema violations, and logical inconsistencies. Use when editing config, troubleshooting startup failures, or verifying recipe/preset definitions before deployment.
When & Why to Use This Skill
This Claude skill provides a specialized validation engine for WaveCap-SDR configuration files (wavecapsdr.yaml). It automates the detection of YAML syntax errors, schema violations, and complex logical inconsistencies, ensuring stable server performance and preventing deployment failures by verifying hardware-specific parameters like sample rates and frequency ranges.
Use Cases
- Pre-deployment Verification: Validate wavecapsdr.yaml for syntax and schema integrity before server launch to prevent initialization errors and minimize downtime.
- Manual Configuration Editing: Assist developers in manually editing configuration files by identifying out-of-range values, incorrect indentation, or missing required fields in real-time.
- Troubleshooting Startup Failures: Quickly diagnose 'invalid config' errors by pinpointing specific logical conflicts, such as center frequencies that exceed device capabilities.
- Recipe and Preset Management: Verify the consistency of new recipes and presets to ensure that duplicate names or invalid channel offsets do not cause system instability.
- Environment Migration: Ensure configuration files remain valid and logically sound when migrating settings between different hardware environments or SDR drivers.
| name | config-validator |
|---|---|
| description | Validate wavecapsdr.yaml configuration files for syntax errors, schema violations, and logical inconsistencies. Use when editing config, troubleshooting startup failures, or verifying recipe/preset definitions before deployment. |
Config Validator for WaveCap-SDR
This skill validates backend/config/wavecapsdr.yaml for errors and provides helpful suggestions.
When to Use This Skill
Use this skill when:
- Server fails to start with config errors
- Editing wavecapsdr.yaml manually
- Adding new presets or recipes
- Migrating config between environments
- Troubleshooting "invalid config" errors
Usage
Validate the default config:
PYTHONPATH=backend backend/.venv/bin/python .claude/skills/config-validator/validate_config.py
Validate a specific config file:
PYTHONPATH=backend backend/.venv/bin/python .claude/skills/config-validator/validate_config.py \
--config /path/to/wavecapsdr.yaml
Common Validation Errors
YAML Syntax Errors
- Missing colons
- Incorrect indentation (use spaces, not tabs)
- Unquoted special characters
Schema Violations
- Missing required fields (server.port, device.driver)
- Invalid types (string for integer field)
- Out-of-range values (negative sample rate)
Logical Errors
- Center frequency outside device range
- Sample rate not supported by device
- Channel offset beyond sample rate
- Duplicate recipe/preset names
Files in This Skill
SKILL.md: This filevalidate_config.py: Config validation script