| name | source-media-analyze |
| description | Probe source media locally with ffprobe/ffmpeg and produce duration, orientation, stream, scene-change, silence, and audio-energy metadata. |
| allowedTools | ["shell","read","write"] |
| model | inherit |
| argumentHint | {"mediaPath":"input/source.mp4","outputPath":"output/content-machine/highlights/source-media-analysis.v1.json"} |
| entrypoint | node --import tsx scripts/harness/source-media-analyze.ts |
| inputs | [{"name":"mediaPath","description":"Source video or audio file to inspect.","required":true},{"name":"outputPath","description":"Path that will receive source-media-analysis.v1.json.","required":false},{"name":"ffmpegPath","description":"Optional explicit ffmpeg executable path for measured scene/audio signals.","required":false},{"name":"ffprobePath","description":"Optional explicit ffprobe executable path.","required":false}] |
| outputs | [{"name":"source-media-analysis.v1.json","description":"Local media probe metadata and measured signals for later highlight scoring."}] |
Source Media Analyze
Use When
- A longform source file needs local metadata before selecting,
clipping, or reframing highlights.
- You need duration, dimensions, orientation, fps, and stream presence
without uploading the media anywhere.
- Highlight scoring should incorporate source-level audio energy,
silence, or scene-change signals.
Invocation
cat skills/source-media-analyze/examples/request.json | \
node --import tsx scripts/harness/source-media-analyze.ts
Output Contract
- Reads the local source media file.
- Writes
source-media-analysis.v1.json.
- Uses local
ffprobe/ffmpeg or bundled static binaries when
available.
- Measures scene-change timestamps, silence gaps, audio RMS/peak, and
compact normalized source scores on a best-effort basis.
- Keep the v1 artifact stable for
longform-highlight-select. Reusable
media facts and gates are migrating to @45ck/video-evaluator, but
this skill remains the content-machine compatibility surface until
evaluator source-media signal parity lands.
- If
@45ck/video-evaluator artifacts are available, treat them as
upstream analyzer evidence; do not delete or rename
source-media-analysis.v1.json until the adapter preserves this
contract.
Validation Checklist
hasVideo, hasAudio, dimensions, duration, fps, and orientation
are present when ffprobe can read them.- Missing streams are warnings, not silent defaults.
- Missing ffmpeg measurement support is a warning; ffprobe metadata
should still be written when possible.
- No network calls are made.
