"Claude says it can't access the video" → Make sure "Code Execution and File Creation" is turned on in Settings → Capabilities. The skill needs this to run.

"The transcript is missing or inaccurate" → Some videos don't have captions. The skill falls back to Whisper transcription, which needs a free API key from Groq. Claude will walk you through setting this up if it hits this case. For most YouTube videos, captions exist and this isn't an issue.

"The breakdown is vague on visual details" → Try adding --resolution 1024 to your command. The default frame width is 512px, which is fine for most videos but can miss small text on slides or dashboards.

"Claude says the video is too long" → Videos over 10 minutes get a "sparse scan" warning. The skill still works, but accuracy drops because it's sampling fewer frames per minute. For long videos, use --start and --end to focus on the section you actually care about.