camera-health-check
Check video monitoring camera quality from sampled frames and return health status before downstream event generation. Use when Codex has camera_id and frames and needs to gate or downgrade event conf
SKILL.mdskills/custom/video_surveillance/camera-health-check/SKILL.md
GitHubCamera Health Check
Execution Priority
Prioritize calling this skill's scripts/run.py entrypoint first. Only write custom code after the script result is unsuitable or the script cannot cover the requested task.
Input Resolution
If frames are missing but the user provided a video source, do not ask the user to provide frames and do not write custom camera diagnostics. First call frame-sampling/scripts/run.py to generate frames, then call this skill.
Atomic CLI
Run this skill directly with its own script. The script does not call other skill scripts and does not depend on shared src, tools, or registry modules.
python camera-health-check/scripts/run.py --frames-json <frames.json> --camera-id <camera_id> --config <config.json> --output <health.json>
Parameters: --frames-json, --camera-id, --health-status, --config, --output.
Workflow
- Read camera id and sampled frames.
- Check frame availability and configured/manual health overrides.
- Compute or accept quality signals for black screen, blur, occlusion, freeze, corruption, and view shift.
- Return health status, health score, and issue reasons.
Available Implementation
This skill is implemented as an atomic standalone script in its own scripts/run.py. The script contains the executable logic for this skill and must not import shared src, tools, or registry modules.
Inputs
camera_idframes- Optional
health_statusoverride - Optional
context.config["camera_health"][camera_id]override
Outputs
Returns health_status, health_score, and issues.
Failure Modes
The current implementation returns success with health_status="unavailable" when no frames are available.
Constraints
Do not create events or evidence. Low quality should reduce downstream confidence or trigger review.