موشن ویڈیو پروڈکشن Claude Code اسکل کے ذریعے مختصر موشن ویڈیوز بنائیں اور جانچیں

موشن ویڈیو پروڈکشن کیا ہے؟

موشن ویڈیو پروڈکشن ایک Claude Code اسکل ہے جو ابتدائی منصوبہ بندی سے آخری اسمبلی تک 30–90 سیکنڈ کی موشن گرافکس اور ویڈیوز بنانے کی رہنمائی فراہم کرتا ہے۔ ویڈیو جنریشن کو ایک ہی پرامپٹ سمجھنے کے بجائے، یہ پروڈکشن کو چھ مراحل میں تقسیم کرتا ہے اور کام آگے بڑھانے سے پہلے ہر مرحلے کے آؤٹ پٹ کی توثیق کرتا ہے۔

ریپوزٹری میں harness/gate.py پر ایک گیٹ اسکرپٹ موجود ہے۔ ہر گیٹ متعلقہ آرٹیفیکٹس کی پیمائش کرتا ہے اور ایک ایگزٹ کوڈ واپس کرتا ہے: 0 کا مطلب ہے کہ مرحلہ کامیاب ہو گیا، جبکہ 1 کا مطلب ہے کہ نتیجہ روک دیا گیا ہے اور اسے درست کرنا ضروری ہے۔ یہ پروجیکٹ references/gotchas.md میں پروڈکشن کے دوران پیش آنے والے 29 مسائل بھی درج کرتا ہے۔

اہم خصوصیات

• چھ مراحل پر مشتمل پروڈکشن ورک فلو: کہانی کی منصوبہ بندی، کردار کا ڈیزائن، کی فریمز، ویڈیو کلپس، آڈیو، اور آخری اسمبلی۔
• قابلِ پیمائش معیار کے گیٹس: اسکرپٹس فائلوں، ٹائمنگ، فریم کاؤنٹس، پہلو کے تناسب، آڈیو خصوصیات، اور مرحلے سے متعلق دیگر تقاضوں کی جانچ کرتے ہیں۔
• انسانی جائزے کے مراحل: ایسے بصری مسائل جن کا قابلِ اعتماد اندازہ عددی پیمانے سے نہیں لگایا جا سکتا، ان کا کسی شخص کے ذریعے جائزہ اور دستاویز بندی ضروری ہے۔
• کردار کی یکسانیت کے لیے رہنمائی: سات معیارات منظر کی حدود کے پار ظاہری شکل، آواز، ہونٹوں کی ہم زمانی، موسیقی کی ٹائمنگ، اور مجموعی معیار برقرار رکھنے میں مدد دیتے ہیں۔
• فریم اسٹرپ جنریشن: کلپس گیٹ ایسے تصویری اسٹرپس بناتا ہے جو ابتدائی فریم کے بعد ہونے والی کردار کی تبدیلیاں ظاہر کرتے ہیں۔
• معلوم مسائل کا حوالہ: 29 gotchas میں علامات، وجوہات، احتیاطی اقدامات، اور متعلقہ ہارنس چیک آئی ڈیز بیان کی گئی ہیں۔
• قابلِ استعمال ٹیمپلیٹس اور اسکرپٹس: ریپوزٹری میں ڈپلیکیٹ کی تلاش، بیٹ گرڈز، کلپ شیٹس، آڈیو مکسنگ، muxing، اور توثیق کے لیے منصوبہ بندی کے ٹیمپلیٹس اور یوٹیلیٹیز شامل ہیں۔

ضروریات

آپ کو Claude Code، Python 3، ffmpeg، اور ffprobe درکار ہیں

Remotion کمپوزیشن کا کوڈ اس ریپوزٹری میں شامل نہیں ہے۔ Remotion الگ سے انسٹال کریں اور اپنے پروجیکٹ کے لیے مطلوبہ کمپوزیشن بنائیں۔

پروجیکٹ میں بیان کردہ اختیاری جنریشن ٹولز میں تصاویر اور ویڈیو کے لیے ChatGPT یا Grok Imagine، موسیقی کے لیے Suno، آوازوں کے لیے ElevenLabs یا Fish Audio، اور ٹرانسکرپشن پر مبنی جائزے کے لیے Whisper شامل ہیں۔ README میں بتایا گیا ہے کہ verify.sh میں Whisper کا انضمام غیرمصدقہ ہے۔

Claude Code اسکل انسٹال کریں

Claude Code اسکلز کو ~/.claude/skills/<skill-name>/SKILL.md میں تلاش کرتا ہے۔ ریپوزٹری کلون کریں، skills ڈائریکٹری بنائیں، اور مکمل اسکل فولڈر اس میں کاپی کریں:

git clone https://github.com/unclejobs-ai/motion-video-skill.git
mkdir -p ~/.claude/skills
cp -r motion-video-skill/skills/motion-video-production ~/.claude/skills/

پورا motion-video-production ڈائریکٹری کاپی کرنا ضروری ہے کیونکہ اس کا ہارنس، حوالہ جات، اسکرپٹس، اور ٹیمپلیٹس ایک ساتھ کام کرتے ہیں۔

صرف ایک پروجیکٹ کے لیے انسٹال کریں

اگر اسکل صرف کسی مخصوص پروجیکٹ کے اندر دستیاب ہونی چاہیے، تو اسی فولڈر کو عالمی ڈائریکٹری کے بجائے اس پروجیکٹ کی .claude/skills/ ڈائریکٹری میں کاپی کریں۔

mkdir -p your-video-project/.claude/skills
cp -r motion-video-skill/skills/motion-video-production \
  your-video-project/.claude/skills/

اسکل کاپی کرنے کے بعد Claude Code دوبارہ شروع کریں تاکہ وہ نئی SKILL.md دریافت کر سکے۔

ہارنس کی توثیق کریں

کلون کی گئی ریپوزٹری سے ہارنس کا سیلف ٹیسٹ چلائیں:

bash skills/motion-video-production/harness/selftest.sh

0 کا ایگزٹ کوڈ اس بات کی تصدیق کرتا ہے کہ گیٹ ہارنس موجودہ کمپیوٹر پر کام کرتا ہے۔ اگر ٹیسٹ ناکام ہو جائے، تو پہلے تصدیق کریں کہ Python 3، ffmpeg، اور ffprobe انسٹال ہیں اور آپ کے کمانڈ پاتھ پر دستیاب ہیں۔

ویڈیو پروجیکٹ شروع کریں

Claude Code کھولیں اور اس ویڈیو کی وضاحت کریں جسے آپ بنانا چاہتے ہیں۔ مثال کے طور پر:

میں ایک کردار پر مشتمل 30 سیکنڈ کی افتتاحی ویڈیو بنانا چاہتا ہوں۔

پروڈکشن شروع ہونے سے پہلے Claude چار پابندیوں کے بارے میں پوچھتا ہے:

1. ویڈیو کس طرح شائع یا تقسیم کی جائے گی۔
2. مطلوبہ دورانیہ اور پہلو کا تناسب۔
3. پروڈکشن کے لیے دستیاب ٹولز۔
4. وہ عناصر جو نتیجے میں ظاہر نہیں ہونے چاہییں۔

ان سوالات کے جوابات ملنے کے بعد، اسکل STORY.md سے آغاز کرتا ہے اور مراحل کو ترتیب وار مکمل کرتا ہے۔

چھ مراحل پر مشتمل ورک فلو کو سمجھیں

ورک فلو STORY.md، character.txt، key/، clip/، voices.json، اور edit.json جیسے آرٹیفیکٹس بناتا ہے۔ ہر آرٹیفیکٹ بعد کے مرحلے کے لیے ان پٹ بن جاتا ہے، اس لیے کسی مرحلے کو صرف اس وجہ سے چھوڑنا نہیں چاہیے کہ اس کا آؤٹ پٹ پہلی نظر میں قابلِ قبول دکھائی دیتا ہے۔

1. کہانی اور منظر کی منصوبہ بندی

story گیٹ نامکمل فیلڈز، BPM کی معلومات، موسیقی کی ہم زمانی کی جدول میں عددی اوقات، اور مناظر کی جدول کی جانچ کرتا ہے۔ اسے پروجیکٹ ڈائریکٹری کو دوسری دلیل کے طور پر دے کر چلائیں:

python3 harness/gate.py story /path/to/video-project

مہنگا میڈیا جنریٹ کرنے سے پہلے منصوبہ بندی کی غلطیاں دور کریں۔ خاص طور پر، موسیقی کی ٹائمنگ اور مناظر کی ساخت اتنی جلدی طے کریں کہ بعد کی کٹس بیٹ گرڈ کی پیروی کر سکیں۔

2. کردار کی شیٹ

character گیٹ جانچتا ہے کہ character.txt سادہ متن کا ایک ہی پیراگراف ہے، اس میں رنگوں کی تفصیلات شامل ہیں، اور اس کے ساتھ مطلوبہ کردار شیٹ کی تصویر موجود ہے۔

python3 harness/gate.py character /path/to/video-project

مقررہ ظاہری حلیے کی تفصیل اور کردار کی شیٹ بعد کے کی فریمز اور کلپس کے لیے مشترکہ بصری حوالہ فراہم کرتی ہیں۔

3. کی فریمز

keyframes گیٹ ڈپلیکیٹ فائلوں کا پتا لگاتا ہے اور کلپس کے لیے متوقع پہلو تناسب کی جانچ کرتا ہے۔

python3 harness/gate.py keyframes /path/to/video-project

کی فریمز صرف منصوبہ بندی کی تصاویر نہیں ہیں۔ یہ تیار کردہ ویڈیو کلپس کے لیے متوقع ابتدائی فریم کے طور پر بھی کام کرتی ہیں۔

4. ویڈیو کلپس

clips گیٹ دورانیے، فریموں کی تعداد، اور یہ جانچتا ہے کہ آیا کلپ متوقع کی فریم سے شروع ہوتا ہے۔ یہ فریم اسٹرپس بھی بناتا ہے اور ہر کلپ کے لیے درج شدہ فیصلے کا تقاضا کرتا ہے۔

python3 harness/gate.py clips /path/to/video-project

ممکن ہے کہ کوئی کلپ آغاز میں اپنی کی فریم سے مطابقت رکھتا ہو، لیکن ایک یا دو سیکنڈ بعد کردار کے لباس، چشمے، بال، یا چہرے میں تبدیلی آ جائے۔ اسی وجہ سے گیٹ qa/strip-<clip>.png فائلیں بناتا ہے جن میں کی فریم اور 0، 1.0، 1.5، 2.0، اور 3.0 سیکنڈ کے فریم شامل ہوتے ہیں۔

اسٹرپس کھولیں، بعد کے فریموں کا جائزہ لیں، اور نتائج qa/clips-review.md میں درج کریں۔ SSIM جیسے مماثلت کے پیمانے ارادی کردار کی حرکت اور غیر مطلوب کردار کی شکل بگڑنے میں قابلِ اعتماد طور پر فرق نہیں کر سکتے، اس لیے بعد کے فریموں کے لیے انسانی فیصلہ ضروری ہے۔

5. موسیقی اور آواز

audio گیٹ جانچتا ہے کہ پروجیکٹ ایک وائس ID استعمال کرتا ہے اور مطلوبہ مکالمے کی فائلیں موجود ہیں۔

python3 harness/gate.py audio /path/to/video-project

کٹ کی لمبائیاں حتمی بنانے سے پہلے مکالمے کا دورانیہ ناپیں۔ بصورتِ دیگر کوئی جملہ اپنے مختص منظر میں قدرتی انداز سے فٹ نہیں ہو سکے گا۔

6. جوڑائی اور حتمی جائزہ

آخری مرحلے میں edit اور final دونوں گیٹس استعمال ہوتے ہیں۔ یہ جانچیں بیٹ گرڈ، کٹ کنکشنز، دہرائی گئی کٹس، مکالمے کا دورانیہ، فریموں کی تعداد، آڈیو کی موجودگی، لاؤڈنس، ٹرو پیک، اور مطلوبہ جائزہ ریکارڈ کا احاطہ کرتی ہیں۔

python3 harness/gate.py edit /path/to/video-project
python3 harness/gate.py final /path/to/video-project

مکمل شدہ کام کے بصری جائزے کے نتائج qa/review.md میں درج کیے جائیں۔ خودکار پیمائشیں اس جائزے کا متبادل نہیں ہیں۔

بلاک شدہ گیٹ پر کیسے عمل کریں

ہر مرحلے پر اصلاح کا یہی چکر استعمال کریں:

1. python3 harness/gate.py <stage> <project-directory> چلائیں۔
2. پروسیس کا ایگزٹ کوڈ چیک کریں۔
3. اگر کوڈ 0 ہو تو اگلے مرحلے پر جائیں۔
4. اگر کوڈ 1 ہو تو qa/gate-<stage>.txt کھولیں۔
5. BLOCK سے نشان زد سطریں تلاش کریں۔
6. متعلقہ آرٹی فیکٹ درست کریں۔
7. اسی گیٹ کو دوبارہ چلائیں، یہاں تک کہ یہ پاس ہو جائے۔

کمانڈ کو python3 harness/gate.py clips project | tail جیسی پائپ لائن کے پیچھے نہ چھپائیں۔ پائپ لائن گیٹ کے ایگزٹ اسٹیٹس کو آخری کمانڈ کے اسٹیٹس سے بدل سکتی ہے، جس سے ناکام گیٹ کامیاب دکھائی دے سکتا ہے۔

اعلیٰ سطحی پروڈکشن تجاویز

ہر جوڑ پر کردار کی شناخت مستحکم رکھیں

پروجیکٹ سات مستقل مزاجی کے معیارات متعین کرتا ہے: کردار کی شیٹ، مقررہ ظاہری حلیے کی تفصیل، کی فریم کی ابتدائی تصویر، مقررہ آواز، مکالمہ اور ہونٹوں کی حرکت، موسیقی کے بیٹ کے ساتھ ہم آہنگی، اور معیار کا جائزہ۔ یہ دیکھنے کے لیے references/consistency-7.md دیکھیں کہ چھ مرحلوں کے ورک فلو میں ہر معیار کہاں شامل ہوتا ہے۔

کٹس من مانے سیکنڈز سے نہیں، بیٹس سے بنائیں

کٹ کی لمبائیاں موسیقی کے بیٹس کے مضارب کے طور پر منتخب کریں۔ جمع شدہ ٹائمنگ کو فریمز میں تبدیل کرتے وقت، ہر انفرادی حصے کو بار بار راؤنڈ کرنے کے بجائے مجموعی وقت سے ابتدائی فریم کو ایک بار راؤنڈ کریں۔ اس سے ٹائمنگ ڈرفٹ کم ہوتا ہے اور gotchas G11 اور G12 سے متعلق رہنمائی پر عمل ہوتا ہے۔

ایڈٹ کو حتمی شکل دینے سے پہلے تقریر ناپیں

حتمی کٹ کا دورانیہ طے کرنے سے پہلے مکالمہ تیار کریں یا اس کی پیمائش کریں۔ یہ ترتیب تقریر کو بہت مختصر منظر میں ٹھونسے جانے سے روکتی ہے اور gotcha G13 سے نمٹتی ہے۔

قابلِ اعتماد ffprobe آؤٹ پٹ استعمال کریں

ICC پروفائلز والی ویڈیوز ffprobe -of csv=p=0 کو فریموں کی تعداد مثلاً 30, پرنٹ کرنے کا سبب بن سکتی ہیں۔ پروجیکٹ بغیر ریپرز یا keys کے ڈیفالٹ آؤٹ پٹ کی سفارش کرتا ہے:

ffprobe -of default=nw=1:nk=1 ...

فلٹرنگ کے دوران آڈیو ڈیلے برقرار رکھیں

ffmpeg استعمال کرتے وقت adelay کے بعد apad اور atrim لگانے سے مطلوبہ ڈیلے ختم ہو سکتا ہے۔ اس صورتِ حال میں پروجیکٹ کی gotcha رہنمائی asetpts=N/SR/TB استعمال کرنے کا تقاضا کرتی ہے۔

اندھا دھند خرابی دور کرنے سے پہلے شامل کردہ حوالہ جات استعمال کریں

جب کوئی مرحلہ بار بار ناکام ہو یا تیار کردہ میڈیا غیر متوقع طور پر تبدیل ہو جائے تو skills/motion-video-production/references/gotchas.md کھولیں۔ اس کی 29 اندراجات میں سے ہر ایک علامت، ممکنہ وجہ، احتیاطی اقدام، اور متعلقہ harness چیک ID درج کرتا ہے۔

جاننے کے قابل ریپوزٹری اجزا

• SKILL.md میں Claude Code کی اسکل ہدایات شامل ہیں۔
• harness/gate.py مرحلے کے لحاظ سے پاس یا بلاک چیکس انجام دیتا ہے۔
• harness/selftest.sh harness کی تنصیب کی توثیق کرتا ہے۔
• scripts/ میں ڈپلیکیٹ چیکنگ، کلپ شیٹ بنانے، کی پلیٹس، بیٹ گرڈ بنانے، مکسنگ، مکسنگ، اور توثیقی سہولیات شامل ہیں۔
• templates/ میں کہانیوں، کردار کی شیٹس، پرامپٹس، اور منظر کے آڈٹس کے سانچے شامل ہیں۔
• references/ میں مستقل مزاجی کی رہنمائی، بیٹ گرڈ کی معلومات، لاگت کے اصول، ٹول نوٹس، لائسنسنگ کی معلومات، اور پروڈکشن کی gotchas شامل ہیں۔
• NOTICE.md بیرونی ٹولز سے متعلق امور کا خلاصہ پیش کرتا ہے۔

لائسنسنگ اور ذمہ داری

ریپوزٹری خود MIT لائسنس استعمال کرتی ہے، لیکن بیرونی جنریشن ٹولز کی اپنی قیمتوں، استعمال اور تجارتی لائسنس کی شرائط ہوتی ہیں۔ NOTICE.md اور references/licensing.md کا جائزہ لیں، پھر پروڈکشن سے پہلے موجودہ شرائط کی براہِ راست تصدیق کریں، کیونکہ قیمتیں اور پالیسیاں تبدیل ہو سکتی ہیں۔ تیار کردہ اثاثوں کی ذمہ داری ان نوٹسز اور بیرونی شرائط کے تابع رہتی ہے۔

نتیجہ

Motion Video Production مختصر ویڈیوز کی تخلیق کو ایک قابلِ تکرار اور قابلِ جانچ ورک فلو میں تبدیل کرتا ہے۔ اس کی اصل قدر کسی ایک جنریشن ٹول میں نہیں، بلکہ ان منصوبوں، کرداروں کے حوالہ جات، کی فریمز، کلپس، آواز اور حتمی ایڈیٹ کو جوڑنے والی منظم ترتیب میں ہے۔ گیٹ کی ناکامی کو نظرانداز کرنے کے بجائے اصلاحی کام سمجھ کر، اور مطلوبہ بصری جائزے مکمل کر کے، آپ تسلسل، ٹائمنگ اور ڈیلیوری کے مسائل کو حتمی ویڈیو تک پہنچنے سے پہلے پکڑ سکتے ہیں۔