evidence-snapshot
Generate snapshot evidence for video monitoring event candidates. Use when Codex has an event, event_id, evidence_frame_ids, image_uri, or frame list and needs a snapshot URI, SHA-256 integrity hash,
SKILL.mdskills/custom/video_surveillance/evidence-snapshot/SKILL.md
GitHubEvidence Snapshot
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 event or frames are missing but the user provided a video or event analysis request, do not ask the user to provide evidence frames and do not write custom snapshot code. First call upstream skills to produce frames and events: frame-sampling/scripts/run.py, object-detection/scripts/run.py, object-tracking/scripts/run.py, roi-mapping/scripts/run.py, and event-rule-engine/scripts/run.py as needed. Then call this skill using the event's evidence_frame_ids and available frames.
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 evidence-snapshot/scripts/run.py --event-json <event.json> --frames-json <frames.json> --config <config.json> --output <evidence.json>
Parameters: --event-json, --frames-json, --output-dir, --sensitive-regions-json, --config, --output.
Workflow
- Select the most relevant evidence frame from the event or input frames.
- Copy the source frame into evidence storage.
- Call privacy masking when enabled.
- Compute SHA-256 integrity hash.
- Return Evidence schema.
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
eventor top-level event fieldsframes- Required event field:
event_id - Useful event fields:
evidence_frame_ids,image_uri
Outputs
Returns evidence_id, event_id, type=snapshot, uri, hash, created_at, and privacy_masked.
Failure Modes
MISSING_EVENT_ID- Propagates
privacy-maskingfailures only when caller explicitly checks that nested result.
Constraints
Do not change event confidence or decide review routing.