Repository navigation
feat(skills,pipeline): add cinematic series tooling, per-project manifest manager, and production skills - #73
Merged
Merged
Conversation
…, and production skills - Add 5 new production skills: fk-scriptwriter, fk-character-bible, fk-action-choreography, fk-cinematic-transitions, fk-sound-design - Add scripts for film mastering (build_master_film), hardsub burning (generate_subtitles), series manifest (series_manifest), and SFX layering (sfx_layering) - Add sync_skills and validate_skills for tool parity across Antigravity IDE and Claude Code - Upgrade fk-concat-fit-narrator with bumper transitions, audio ducking, and hardsubs - Upgrade fk-gen-narrator with Edge-TTS neural voice profiles and pacing controls - Upgrade fk-review-video with automatic prompt healing loop - Fix manifest synchronization in agent/api/projects.py to merge all chapters - Fix polling timeout guard in agent/worker/processor.py - Support Antigravity IDE target in setup.py (.agents/skills) - Clean up git tracking for large scratch dumps and update .gitignore
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This Merge Request enhances FlowKit with a complete Cinematic AI Series Production Suite, designed for creating long-form, multi-episode films (16:9 Landscape & 9:16 Shorts) using Google Flow and Veo 3.
It introduces 5 new cinematic skills, automated tools for compilation and mastering (chapter bumpers, sub-bass drones, hardsubs), an automated per-project Series Manifest manager, and seamless tool sync across Claude Code, Codex CLI, and Antigravity IDE.
Key Changes & Features
1. 🎬 Cinematic AI Film Skills (
skills/)/fk-scriptwriter: Screenplay bible for AI films with 12 scenes/chapter, 3-phase 8s subclip pacing (0-3s,3-6s,6-8s), strict narrator speech math (≤ 7.0s, ~18–22 words), and prompt safety hardening./fk-character-bible: Multi-character consistency framework, role-based aliases, entity code-names, and celebrity/public-figure policy bypass techniques./fk-action-choreography: Cinematic combat choreography, camera tracking dynamics, kinetic motion prompts, and collision framing./fk-cinematic-transitions: Transition design, 0.8s dip-to-black fade curves, chapter bumpers, and inter-scene acoustic bridges./fk-sound-design: Multi-track audio mastering, intelligent background ducking (narration boost+2.9 dB, Veo 3 ambient ducking-12 dB), and low-frequency brown noise drones (40–60 Hz).2. 🛠️ Automation & Mastering Scripts (
scripts/)scripts/series_manifest.py: Per-project series manifest manager (output/<slug>/series_manifest.json) that caches shared character/location UUIDs across episodes to eliminate redundant reference generations.scripts/build_master_film.py: Automated compiler for multi-chapter films, producing cohesive master videos with interstitial chapter bumpers and cinematic audio balance.scripts/generate_subtitles.py: Automated.srt/.vtttimeline alignment and FFmpeg hardsub burner (--burn-subtitles) with 4 aesthetic presets (cinematic_gold,clean_white,cyber_amber,emerald_hud).scripts/sfx_layering.py: Action-keyword Foley audio layering and spatial sound design.scripts/sync_skills.py&scripts/validate_skills.py: Quality assurance linter enforcing 100% English language compliance, YAML frontmatter parity, and cross-IDE synchronization.3. ⚙️ Core Engine & Extension Enhancements
setup.py: Added full support for Antigravity IDE (.agents/skills/), offering an interactive target selector (Claude Code, Codex, Antigravity, or All).agent/api/projects.py: Enhanced/manifestendpoint to automatically sync and merge all episode records from the database.agent/worker/processor.py: Added a safety guard to prevent polling timeouts from erroneously triggering entity re-uploads.agent/services/flow_batch.py: Improved TRPC response parsing window search to avoid false media ID mismatches.extension/background.js: Prioritized active/project/tabs for reCAPTCHA token execution and TRPC batch RPC calls..gitignore: Untracked large local runtime dumps (scratch/captured_netlog.jsonl) and ignored temporary media artifacts.Verification & Testing
python scripts/validate_skills.py— 41/41 skills verified with zero warnings, 100% English compliant.python scripts/sync_skills.py— Parity achieved acrossskills/,.agents/skills/, and.claude/commands/.python scripts/series_manifest.py sync --project-id <PID>successfully registers and links shared entities.Checklist
.gitignore.