Claude Code اور Machine Skill کے ساتھ حقیقت پسندانہ انٹرایکٹو مشین سمیولیشنز بنائیں

Machine Skill کیا کرتا ہے

Machine Skill، Claude Code کے لیے ایک اوپن سورس Agent Skill ہے۔ آپ ایک سطر میں کسی مشین کی وضاحت کرتے ہیں، اور Claude حقیقی آلے پر تحقیق کرنے کے بعد ایک ہی HTML فائل میں فوٹو ریئلسٹک، انٹرایکٹو 3D سمولیشن تیار کرتا ہے۔

تیار کردہ صفحات میکانزم، انجن، آلات اور صنعتی سازوسامان کی نمائندگی کر سکتے ہیں۔ ان میں procedural three.js جیومیٹری، حقیقی تناسب، نامزد اجزا، مواد، انٹرایکٹو موڈز اور مشین کے لیے موزوں ایک مختصر فزکس سولور استعمال ہوتا ہے۔ آپ نتیجے میں بننے والی HTML فائل کو براؤزر میں کھول سکتے ہیں، اس کے حصوں کا معائنہ کر سکتے ہیں، عملی حالات تبدیل کر سکتے ہیں، اسے کاٹ کر اندر دیکھ سکتے ہیں، یا حساب کردہ خرابی کی حالت میں اسے توڑ سکتے ہیں۔

پروجیکٹ میں تیار کردہ صفحات سے قابل تکرار فلمیں، اسکرین شاٹس اور سوشل میڈیا فارمیٹس بنانے کے لیے ایک ریکارڈر بھی شامل ہے۔

اہم خصوصیات

• حقیقت پسندانہ مشین کی تعمیر: ماڈلز میں حقیقی پیمائشیں، نامزد حصے، ٹھوس اجزا، بلیڈز، گیئرز، بولٹس، پائپس اور دیگر procedural جیومیٹری شامل ہوتی ہے۔
• فزکس پر مبنی رویہ: Brayton-cycle، rocket-nozzle، pump-curve، torsional-oscillator، Darcy اور Kienzle جیسے سولور حرکت اور دکھائی جانے والی قدروں کو کنٹرول کرتے ہیں۔
• انٹرایکٹو پیشکش: صفحات میں ڈریگنگ، توقف، لائیو لیبلز، سست رفتار، explode views، x-ray views اور ٹھوس سیکشن فیسز کے ساتھ cutaways شامل ہوتے ہیں۔
• اسٹوڈیو معیار کی رینڈرنگ: رن ٹائم میں مواد، روشنی، سائے، ambient occlusion، bloom، heat glow اور presentation environments فراہم کیے گئے ہیں۔
• قابل تکرار فلمیں: فلم موڈ ریکارڈر کو سمولیشن کو فریم بہ فریم آگے بڑھانے دیتا ہے، تاکہ بار بار کی گئی ریکارڈنگز یکساں رینڈر ہوں۔
• بلڈ اسٹیپ کے بغیر: تیار کردہ صفحات آزاد HTML فائلیں ہوتی ہیں، جن میں inlined runtime اور pinned three.js 0.170 CDN dependency استعمال ہوتی ہے۔

تقاضے

مشینیں بنانے کے لیے Claude Code انسٹال کریں یا کوئی ایسا host استعمال کریں جو Agent Skills کو سپورٹ کرتا ہو۔ تیار کردہ صفحات چلانے کے لیے WebGL 2 والا براؤزر استعمال کریں، جیسے Chrome، Safari، Firefox یا Edge کے موجودہ ڈیسک ٹاپ ورژنز۔

اسکرین شاٹس اور فلموں کے لیے Node 18 یا اس کے بعد کا ورژن، Playwright، Chromium اور ffmpeg بھی درکار ہیں۔

npm i -D playwright
npx playwright install chromium

اپنے آپریٹنگ سسٹم کے package manager کے ذریعے ffmpeg انسٹال کریں۔ فون ہلکے صفحات چلا سکتے ہیں، لیکن پیچیدہ سمولیشنز حقیقی GPU والے نئے کمپیوٹر پر بہترین کارکردگی دکھاتی ہیں۔

Machine Skill انسٹال کریں

تجویز کردہ تنصیب skills CLI استعمال کرتی ہے اور repository کو Claude Code skill کے طور پر انسٹال کرتی ہے۔

npx skills add AirsupHQ/machine-skill -g -a claude-code

گلوبل تنصیب skill کو ~/.claude/skills/machine میں رکھتی ہے۔ اسے صرف موجودہ پروجیکٹ کے لیے انسٹال کرنے کی خاطر global اور agent options حذف کریں:

npx skills add AirsupHQ/machine-skill

یہ پروجیکٹ تنصیب skill کو .claude/skills/machine میں رکھتی ہے۔ آپ repository کو براہ راست clone بھی کر سکتے ہیں:

git clone https://github.com/AirsupHQ/machine-skill.git ~/.claude/skills/machine

# Or install into one project
git clone https://github.com/AirsupHQ/machine-skill.git .claude/skills/machine

Claude Code عام طور پر جاری session میں نئی skills کا پتا لگا لیتا ہے۔ اگر session شروع ہونے کے وقت skills directory موجود نہیں تھی تو /reload-skills چلائیں۔

اپنی پہلی مشین تیار کریں

تنصیب کے بعد Claude Code کھولیں اور /machine command کے بعد ایک واضح وضاحت لکھیں۔

/machine a mechanical watch movement, the escapement ticking

Claude ایک HTML صفحہ بناتا ہے، مثلاً watch.html۔ اس فائل کو WebGL 2 والے براؤزر میں کھولیں اور سمولیشن کے ساتھ تعامل کریں۔ تیار کردہ مشین کے مطابق آپ منظر کو ڈریگ کر سکتے ہیں، لیبلز کا معائنہ کر سکتے ہیں، assembly کو explode کر سکتے ہیں، اسے کاٹ کر اندر دیکھ سکتے ہیں، یا اس کے ماڈل کردہ failure behavior کو متحرک کر سکتے ہیں۔

دیگر درست prompts میں شامل ہیں:

• /machine a hydroelectric Francis turbine
• /machine a Swiss lever escapement, slowed down so I can see the impulse
• /machine the gearbox of a 5 MW wind turbine, cut open
• /machine a steam locomotive's valve gear, and give me a 30 second video for X

بہتر machine prompts لکھیں

Machine Skill اس وقت بہترین کام کرتا ہے جب prompt میں اتنا engineering context موجود ہو کہ Claude مطلوبہ object پر تحقیق کر سکے اور ایک مفید operating point منتخب کر سکے۔

1. حقیقی مشین کا نام بتائیں۔ “a turbofan like the ones on a 787” جیسا prompt، “a jet engine” سے زیادہ واضح سمت فراہم کرتا ہے۔
2. حرکت اور failure behavior متعین کریں۔ بتائیں کہ کیا حرکت کرنی چاہیے اور کیا ٹوٹنا چاہیے، مثلاً Claude سے engine کو اس وقت تک rev کرنے کے لیے کہنا جب تک اس کے valves float نہ کریں۔
3. مقصد بیان کریں۔ Claude کو بتائیں کہ output embedded page، social video یا still image کے لیے ہے۔ ویڈیو کے لیے مطلوبہ aspect ratio یا duration بھی شامل کریں۔

تیار کردہ physics، CFD یا FEA کے بجائے ایک دیانت دار چھوٹا model ہے۔ ہر صفحہ بتاتا ہے کہ وہ کیا calculate کرتا ہے اور کیا simplify کرتا ہے، اس لیے قدروں کو certified engineering results کے بجائے تعلیمی اور illustrative سمجھیں۔

فلم ریکارڈ کریں

تیار کردہ صفحے کو ویڈیو فائل میں render کرنے کے لیے repository کی record.mjs script استعمال کریں۔

node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_Lemon

cloned repository سے کام کرتے وقت local script path استعمال کریں:

node scripts/record.mjs examples/turbofan.html out/turbofan.mp4 --music freepd:Classical/Easy_Lemon

output dimensions متعین کر کے آپ feed کے لیے portrait ویڈیو بنا سکتے ہیں:

node scripts/record.mjs examples/turbofan.html out/turbofan-feed.mp4 --w 1080 --h 1350

ویڈیو کے بجائے منتخب جامد فریم برآمد کرنے کے لیے آؤٹ پٹ ڈائریکٹری اور فریم نمبرز فراہم کریں:

node scripts/record.mjs examples/turbofan.html out/stills --stills 3,9,14,19

ریکارڈر اضافی رینڈرنگ کنٹرولز کو سپورٹ کرتا ہے۔ سپر سیمپلنگ کے لیے --ss 1.5، موشن بلر کے لیے --blur 2، اور تیز حرکت کے لیے --fps 60 استعمال کریں۔ موسیقی مقامی فائل، URL، یا FreePD کا freepd:<Category>/<Name> ٹریک ہو سکتی ہے۔

تیار کردہ صفحات ?film=1&shot=main جیسے کوئری پیرامیٹرز کے ساتھ ڈیٹرمنسٹک فلم موڈ میں چل سکتے ہیں۔ اس موڈ میں وقت صرف اسی وقت آگے بڑھتا ہے جب ریکارڈر اسے آگے بڑھاتا ہے، جس سے ہر فریم مکمل طور پر رینڈر ہوتا ہے اور بار بار کی گئی ریکارڈنگز یکساں رہتی ہیں۔

رینڈر شدہ آؤٹ پٹ چیک کریں

Machine Skill میں ہیڈ لیس رینڈرنگ کی ناکامیوں سے بچاؤ کے اقدامات شامل ہیں۔ ریکارڈر اسکرین شاٹس میں مکمل میجنٹا فریمز چیک کرتا ہے، جبکہ pinkscan.mjs مکمل شدہ ویڈیوز کو اسکین کر سکتا ہے۔

node scripts/pinkscan.mjs out/*.mp4

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

ریپوزٹری کا جائزہ لیں

• SKILL.md معیار، تحقیق اور ماڈلنگ کے ورک فلو، نقاد کے ادوار، فلمی عمل، اور اسکرین پر تحریر کے انداز کی وضاحت کرتا ہے۔
• kit/lab-kit.js تیار کردہ صفحات میں شامل کیا جانے والا رن ٹائم ہے۔ اس میں اسٹوڈیو، پوسٹ پروسیسنگ، مواد، جیومیٹری مددگار، لیبلز، ایفیکٹس، انٹرایکشن موڈز، اور فلم ٹائم لائن شامل ہیں۔
• kit/template.html دستی طور پر بنائی جانے والی مشینوں کے لیے ابتدائی صفحہ ٹیمپلیٹ ہے۔
• references/solvers.md میں گیس ٹربائنز، راکٹ، پسٹن انجنز، پمپس، روٹرز، اور برقی مشینوں جیسی مشینوں کے لیے طبیعیات کی ترکیبیں اور حقیقی مستقلات شامل ہیں۔
• scripts/ میں اسکرین شاٹس، ریکارڈنگ، گلابی فریم چیکس، اور رن ٹائم کو شامل کرنے کے ٹولز موجود ہیں۔
• examples/ میں الگ HTML مظاہرے شامل ہیں، جن میں ٹربوفین، راکٹ انجن، پراسیس پمپ، اور کمپریسر شامل ہیں۔
• film/launch.html لانچ فلم کے لیے استعمال ہونے والا ڈائریکٹر صفحہ ہے۔

انٹرایکٹو کٹ اوے کو سمجھیں

کٹ اوے سسٹم بند ٹھوس اجسام اور کلپنگ طیاروں کے ساتھ کام کرتا ہے۔ جب کوئی طیارہ کسی ٹھوس جسم کو کھولتا ہے تو رن ٹائم سیکشن کی سطح کا پتا لگاتا ہے اور مواد کی مشینی ظاہری شکل اور ہلکی ہیچ کے ساتھ ٹھوس سیکشن فیس رینڈر کرتا ہے۔ چونکہ سیکشن کی گہرائی درست طور پر لکھی جاتی ہے، اس لیے کٹ اوے الگ کیپ میشز کے بغیر دوسری جیومیٹری کو ڈھانپ سکتا ہے۔

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

ورک فلو کو دوسرے ایجنٹ ہوسٹس کے لیے ڈھالیں

Machine Skill کو ایک معیاری Agent Skill کے طور پر پیکیج کیا گیا ہے۔ Claude.ai یا Claude ڈیسک ٹاپ ایپ میں، آپ skill فولڈر کو زپ کر کے Settings، Capabilities، اور Skills کے تحت اپ لوڈ کر سکتے ہیں۔ Claude Agent SDK یا API کے لیے فولڈر کو skill ڈائریکٹری کے طور پر ماؤنٹ کریں۔ Agent Skills سے مطابقت رکھنے والے دوسرے ٹولز براہ راست SKILL.md کی طرف اشارہ کر سکتے ہیں۔

اگر آپ ایجنٹ استعمال نہیں کر رہے تو kit/template.html کی نقل بنا کر اس کے سیکشنز دستی طور پر مکمل کریں۔ تیار کردہ صفحات عام HTML فائلیں ہی رہتے ہیں جو براؤزر میں چلتی ہیں۔

حدود سے آگاہ رہیں

• یہ skill مشینوں، میکانزمز، انجنز، آلات، اور ڈیوائسز کے لیے تیار کی گئی ہے۔ افراد، مناظر، اور نقشے کمزور استعمالی صورتیں ہیں۔
• جیومیٹری procedural three.js مواد ہے۔ اس کا مقصد درست تناسب اور پرزوں کی تعداد ہے، مینوفیکچرنگ ٹالرنس یا CAD ایکسپورٹ کی درستگی نہیں۔
• طبیعیاتی ماڈلز جان بوجھ کر چھوٹے اور شفاف رکھے گئے ہیں۔ انہیں عوامی اعداد و شمار کے مقابل جانچا جاتا ہے، لیکن یہ CFD، FEA، یا مصدقہ انجینئرنگ تجزیے کا متبادل نہیں ہیں۔
• پیچیدہ صفحات میں تقریباً 600,000 مثلث شامل ہو سکتے ہیں اور سائے، ایمبیئنٹ اوکلوژن، اور بلوم کے ساتھ ہموار کارکردگی برقرار رکھنے کے لیے حالیہ لیپ ٹاپ GPU درکار ہو سکتا ہے۔

نتیجہ

Machine Skill ایک مختصر انجینئرنگ پرامپٹ کو حقیقی تناسب، محسوب رویے، اور پیشکش کے لیے تیار رینڈرنگ والی قابلِ دریافت براؤزر سیمولیشن میں تبدیل کر دیتا ہے۔ اسے skills CLI کے ذریعے انسٹال کریں، واضح حرکت اور ناکامی کی ضروریات کے ساتھ کسی مخصوص مشین کی وضاحت کریں، پھر تیار کردہ HTML صفحہ کھولیں۔ جب آپ شائع کرنے کے لیے تیار ہوں تو اسی سیمولیشن سے ویڈیوز یا جامد تصاویر بنانے کے لیے ڈیٹرمنسٹک ریکارڈر استعمال کریں۔