How kalebe-silva/claude-assistir works
assistir is a local video-to-briefing tool exposed as a Claude Code plugin and command-line shortcut. Its main workflow accepts a URL or local file, obtains video and captions when available, extracts distinct frames, uses captions or local Whisper transcription for speech, then writes a Markdown timeline and metadata. The script excerpt shows the processing stages and their calls; the README documents plugin and shortcut entry points. Unsampled source limits certainty about some dispatch details, so those links are omitted.
Main entry points: assistir.py Workflow runner · assistir CLI shortcut · SKILL.md Assistir skill
Components 16
User entry points
- Claude Code
- Assistir skill
plugin/skills/assistir/SKILL.md - CLI shortcut
bin/assistir
Video processing
- Workflow runner
plugin/skills/assistir/assistir.py - Video source
- URL download
plugin/skills/assistir/assistir.py - yt-dlp
- FFmpeg
- Distinct frames
plugin/skills/assistir/assistir.py
Speech and captions
- Caption parsing
plugin/skills/assistir/assistir.py - Local transcription
plugin/skills/assistir/assistir.py - faster-whisper
Generated results
- Timeline assembly
plugin/skills/assistir/assistir.py - Briefing files
- Video metadata
plugin/skills/assistir/assistir.py
Other components
- User
Connections 18
- User → Claude Code: requests analysis
README.md - Claude Code → Assistir skill: invokes skill
README.md - User → CLI shortcut: runs command
README.md - CLI shortcut → Workflow runner: launches
README.md - User → Workflow runner: provides input
plugin/skills/assistir/assistir.py - Workflow runner → URL download: downloads URL
plugin/skills/assistir/assistir.py - URL download → yt-dlp: uses
plugin/skills/assistir/assistir.py - Workflow runner → Video source: uses local or fetched video
README.md - Workflow runner → Distinct frames: extracts
plugin/skills/assistir/assistir.py - Distinct frames → FFmpeg: decodes frames
plugin/skills/assistir/assistir.py - Workflow runner → Caption parsing: parses available captions
plugin/skills/assistir/assistir.py - Workflow runner → Local transcription: transcribes without captions
plugin/skills/assistir/assistir.py - Local transcription → FFmpeg: extracts audio
plugin/skills/assistir/assistir.py - Local transcription → faster-whisper: transcribes locally
plugin/skills/assistir/assistir.py - Workflow runner → Timeline assembly: assembles results
plugin/skills/assistir/assistir.py - Timeline assembly → Briefing files: writes roteiro.md
plugin/skills/assistir/assistir.py - Workflow runner → Video metadata: writes metadata
plugin/skills/assistir/assistir.py - Video metadata → Briefing files: saves meta.json
plugin/skills/assistir/assistir.py