Meta Muse Video Analysis

Analyze one local video with scripts/analyze_video.py. Keep the model fixed; never add or substitute a model selector.

Workflow

1. Resolve the user's video to an absolute local path.
2. Preserve the user's analysis prompt verbatim unless they ask for prompt improvement.
3. Confirm that META_MUSE_KEY exists without printing its value.
4. Run:

python "<skill-directory>\scripts\analyze_video.py" "C:\absolute\path\video.mp4" --prompt "Describe the requested analysis"

For long or multiline prompts, write the prompt to a temporary UTF-8 text file and use --prompt-file. Use --output when the user requests a saved result:

python "<skill-directory>\scripts\analyze_video.py" "C:\absolute\path\video.mp4" --prompt-file "C:\absolute\path\prompt.txt" --output "C:\absolute\path\analysis.md"

5. Return the analysis or link the saved output. Surface API errors exactly enough to diagnose access, quota, format, or region issues, but never expose the API key.

Operational rules

• Read the API key only from META_MUSE_KEY.
• Use only muse-spark-1.2-contributor through https://api.meta.ai/v1.
• In Codex, run the script with network approval. The key may be visible only in the approved outside-sandbox process; never copy it into command arguments or output.
• Check the model catalog before upload. If Contributor access is absent, stop without uploading and never fall back to standard muse-spark-1.2.
• Upload the video through the Files API and attach it to a Responses API request.
• Delete the remote file after the response, including after failures. Use --keep-upload only when the user explicitly asks to retain it.
• Do not silently preprocess, transcode, shorten, or split the video. If Meta rejects its format or size, report that limitation and ask before transforming the source.
• Treat Contributor uploads as externally shared data. Warn before sending secrets, private customer material, unreleased footage, or other sensitive content unless the user has already confirmed that the Contributor data terms are acceptable.
• Do not print, log, persist, or copy the API key.

CLI reference

analyze_video.py VIDEO (--prompt TEXT | --prompt-file FILE)
                 [--output FILE] [--json] [--keep-upload]
                 [--timeout SECONDS]

If neither prompt option is supplied, the script reads redirected stdin or asks interactively. --json emits a machine-readable result envelope. Progress and warnings go to stderr; the analysis goes to stdout.