media-analyze

name	media-analyze
description	Analyze a Craft media block with OpenAI-backed generic media analysis and write results under the source block.

media-analyze

Use through the curated CLI alias:

craft media analyze <blockId>
craft media analyze <blockId> --estimate
craft media analyze <blockId> --max-cost 0.50 --json

Direct skill form:

craft skills run media-analyze analyze <blockId>

V1 behavior:

• Generic media analysis only.
• OpenAI is the only provider.
• Default cost cap is EUR 1; manifest estimate is EUR 0.25.
• craft-cli fetches Craft block context and performs Craft writes.
• The skill downloads media to ~/.cache/craft-cli/media-analyze.
• Video runs use ffprobe for metadata and ffmpeg for audio/contact-sheet artifacts when available.
• Raw intermediate files stay local; the Craft run block stores analysis, transcript text, contact-sheet path, and metadata JSON.

Requirements:

• OPENAI_API_KEY for live analysis/transcription.
• ffmpeg and ffprobe for video/audio extraction.

Failure posture:

• Missing media URL: failed result, no expensive work.
• Missing OpenAI key: failed result before OpenAI calls.
• Missing ffmpeg/ffprobe: partial result with a clear artifact note when metadata or extraction cannot run.