How nnaligala/ai_videos works
This repository is an Agent Skill that guides a coding agent through evidence-gated production of an AI presenter video. The workflow starts with job setup and input approvals, then moves through script/narration, presenter generation, editing, rendering, and verification. Python scripts provide job initialization, input checks, pause-aware segment planning, and artifact-based state tracking; detailed creative and provider steps are documented in the skill and reference guides. Those guides and the finalization script were not sampled, so their internal calls are not inferred.
Main entry points: SKILL.md Skill workflow · init_job.py Job initialization · preflight.py Input preflight · finalize_delivery.sh Video rendering
Components 17
Job and controls
- Job initialization
scripts/init_job.py - Job manifest
assets/job.template.json - Input preflight
scripts/preflight.py - Evidence state checker
scripts/check_state.py - Job artifacts
Video production
- Skill workflow
SKILL.md - Script and narration
references/generation.md - Pause-aware segments
scripts/plan_segments.py - Presenter generation
references/generation.md - Audio-locked editing
references/editing.md
Quality and delivery
- Composition review
references/editing.md - Video rendering
scripts/finalize_delivery.sh - Recovery and QA
references/qa-recovery.md - Verified video package
Other components
- Coding agent
- FFmpeg tools
- Generation providers
Connections 20
- Coding agent → Skill workflow: invokes
README.md - Skill workflow → Job initialization: runs
README.md - Job initialization → Job manifest: loads template
scripts/init_job.py - Job initialization → Job artifacts: creates job
scripts/init_job.py - Skill workflow → Input preflight: runs
README.md - Input preflight → FFmpeg tools: probes media
scripts/preflight.py - Input preflight → Job artifacts: writes report
scripts/preflight.py - Skill workflow → Script and narration: guides
README.md - Script and narration → Job artifacts: records artifacts
README.md - Skill workflow → Pause-aware segments: plans cuts
README.md - Skill workflow → Presenter generation: guides
README.md - Presenter generation → Generation providers: selects capability
README.md - Skill workflow → Audio-locked editing: guides
README.md - Audio-locked editing → Composition review: previews
README.md - Skill workflow → Video rendering: runs
README.md - Video rendering → FFmpeg tools: encodes and checks
README.md - Video rendering → Verified video package: publishes
README.md - Skill workflow → Recovery and QA: guides
README.md - Skill workflow → Evidence state checker: runs checker
README.md - Evidence state checker → Job artifacts: checks evidence
scripts/check_state.py