دریافت کریں AI SDLC – بلڈنگ ایجنٹ ٹیکنالوجی کے لیے مکمل گائیڈ

شاید آپ اس منظر نامے سے متعلق ہو سکتے ہیں۔ اس ہفتے ہم نے انہی ہدایات کا استعمال کرتے ہوئے AI ماڈل کی چار بار وضاحت کی۔

آپ نے بار بار بات کی ہے کہ ٹیمیں اپنے ڈیک کیسے بناتی ہیں۔ یہ ایک چیک ہے جو تعیناتی سے پہلے چلتا ہے۔ سٹیجنگ ڈیٹا بیس README میں ڈیٹا بیس کیوں نہیں ہے؟

ہر بار دوبارہ داخل کریں۔ ایجنٹ ہر بار بہت اچھا کام کرتا ہے۔ اور ہر بار اگلا سیشن 0 سے شروع ہوتا ہے۔

یہی مسئلہ ہے۔ ایجنٹ ٹیکنالوجی اسے حل کریں۔

مہارت ایک فولڈر ہے جس میں ایک Skill.md فائل ہوتی ہے۔ ایجنٹ سٹارٹ اپ پر ایک لائن کا خلاصہ پڑھتا ہے اور مکمل ہدایات صرف اس وقت کھولتا ہے جب کام کو درحقیقت اس کی ضرورت ہو۔ اپنی تفصیل ایک بار لکھیں، اسے اپنے کوڈ کے آگے ارتکاب کریں، اور آپ کی ٹیم کا ہر ایجنٹ اس تک رسائی حاصل کر سکتا ہے، خودکار مشکل کاموں کو۔

Anthropic سے شروع ہونے والا فارمیٹ ایک کھلے معیار کے طور پر جاری کیا گیا تھا اور اب اس کے ساتھ کام کرنے والے 45 سے زیادہ ٹولز کو سپورٹ کرتا ہے، بشمول Claude Code، VS Code، GitHub Copilot، Cursor، Gemini CLI، Codex، Goose، اور JetBrains Junie۔ گوگل اینٹی گریویٹی بھی اس کی حمایت کرتا ہے۔ ایک فولڈر، آپ کے تمام ٹولز۔

ایجنٹ کی مہارت کے ساتھ دوبارہ قابل تکرار کاموں کو خودکار بنائیں

زیادہ تر رہنما 12 حصوں میں 12 نامکمل مثالیں پھیلاتے ہیں۔ یہاں ہم شروع سے حقیقی ایجنٹ ٹیکنالوجی تیار کریں گے جو تمام AI ٹولز میں مطابقت رکھتی ہے۔

ہم تعمیر کریں گے بالکل ایک مہارتبلایا deck-builderاس دستاویز میں یہ واحد مثال ہے۔ اپنے ایجنٹوں کو اس طرح کی مبہم درخواستوں کو سنبھالنا سکھائیں: "براہ کرم تیسری سہ ماہی میں ہجرت سے متعلق مواد تیار کریں۔” پریزنٹیشن کی اصل خاکہ تک پہلے سوچ بچار کریں، دوسری سلائیڈ لکھیں۔.

وہ حکم کلید ہے۔ جب آپ ماڈل سے ڈیک مانگتے ہیں، تو یہ فوراً سلائیڈ 1 بنانا شروع کر دیتا ہے۔ آپ کو صاف، عام بلٹ پوائنٹس کے ساتھ 12 سلائیڈیں ملیں گی جو آپ کی پریزنٹیشن کے مواد کو ڈکٹیٹ نہیں کرتی ہیں۔ کے لیے.

جو لوگ اس میں اچھے ہیں وہ کچھ مختلف کرتے ہیں۔ وہ پوچھتے ہیں کہ کمرے میں کون ہے، وہ اپنے سامعین کو کیا پیغام دینا چاہتے ہیں، اور وہ کون سا خاکہ یا فریم ورک استعمال کرنا چاہتے ہیں۔ پھر آپ اپنے ذہنی ماڈل کی بنیاد پر ایک پریزنٹیشن بنانا شروع کر دیتے ہیں۔

تکنیک مارک ڈاؤن کی 28 لائنوں سے شروع ہوتی ہے جو 10 منٹ میں لکھی جا سکتی ہے۔ حتمی نتیجہ میں ٹیون شدہ تفصیل، جھوٹی مثبت فہرستیں، بنڈل توثیق کرنے والے، آن ڈیمانڈ ریفرنس فائلز، ایویلیویشن سویٹس، اور صاف حفاظتی تلاش شامل ہیں۔ اس گائیڈ میں موجود تمام آئیڈیاز اسی فولڈر میں ظاہر ہوتے ہیں جیسے وہ بڑھتے ہیں۔

اس کے لیے آپ کو کسی اکاؤنٹ، API کلید یا پاورپوائنٹ کی ضرورت نہیں ہے۔ جب آپ مہارت کے فولڈر میں کوئی مہارت چسپاں کرتے ہیں، تو آپ کی تخلیق کردہ مہارت کی بنیاد پر ایک پریزنٹیشن بنائی جائے گی۔

انڈیکس

شرائط

اس گائیڈ پر عمل کرنے کے لیے آپ کو AI ایجنٹس کے بارے میں گہرے علم کی ضرورت نہیں ہے، لیکن کچھ بنیادی باتیں مثالوں کے ساتھ کام کرنا آسان بنا دیں گی۔

آپ کو مارک ڈاؤن فائلوں کے ساتھ کام کرنے، پراجیکٹ ڈائریکٹریز کو نیویگیٹ کرنے، اور ٹرمینل میں سادہ کمانڈ چلانے میں ماہر ہونا چاہیے۔ مثال بنڈل توثیق کرنے والے کے لئے ازگر کا استعمال کرتی ہے، لہذا آپ کو بھی ضرورت ہوگی: Python 3.9 یا اس سے زیادہ یہ آپ کے کمپیوٹر پر انسٹال ہے۔

مشق میں، آپ AI کوڈنگ کلائنٹس کا استعمال کرتے ہوئے کام کریں گے جو ایجنٹ ٹیکنالوجیز کو سپورٹ کرتے ہیں، جیسے Claude Code، VS Code with GitHub Copilot، یا Google Antigravity۔ ٹیکنالوجی کو خود کسی اکاؤنٹ، API کلید، یا پاورپوائنٹ کی ضرورت نہیں ہے۔

بس آپ کی ضرورت ہے۔ آئیے سنگل کے ساتھ شروع کریں۔ SKILL.md ایک فائل بنائیں اور پھر اسے مرحلہ وار بنائیں کیونکہ آپ کا ورک فلو زیادہ مفید اور مستحکم ہوتا ہے۔

ایجنٹ ٹیکنالوجی اصل میں کیا ہے؟

ہنر ڈائریکٹریز ہیں۔ اس میں ایک مطلوبہ فائل ہے: SKILL.md.

فائل دو حصوں پر مشتمل ہے۔ اوپر ایک مختصر YAML بلاک اور نیچے مارک ڈاؤن ہدایات۔ باقی سب کچھ اختیاری ہے۔

نوٹ: اس فولڈر میں مزید فائلیں شامل کرنے سے مزید ٹوکن استعمال ہوں گے کیونکہ سیاق و سباق کی ونڈو غیر متعلقہ یا مردہ فائلوں کے ساتھ بڑھتی ہے۔

میں کہاں ہوں؟ deck-builder یہ اس گائیڈ کا اختتام ہے۔

deck-builder/
├── SKILL.md                                
├── scripts/
│   └── validate_deck.py          
├── references/
│   └── narrative-patterns.md
└── evals/
    └── evals.json                

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

جو چیز کسی فارمیٹ کو استعمال کرنے کے قابل بناتی ہے وہ وہ مواد ہے جسے وہ پکڑتا ہے۔

• ایسی مہارت جس کا ایجنٹ اندازہ نہیں لگا سکتے: گیٹس، پریزنٹیشن اسٹائل، ڈیک رولز، فریم ورک وغیرہ کا جائزہ لیں۔

• کام کا بہاؤ دہرانا: ملٹی سٹیپ ٹاسک ایڈہاک عمل کے بجائے ایک مستقل عمل بن جاتے ہیں۔

• متعدد ٹولز میں دوبارہ استعمال کریں: اسے ایک بار بنائیں اور اسے کسی بھی مطابقت پذیر کلائنٹ (کلاڈ کوڈ، وی ایس کوڈ، وغیرہ) میں چلائیں۔

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

کیوں بہت بڑا سسٹم پرامپٹ کام کرنا چھوڑ دیتا ہے۔

زیادہ تر ٹیمیں ہر چیز کو ہمیشہ ایک میں رکھ کر شروع کرتی ہیں۔ AGENTS.md، CLAUDE.mdیا آپ کے کوڈ میں سسٹم پرامپٹ۔ ڈیک رولز تعیناتی رن بک اور اسٹائل گائیڈ کے درمیان شامل ہیں۔

اگر آپ دو اصول استعمال کرتے ہیں تو آپ ٹھیک ہو جائیں گے۔ لیکن یہ تین وجوہات کی بنا پر ٹوٹ گیا۔

1. ہر درخواست کے لیے ایک قیمت ہے۔

ہر API کال کے ساتھ ایک سسٹم پرامپٹ لوڈ ہوتا ہے۔ صارفین کچھ بھی داخل کرنے سے پہلے 20 رن بکس دسیوں ہزار ٹوکن تک پہنچ سکتے ہیں۔

آپ پہلی باری پر ادائیگی کرتے ہیں۔ باری 40 پر دوبارہ ادائیگی کریں۔ یہ تب ادائیگی کرتا ہے جب گفتگو کا پریزنٹیشن سے کوئی تعلق نہ ہو۔

2. طویل سیاق و سباق کا مطلب دلچسپی بھی نہیں ہے۔

ایک بڑی سیاق و سباق کی کھڑکی ایک جیسی نہیں ہے جیسے اس پر یکساں توجہ ہو۔

ہدایات کی پیروی کی کارکردگی اس وقت متاثر ہوتی ہے جب اہم لائنیں ہزاروں غیر متعلقہ لائنوں کے درمیان دب جاتی ہیں۔ "سلائیڈز بنانے سے پہلے سوچ بچار کریں۔2,000 ٹوکن پرامپٹس پر قابل اعتماد طریقے سے احترام کیا جاتا ہے۔ 80,000 ٹوکن پرامپٹ پر یہ مرکزی نکتہ کو چھوڑ دیتا ہے۔ مزید سیاق و سباق کو لوڈ کرنا اسے سمجھنے جیسا نہیں ہے۔

3. نثر طریقہ کار کو مجبور نہیں کر سکتا۔

ماڈل سے پوچھیں:جائزہ دیکھیں"مجھے ہر بار ایک مختلف چیک ملتا ہے۔ کبھی کبھی میں مکمل جائزہ لیتا ہوں، کبھی مجھے تعریف کا جملہ ملتا ہے۔

نثر ایک ایجنٹ بناتا ہے۔ امکان ہے صحیح کام کرنا۔ صرف اسکرپٹ اسے بناتا ہے۔ ثابت.

ترقی پسند انکشاف پہلے دو کو ٹھیک کرتا ہے۔ ہم ورژن 4 میں جس تصدیق کنندہ کو شامل کر رہے ہیں وہ تیسرے نقطہ کو ٹھیک کرتا ہے۔

ایجنٹ کی مہارت کے لیے ٹوکن کی اصلاح

ایجنٹ تین مراحل میں مہارتیں لوڈ کرتے ہیں: یہ سمجھنا کہ ہر مرحلہ کہاں ختم ہوتا ہے کہ آپ اپنی صلاحیتوں کو کس طرح موثر رکھتے ہیں۔

تصریح اس پر حقیقی نمبروں کا اطلاق کرتی ہے۔ تلاش کرتے وقت تقریباً 100 میٹا ڈیٹا ٹوکن فی ہنر۔ ایکٹیویشن پر فی کنسول کی تجویز کردہ حد 500 لائنیں یا 5,000 ٹوکنز ہیں۔ کسی بھی چیز کا تعلق بھاری ہے۔ references/.

چالو کرنا ایک بار کی لاگت نہیں ہے۔

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

کلاڈ کوڈ اس کو قطعی طور پر دستاویز کرتا ہے۔ SKILL.md ایک پیغام کے ساتھ گفتگو میں شامل ہوں۔ باقی سیشن کے لیے وہیں رہیں. فائل کو بعد میں دوبارہ نہیں پڑھا جائے گا۔

یہاں تین نتائج ہیں:

• ہر لائن ایک بار بار چلنے والی لاگت ہے۔ پھولا ہوا جسم اس موڑ پر چارج کرتا ہے جس نے اسے متحرک کیا، ساتھ ہی 20 ویں موڑ پر۔

• جاری رہنما خطوط بنائیں، نہ کہ ایک بار کے اقدامات۔ ایجنٹ ہر سیشن میں ایک ہی متن دیکھتے ہیں۔

• کمپریشن ٹیکنالوجی کو ختم کر سکتا ہے۔ طویل گفتگو کو کم کرتے وقت، کلاڈ کوڈ ہر مہارت کے پہلے 5,000 ٹوکنز کو، سب سے حالیہ، مشترکہ 25,000 ٹوکن بجٹ کے اندر رکھتے ہوئے، ہر ہنر کی تازہ ترین درخواستوں کو دوبارہ جوڑتا ہے۔ اگر آپ بہت ساری مہارتوں کو چالو کرتے ہیں تو تیز ترین مہارتیں مکمل طور پر غائب ہو جائیں گی۔

آخری نکتہ ایک علامت کی وضاحت کرتا ہے جسے لوگ اکثر غلط پڑھتے ہیں۔ یہاں تک کہ اگر سیشن کے دوران کوئی ہنر کام نہیں کرتا ہے، تو ضروری نہیں کہ رہنمائی ضائع ہو۔ ماڈل صرف ایک مختلف نقطہ نظر کو ترجیح دے سکتا ہے۔ اس صورت میں، مہارت کی ہدایات کو مضبوط کریں یا سیاق و سباق کو سکیڑیں اور اسے دوبارہ کال کریں۔

سادہ ریاضی

N کو ان مہارتوں کی تعداد مانیں جو آپ نے انسٹال کی ہیں، T (نزول) کو ایک میٹا ڈیٹا کی قیمت، T (کل) کو ایک باڈی کی لاگت، اور k کو ان مہارتوں کی تعداد مانیں جو کام اصل میں کھلتا ہے۔

سب کچھ پہلے سے لوڈ کریں۔

$$C_{text{static}} = N times T_{text{full}}$$

آہستہ آہستہ لوڈ کریں:

$$C_{text{Progressive}} = N times T_{text{desc}} + k times T_{text{full}}$$

$$استعمال کرتا ہے وضاحتی’ کا اپنا بجٹ: T_{desc} = 100 and T_{full} = 5,000, for 50 skills where one is enabled.$$

$$C_{text{static}} = 50 times 5{,}000 = 250{,}000text{ token}$$

$$C_{text{Gradual}} = (50 times 100) + 5{,}000 = 10{,}000text{ ٹوکن}$$

$$rho = 1 – frac{10{,}000}{250{,}000} = 0.96$$

96 فیصد کمی آپ ایک ہی کام کے لیے وہی 50 فیچر استعمال کر سکتے ہیں۔

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

مہارت کا تجزیہ

دیباچہ

اوپر والے YAML بلاک میں دو مطلوبہ فیلڈز اور چار اختیاری فیلڈز ہیں۔

میدان	ضروری	حکمرانی
name	ہاں	1 سے 64 حروف۔ چھوٹے حروف، نمبر، ہائفن۔ کوئی معروف، پچھلی، یا ڈبل ​​ہائفنز نہیں ہیں۔ اسے فولڈر کے نام سے مماثل ہونا چاہیے۔
description	ہاں	1 سے 1024 حروف۔ یہ آپ کو بتاتا ہے کہ ہنر کیا ہے۔ اور اسے کب استعمال کرنا ہے۔
license	نہیں	لائسنس کا نام یا بنڈل لائسنس فائل۔
compatibility	نہیں	500 حروف تک۔ ماحولیاتی تقاضے: پروڈکٹ، پیکیجنگ اور نیٹ ورک تک رسائی۔
metadata	نہیں	آپ کے اپنے ٹولز کے لیے فری فارم سٹرنگ میپ۔
allowed-tools	نہیں	پہلے سے منظور شدہ ٹولز کی جگہ سے الگ کردہ فہرست۔ کلاڈ کوڈ، قیاس کے مطابق تجرباتی نشان زد، اسے مکمل طور پر نافذ کرتا ہے۔ ذیل میں نوٹ دیکھیں۔

یہاں کیا ہے deck-builder یہ اس طرح ختم ہوتا ہے:

---
name: deck-builder
description: >-
  Turn a request for a presentation into a slide outline. Brainstorm the
  audience, core message, and narrative arc first, then write slides. Use
  when someone asks for a deck, slides, a presentation, a readout, a board
  update, or a talk, including when they only say "put something together
  for Thursday" without naming a format.
license: Apache-2.0
compatibility: Requires Python 3.9+. No network access needed.
---

دو اصولوں کو نظر انداز کرنا آسان ہے، خاص طور پر جب آپ کلائنٹس کے درمیان ٹیکنالوجی کو پورٹ کرنا شروع کرتے ہیں۔ پہلا یہ ہے۔ name فیلڈ: نہ صرف ایک لیبل۔ قیاس کے مطابق، یہ پیرنٹ فولڈر سے بالکل مماثل ہونا چاہیے۔ تو آپ کی مہارت deck-builder/SKILL.mdعنوان کو استعمال کرنا چاہئے: name: deck-builderنہیں name: deckBuilder.

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

جہاں کلائنٹ چھ علاقوں میں پھیلتے ہیں۔

میز ہے تفصیلات. انفرادی کلائنٹس کچھ آرام کرتے ہیں اور اپنی فیلڈ شامل کرتے ہیں۔ آپ جس سرخی کا اشتراک کرنا چاہتے ہیں اسے لکھنے سے پہلے یہ جان لینا اچھا خیال ہے۔

کلاڈ کوڈ سب سے وسیع نفاذ ہے۔ علاج name اختیاری، فولڈر کے نام سے پہلے سے طے شدہ۔ ذاتی یا پروجیکٹ کی مہارتوں میں، name جبکہ فولڈر کا نام اس کمانڈ کے ساتھ سیٹ کیا جاتا ہے، یہ صرف ڈسپلے لیبل سیٹ کرتا ہے۔ علاج description متن کے پہلے پیراگراف پر واپس جائیں جیسا کہ تجویز کیا گیا ہے، ضرورت نہیں ہے۔ مہارت کی فہرست کی تفصیل کو 1,536 حروف سے چھوٹا کر دیا گیا۔ یہ قبول کرتا ہے license اور compatibility ان کے خلاف کارروائی کیے بغیر۔

چھ کے علاوہ، تقریباً ایک درجن مزید آنے والے ہیں، بشمول: when_to_use، argument-hint، arguments، disable-model-invocation، user-invocable، disallowed-tools، model، effort، context، agent، hooks، pathsاور shell.

یہاں مسئلہ ہے۔ یہ ایکسٹینشنز پورٹیبل نہیں ہیں اور انہیں محض نظر انداز نہیں کیا جا سکتا۔

مثال کے طور پر، کلاڈ کوڈ درج ذیل اضافی ہیڈر فیلڈز کو سپورٹ کرتا ہے: argument-hint اور when_to_use. ٹیکنالوجی کلاڈ کوڈ میں اس فیلڈ کے ساتھ بالکل کام کر سکتی ہے۔ لیکن اگر آپ اسی طرح حرکت کرتے ہیں۔ SKILL.md کلاؤڈ ڈیسک ٹاپ یا کلاڈ API جیسے سخت توثیق کے راستوں پر اضافی فیلڈز استعمال کرنے سے توثیق ناکام ہو سکتی ہے۔

مندرجہ ذیل پر غور کریں:

--- 
name: deck-builder 
description: Build presentation outlines. argument-hint: Give me a topic for the deck. 
---

کلاڈ کوڈ قابل قبول ہے۔ argument-hint کلائنٹ کے لیے مخصوص ایکسٹینشنز کے ساتھ۔ ایک سخت توثیق کرنے والا فائل کو مسترد کر سکتا ہے۔ argument-hint یہ تفصیلات میں بیان کردہ چھ فیلڈز کا حصہ نہیں ہے۔

یہی وجہ ہے کہ خرابی اس طرح نظر آتی ہے:

Unexpected key(s) in SKILL.md frontmatter: argument-hint.
Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

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

کے لیے deck builderیہ خطرہ مول لینے کی کوئی وجہ نہیں ہے۔ یہ صرف چھ تصریح والے فیلڈز استعمال کرتا ہے جو کلاڈ کوڈ بغیر کسی ترمیم کے لوڈ ہوتا ہے۔ یہ ٹیکنالوجی کو مطابقت رکھتا ہے اور فارمیٹ کے پورٹیبل سب سیٹ کے مساوی رکھتا ہے۔ SKILL.md ہم آہنگ کلائنٹس کے درمیان منتقل کرنا آسان ہے۔

موجودہ فولڈر

اس سے آگےSKILL.mdتصریح تین اصولوں کی وضاحت کرتی ہے:

• scripts/: وہ کوڈ لکھیں جو ایجنٹ چلاتا ہے۔ آزاد، واضح غلطیاں، کوئی لٹکنے والا نہیں۔ جو ہمارے پاس ہے۔ validate_deck.py.

• references/: ایک دستاویز جسے ایجنٹ درخواست پر کھولتا ہے۔ ہر فائل کو تنگ رکھیں۔ جو ہمارے پاس ہے۔ narrative-patterns.md.

• assets/: ٹیمپلیٹس، اسکیما، تصاویر۔ deck-builder آپ کو ایک کی ضرورت نہیں ہے۔

دوسرے کلائنٹ اضافی ڈائریکٹریوں کو پہچان سکتے ہیں۔ مثال کے طور پر، Antigravity بھی مضامین لکھتا ہے۔ examples/ اور resources/. تاہم، یہ ڈائریکٹریز کنونشنز ہیں، تکنیکی شکل کی مقررہ ضروریات نہیں۔

واقعی اہم بات یہ ہے کہ کیسے SKILL.md اس فائل کی طرف اشارہ کرتا ہے۔ ایجنٹ صارف کے متعین رشتہ دار راستوں کی پیروی کرتے ہیں، جس سے آپ کو آپ کی ٹیکنالوجی کے کام کرنے کے طریقے کی بنیاد پر اپنے معاون مواد کو ترتیب دینے کی اجازت ملتی ہے۔ برقرار رکھنا scripts/، references/، assets/متبادل طور پر، آپ واضح طور پر کلائنٹ کے لیے مخصوص ڈائریکٹری کا حوالہ دے سکتے ہیں جہاں بھی یہ معنی رکھتا ہے۔ SKILL.md.

کنونشن اب بھی انسانوں کو اہم فوائد پیش کرتا ہے۔ جب کوئی ایسی ٹیکنالوجی کھولتا ہے جسے آپ نے نہیں لکھا، تو ایک دوستانہ ڈائرکٹری فوراً اسے بتاتی ہے کہ قابل عمل کوڈ، حوالہ مواد، مثالیں، یا دیگر امدادی وسائل کہاں سے تلاش کرنا ہے۔

اپنی فائل کی طرف اشارہ کریں۔

ہمیشہ مہارت کی جڑ سے متعلق راستے استعمال کریں، مطلق راستے نہیں۔

See [the narrative patterns guide](references/narrative-patterns.md) when the instructions are unclear.

Check the outline before writing slides:

    python3 scripts/validate_deck.py --file outline.md

حوالہ جات کو ایک سطح پر رکھیں۔ ایک فائل جو کسی فائل کی طرف اشارہ کرتی ہے جو زیادہ فائلوں کی طرف اشارہ کرتی ہے ایجنٹ اس پر عمل کرنے کے بجائے اپنی تلاش کو ری ڈائریکٹ کرنے کا سبب بنے گی۔ اور /Users/you/dev/skills/... جس لمحے ٹیم کا ممبر ریپوزٹری کو کلون کرتا ہے، یہ رک جاتا ہے۔

کلائنٹ کے لیے مخصوص بہتری:

کلاڈ کی ہڈی کی تبدیلی ${CLAUDE_SKILL_DIR}ایک فولڈر پر مشتمل ہے۔SKILL.mdدونوں جسم میں اور باش اصول میں allowed-tools. اسے دونوں جگہوں پر استعمال کرنے سے ہنر کو اجازت کے پرامپٹ کے بغیر اپنی بنڈل اسکرپٹس چلانے کی اجازت ملتی ہے۔ یہ کلاڈ کوڈ کی توسیع ہے، لہذا پورٹیبل ٹیکنالوجیز کے لیے باقاعدہ متعلقہ راستے رکھیں۔

ارتکاب کرنے سے پہلے چیک کریں۔

حوالہ لائبریری جو معیاری چیک کے ساتھ آتی ہے عنوانات اور ناموں کو چیک کرتی ہے۔

skills-ref validate ./deck-builder

CI پر تصدیق کنندہ کو چلانے سے رن ٹائم تک پہنچنے سے پہلے ہی بری تکنیک پکڑ لی جاتی ہے۔

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

10 منٹ میں ورژن 1 بنائیں

سب سے پہلے، صحیح فولڈر کو منتخب کریں

چشمی آپ کو بتاتی ہے کہ کیا ہو رہا ہے۔ اندر ٹیکنالوجی ہاں ~ نہیں کلائنٹ مختلف ہوتا ہے جب آپ اسے بتاتے ہیں کہ فولڈر کہاں ہے۔ یہ غلط ہونا سب سے عام وجہ ہے کہ آپ کی پہلی مہارت کیوں نہیں چلے گی، لہذا اسے چلانے سے پہلے چیک کریں۔ mkdir.

گاہک	منصوبے کی گنجائش	ذاتی دائرہ کار
کلاڈ کوڈ	.claude/skills/	~/.claude/skills/
VS کوڈ/کوپائلٹ	.github/skills/، .claude/skills/، .agents/skills/	~/.copilot/skills/، ~/.claude/skills/، ~/.agents/skills/
گوگل مخالف کشش ثقل	.agents/skills/	~/.gemini/config/skills/

.agents/skills/ ابھرتے ہوئے کلائنٹ سے کلائنٹ کے اصول۔ کلاڈ کوڈ ایک بڑی استثناء ہے۔ دستاویز کا نام۔ .claude/skills/ اور ~/.claude/skills/اور درج نہیں۔ .agents/skills/ کوئی بھی

اوورلیپ مفید حصہ ہے۔ VS کوڈ اسکین .claude/skills/ بھیلہذا، ایک فولڈر دونوں سب سے عام کلائنٹس کو مطمئن کرتا ہے۔ اس لیے یہ گائیڈ بطور ڈیفالٹ سیٹ ہے۔

# Claude Code, and VS Code / Copilot, which both scan this location
SKILLS_DIR=.claude/skills

# Antigravity, or VS Code if you prefer the cross-client convention
# SKILLS_DIR=.agents/skills

mkdir -p "$SKILLS_DIR/deck-builder"

پھر فائل بنائیں:

بنانا deck-builder/SKILL.md:

---
name: deck-builder
description: Helps make presentations.
---

# Deck Builder

Never start writing slides immediately. Decide what the deck is for first.

## Workflow

### Step 1: Brainstorm

Before any slide exists, write a `## Brainstorm` block answering three questions:

- **Audience.** Who is in the room, how long do you have, what do they
  already know, and what decision do they need to make?
- **Core message.** One sentence. If the audience remembers nothing else,
  what is it?
- **Arc.** How the deck moves from opening to ask.

If the request does not give you enough to answer these, ask the user
before continuing. Do not guess the audience.

### Step 2: Write slides

One idea per slide. Six bullets maximum. End on the ask, never on a
body slide.

یہ ایک مکمل کام کی تفصیل ہے۔ ایک فائل میں 28 لائنیں ہیں جن میں کوئی انحصار نہیں ہے۔

اس کے بارے میں تین چیزیں آپ کی تعمیر کردہ کسی بھی چیز کو عام کرتی ہیں۔

• پس منظر کو چھوڑیں۔ سلائیڈ کیا ہے اس کی کوئی وضاحت نہیں ہے۔ ایجنٹ جانتے ہیں۔

• آپ قواعد چیک کر سکتے ہیں۔ "6 گولیوں تک” کو دیکھ کر تصدیق کی جا سکتی ہے۔ "پریزنٹیشن کے بہترین طریقوں پر عمل کرنا” ناممکن ہے۔

• تفصیل جان بوجھ کر غلط ہے۔ Helps make presentations. یہ ایک مبہم خلاصہ ہے جو کام نہیں کرتا ہے۔ یہ ورژن 2 ہے جو اسے ٹھیک کرتا ہے۔

VS کوڈ یا کلاڈ کوڈ سے چلائیں۔

فائل موجود ہے۔ اب یقینی بنائیں کہ آپ کے صارفین اسے دیکھ سکتے ہیں۔

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

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

دونوں کلائنٹ مہارت کو چلانے اور مختلف چیزوں کو جانچنے کے دو طریقے پیش کرتے ہیں۔

• انہیں نام سے پکاریں۔ وضاحت کو چھوڑیں اور اس کی جانچ کریں۔ جسم.

• ایسے سوالات پوچھیں جو اسے متحرک کریں گے۔اس کا نام لیے بغیر۔ یہ ہے وضاحت.

دونوں راستوں کی جانچ کریں۔ واضح کال یہ تصدیق کرتا ہے کہ مہارت خود درست ہے اور اس کی ہدایات پر عمل کیا جا رہا ہے۔ خودکار ٹرگرنگ ٹیسٹ کریں کہ نہیں؟ description ایجنٹوں کے لیے یہ کافی مخصوص ہے کہ وہ پہچان لیں کہ مہارت کا اطلاق کب ہوتا ہے۔

یہ فرق ڈیبگنگ کو بہت آسان بنا دیتا ہے۔ اگر واضح کال کام کرتی ہے لیکن خودکار ٹرگر ناکام ہوجاتا ہے، تو مہارت کا جسم اپنا کام کر رہا ہے اور مسئلہ تفصیل کا ہے۔ یہ آپ کی حرکت کا اشارہ ہے۔ ورژن 2 محرک منطق کو ایڈجسٹ کریں۔

کلاڈ کے کوڈ سے:

1. جب آپ کلاڈ کوڈ کو دوبارہ شروع کرتے ہیں، تو یہ نئے فولڈرز کو تلاش کرے گا۔ موجودہ ٹکنالوجی فولڈرز میں ترامیم کو حقیقی وقت میں اٹھایا جائے گا، لیکن جو فولڈرز سیشن شروع ہونے پر موجود نہیں تھے انہیں دوبارہ شروع کرنے کی ضرورت ہوگی۔

2. زمرہ /skills چیک کریں اور deck-builder یہ درج ہے۔

3. براہ راست کال /deck-builder یا یہاں تک کہ اگر آپ پریزنٹیشن بنانے کا ذکر کرتے ہیں، تو اس کا خود بخود پتہ چل جائے گا۔ /deck-builder تکنیکی ہدایات کے بعد ورک فلو پر عمل درآمد شروع کریں۔

4. نئے سیشن میں ٹیسٹ ٹرگرنگ۔ مہارت کا نام لیے بغیر سوال پوچھیں۔

   کیا آپ تیسری سہ ماہی کی منتقلی کے حوالے سے جمعرات کی بورڈ میٹنگ کے لیے کچھ تیار کر سکتے ہیں؟

کمانڈ کا نام ہے۔ فولڈر ہیڈر، نام نہیں name. جب آپ فولڈر کا نام تبدیل کرتے ہیں تو کمانڈ بدل جاتی ہے۔ کیونکہ کلاڈ کوڈ نے حسب ضرورت کمانڈز کو بھی مہارت میں ضم کر دیا۔ .claude/commands/deploy.md اور .claude/skills/deploy/SKILL.md دونوں کی پیداوار /deploy.

وی ایس کوڈ میں

1. GitHub Copilot انسٹال کے ساتھ ایک پروجیکٹ کھولیں۔

2. Copilot چیٹ پینل کھولیں۔ ایجنٹ سکلز کوئیک سٹارٹ تجویز کرتا ہے کہ آپ منتخب کریں: نائب موڈ ڈراپ ڈاؤن میں موڈ جس میں ایجنٹ ٹرمینل کمانڈ چلا سکتا ہے۔ VS کوڈ کی اپنی تکنیکی دستاویزات کسی بھی جدید تقاضوں کی وضاحت نہیں کرتی ہیں، لہذا اگر مہارت کسی دوسرے موڈ میں ظاہر نہیں ہوتی ہے، تو یہ فرض کرنے سے پہلے کہ فائل خراب ہے۔

3. زمرہ / دستیاب مہارتوں اور اشارے کی فہرست بنائیں۔ پرامپٹ فائل کے ساتھ سلیش کمانڈز کے ذریعہ تکنیکوں کی نشاندہی کی جاتی ہے۔ /skills کھولیں۔ تکنیکی ترتیب مینو آپ چیک کر سکتے ہیں۔ deck-builder آپ کو اٹھا لیا گیا ہے۔

4. براہ کرم سے منتخب کریں۔ / اسے چلانے کے لیے فہرست پر کلک کریں۔ آپ اس طرح سیاق و سباق شامل کر سکتے ہیں: /deck-builder for the board meeting.

5. ایسے سوالات پوچھیں جن کا ایک ہی ہدف نہ ہو۔

کیونکہ وی ایس کوڈ بھی اسکین کرتا ہے۔.claude/skills/آپ وہی مواد دوبارہ استعمال کر سکتے ہیں۔ deck builder ڈائریکٹری اپنی ساخت کو تبدیل کیے بغیر موجود ہے۔ جب آپ کو Claude Code اور VS Code میں ایک ہی ٹیکنالوجی استعمال کرنے کی ضرورت ہو تو یہ ایک آسان مشترکہ مقام فراہم کرتا ہے۔

اگر آپ VS کوڈ کے اپنے اصولوں پر عمل کرنا چاہتے ہیں تو نیچے تکنیک کو رکھیں۔ .github/skills/ اس کے بجائے. اہم حصہ کسی ایک عالمگیر فولڈر کا انتخاب نہیں کر رہا ہے۔ اس ٹیکنالوجی کو رکھیں جہاں آپ کے ٹارگٹ کلائنٹس درحقیقت دیکھ رہے ہوں اور ٹیکنالوجی کو ڈیبگ کرنے سے پہلے دریافت کی تصدیق کریں۔

کامیابی کیسی نظر آتی ہے۔

ٹیکنالوجی کے بغیر، ماڈل عام طور پر سلائیڈ 1 کے ساتھ کھلتا ہے۔

Slide 1: Q3 Migration Overview
Slide 2: Goals
Slide 3: Timeline
Slide 4: Challenges
Slide 5: Results
Slide 6: Thank You

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

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

یہی توقف ہی اصل اجر ہے۔ ورژن 1. سلائیڈز بنانے کے لیے جلدی کرنے کے بجائے، ایجنٹ ایسے خیالات کو قائم کرنے کے لیے ایک لمحہ نکالتے ہیں جو ڈیک کی رہنمائی کریں گے۔

جب یہ کام نہیں کرتا

علامت	ممکنہ وجہ	ٹھیک کریں
ہنر غائب ہے۔ /skills	فولڈر اس جگہ پر ہے جسے یہ کلائنٹ اسکین نہیں کرتا، یا سیشن فولڈر سے پرانا ہے۔	براہ کرم روٹ ٹیبل کو دوبارہ چیک کریں اور دوبارہ شروع کریں۔
اگرچہ یہ درج ہے۔ /deck-builder نہیں ملا	کمانڈز فولڈر کے نام سے آتے ہیں۔	فولڈر کا نام تبدیل کریں: deck-builder
کال کام کرتی ہے، لیکن ٹرگر نہیں کرتا۔	تفصیل بہت تنگ ہے۔ ورژن 1 میں متوقع	ورژن 2 کے ساتھ جاری رکھیں
ہنر بوجھ پڑتا ہے، لیکن ایجنٹ بہرحال سلائیڈز بناتا ہے۔	ہدایات پر عمل کرنے کا طریقہ آپ کے ماڈل کے لحاظ سے مختلف ہوتا ہے۔	مہارت میں ترمیم کرنے سے پہلے ایک مختلف ماڈل استعمال کرنے کی کوشش کریں۔
غیر متوقع اونچائی کی وجہ سے جسم کو مسترد کر دیا گیا۔	سخت راستوں میں کلائنٹ کے لیے مخصوص فیلڈز	تفصیلات میں 6 فیلڈز تک محدود

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

ورژن 2: ہر بار ٹرگر کرنے کے لیے سیٹ کریں۔

ایک ہنر جو کبھی فائر نہیں کرتا بے کار ہے۔ کہ description میں اس کا سارا بوجھ اٹھاتا ہوں۔ یہ ٹیکنالوجی کا واحد حصہ ہے جسے ایجنٹ فیصلہ کرنے سے پہلے دیکھتے ہیں۔

ورژن 1 کہتا ہے۔ Helps make presentations. "لفظ آگ پکڑتا ہے۔پیشکش’’اور چپ رہو۔‘‘جمعرات کو ایک ساتھ کچھ حاصل کریں۔"لوگ دراصل پوچھتے ہیں۔

4 اصول

• براہ کرم ہدایات کے طور پر لکھیں۔ "اس مہارت کو استعمال کرتے وقت…” "یہ مہارت ہے…” سے بڑا ہے ایجنٹ فیصلہ کرتا ہے، اس لیے فیصلے سے آگاہ کریں۔

• ارادے کی تفصیل: ایجنٹ صارف کی درخواست سے میل کھاتا ہے، فن تعمیر سے نہیں۔

• تھوڑا سا دباؤ بنو۔ ان حالات کو نام دیں جن پر یہ لاگو ہوتا ہے، بشمول وہ حالات جہاں صارف آپ کے الفاظ سے گریز کرتے ہیں۔

• چھت کا مشاہدہ کریں: 1024 حروف ایک سخت حد ہے اور مفاہمت کے دوران تفصیل بڑھ جائے گی۔

مہارت کی وضاحتوں کو ایڈجسٹ کرتے وقت، ایک باریکی کو یاد کرنا آسان ہے۔ تمام درخواستوں کو مہارت کی ضرورت نہیں ہے۔. ایجنٹ اس وقت ٹیکنالوجی سے رجوع کرتے ہیں جب کسی کام میں متعدد مراحل، ڈومین کے لیے مخصوص فیصلے، یا ایسے طریقہ کار شامل ہوتے ہیں جنہیں خود اعتمادی سے دوبارہ پیش کرنا مشکل ہوتا ہے۔

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

اندازوں کے بجائے ٹیسٹ کو متحرک کریں۔

آپ اس کی پیمائش کر سکتے ہیں۔ تقریباً 20 حقیقت پسندانہ اشارے بنائیں جو اس بات کی نشاندہی کریں کہ آیا نہیں۔ ضروری ہے مہارت کی فائرنگ: 8-10 مثبت، 8-10 منفی۔ اگلی بار کے لیے محفوظ کریں۔ evals/trigger_queries.json.

[
  {
    "query": "can you put something together for thursday's board meeting on the q3 migration",
    "should_trigger": true
  },
  {
    "query": "I need to walk the new hires through how our deploy pipeline works, 20 mins",
    "should_trigger": true
  },
  {
    "query": "make the font bigger on slide 4 of this pptx",
    "should_trigger": false
  },
  {
    "query": "write me a one-page summary of the q3 migration for the wiki",
    "should_trigger": false
  }
]

ایک قابل قدر مثبت یہ ہے کہ ٹیکنالوجی مدد کرتی ہے، لیکن نقل نہیں کرتی۔ پہلی مثال میں، آپ یہ نہیں کہتے ہیں "ڈیک"”سلائیڈ"یا”پیشکشاگر پرامپٹ پہلے ہی پوچھتا ہے کہ مہارت کیا کرتی ہے، تو تمام وضاحتیں گزر جاتی ہیں اور آپ کچھ نہیں سیکھتے۔

سب سے قیمتی آواز کے ٹیسٹ یہ ہیں: ایک قریبی کال: ایک پرامپٹ جس میں مہارت کے طور پر ایک ہی الفاظ شامل ہیں لیکن درحقیقت مختلف اعمال کی ضرورت ہوتی ہے۔ "فبونیکی فنکشن لکھنا"یہ آپ کو تقریبا کچھ نہیں بتاتا ہے کیونکہ پریزنٹیشن کے کام کے ساتھ کوئی اوورلیپ نہیں ہے۔”سلائیڈ 4 پر فونٹ کو بڑا بنائیں۔” بہت زیادہ مفید ہے کیونکہ اس میں واضح طور پر سلائیڈز کا ذکر ہے، لیکن آپ کا کام موجودہ سلائیڈوں میں ترمیم کرنا ہے، نہ کہ ڈیک ڈیزائن کرنا۔

وکی کے خلاصے ایک اور مضبوط باؤنڈری کیس ہیں۔ یہ تقریبا ایک ہی منتقلی ہو سکتا ہے، لیکن صارفین تحریری دستاویزات طلب کر رہے ہیں، پیشکش نہیں. یہ قریب کی یادیں آپ کو بتاتی ہیں کہ آپ وضاحت کو سمجھتے ہیں یا نہیں۔ درخواست کا ارادہصرف مانوس الفاظ کو ملانے کے بجائے۔

ماڈل کا رویہ رن سے رن مختلف ہوتا ہے، لہذا ہر سوال کو تین بار چلائیں۔ ٹرگر رفتار. مثبت نمبر 0.5 سے اوپر گزرتے ہیں، منفی نمبر نیچے سے گزرتے ہیں۔

ضرورت سے زیادہ فٹ نہ ہوں۔

آپ کے لکھے ہوئے ہر استفسار کے لیے ٹیوننگ کے نتیجے میں ایک ایسی تفصیل سامنے آئے گی جو اس جملے کے لیے کام کرتی ہے اور حقیقی صارفین کے لیے ناکام ہوتی ہے۔

سیٹ تقسیم کریں: تقریباً 60% تربیت، 40% توثیق، بالترتیب متناسب مثبت اور منفی کے ساتھ۔ اپنی ترمیم کی رہنمائی کے لیے ٹرین کی ناکامیوں کا استعمال کریں۔ توثیق کا استعمال صرف اس بات کو یقینی بنانے کے لیے کریں کہ آپ کی ترامیم عام ہیں۔

1. دونوں سیٹوں کا اندازہ لگائیں۔

2. ٹرین کی خرابی تلاش کریں۔ محرکات غائب ہونے کا مطلب ہے کہ یہ بہت تنگ ہے۔ خراب ٹرگر کا مطلب ہے کہ یہ بہت وسیع ہے۔

3. سمت میں درست عام زمرہ ایک ناکامی ظاہر ہوتی ہے۔ ناکام استفسار سے مطلوبہ الفاظ کو پیسٹ نہ کریں۔ یہ اوور فٹنگ ہے۔

4. دہرائیں۔ عام طور پر 5 بار سے زیادہ نہیں۔

5. بہترین تکرار کا انتخاب کریں۔ چیک کریں تناسب یہ اکثر آخری نہیں ہوتا ہے۔

نتیجہ

# Version 1 — fires on the word "presentation" and little else
description: Helps make presentations.

# Version 2 — tuned against 20 labelled queries
description: >-
  Turn a request for a presentation into a slide outline. Brainstorm the
  audience, core message, and narrative arc first, then write slides. Use
  when someone asks for a deck, slides, a presentation, a readout, a board
  update, or a talk, including when they only say "put something together
  for Thursday" without naming a format. Not for editing existing slide
  files or for writing prose documents.

دو تبدیلیاں کی گئی ہیں: ذہن سازی کے بعد، ہم نے اپنے تعمیراتی طریقہ کار کا نام دیا کہ وہ کیا کرتے ہیں اس کے بارے میں زیادہ مخصوص ہوں، اور ایسی درخواستوں پر توجہ دے کر جو "نہیں کہتے ہیں”، ہم نے اپنی درخواست کا دائرہ وسیع کیا۔ڈیک"

آخری جملہ وہ حصہ ہے جسے زیادہ تر لوگ چھوڑ دیتے ہیں۔ ایک مہارت کیا ہے ~ نہیں یہ غلط محرکات کی وجہ سے قریبی کالوں سے بچنے کا ایک طریقہ ہے۔

ورژن 3: ایک ایسی تنظیم بنائیں جو ٹوکن حاصل کرے۔

جب کوئی ہنر فعال ہو جاتا ہے، تو آپ کا پورا جسم مکالمے، نظام کے سیاق و سباق اور دیگر تمام فعال مہارتوں کے ساتھ توجہ کے لیے مقابلہ کرتا ہے۔ اسے بجٹ پر کریں۔

حقیقی مہارت کے ساتھ شروع کریں۔

تکنیکی تحریر میں سب سے عام ناکامی LLMs کو بغیر کسی ڈومین ان پٹ کے تکنیکی تفصیل لکھنے کو کہتے ہیں۔ واپسی روانی اور بیکار ہے: "اپنے سامعین پر غور کریں۔"”اپنی سلائیڈوں کو صاف رکھیں"

موثر ٹیکنالوجی اس سے آتی ہے جو پہلے سے موجود ہے۔ ایک ڈیک منتخب کریں جس کی آپ کی ٹیم نے حقیقت میں تعریف کی ہو، اور لکھیں کہ اس نے کیوں کام کیا۔ جائزہ تبصرے پر ایک نظر ڈالیں جہاں کسی نے کہا:یہ ایک ڈیک نہیں ہے، یہ تین ڈیک ہے۔اس کے نتیجے میں پڑھنا کٹا ہوا ہے کیونکہ سلائیڈ 2 نے جگہ کھو دی ہے۔

کے لیے deck-builderخام مال وہ رائے ہے جو آپ پہلے ہی اپنے مسودے پر لوگوں کو دے چکے ہیں۔

جو ایجنٹ پہلے سے جانتے ہیں اسے کاٹ دیں۔

ہر لائن کے بارے میں پوچھیں۔ ورنہ کیا ایجنٹ اس معاملے کو غلط سمجھیں گے؟ اگر نہیں، تو اسے کاٹ دو.

## Slide design

A slide is a single screen in a presentation. Slides should be visually
clear and not too crowded. Audiences find it hard to read a lot of text
on a screen, so you should use bullet points to summarize your ideas.


## Slide design

One idea per slide. Six bullets maximum, each under 120 characters.
Anything longer belongs in speaker notes, not on the slide.

ایک مستقل کام کا دائرہ اختیار کریں۔

دائرہ کار بہت تنگ ہے اور ایک کام میں چار مہارتیں شامل ہوتی ہیں۔ تفصیل کو درست طریقے سے انجام دینے کے لیے دائرہ کار بہت وسیع ہے۔

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

ایک کام کتنا نازک ہے اس سے جڑیں کہ آپ اسے کتنی مضبوطی سے ہدایت کرتے ہیں۔

کمرہ چھوڑ دو یہ وہ جگہ ہے جہاں متعدد نقطہ نظر کھیل میں آتے ہیں۔ وضاحت کریں کیوں وہ ایجنٹ جو مقصد کو سمجھتے ہیں سخت احکامات کو بہتر بناتے ہیں کیونکہ وہ اچھی طرح سے موافقت کرتے ہیں۔

## Choosing an arc

Pick the arc that matches what the audience needs to do:

- They must decide something: Situation, Complication, Resolution
- They are skeptical: lead with the objection, then dismantle it
- They need to learn: chronological, simplest case first
- They already agreed: skip persuasion, go straight to the plan

معیاری ہونا چاہیے۔ جب آرڈر اہمیت رکھتا ہے:

## Order of operations

Do these in order. Do not write slides before the brainstorm exists.

1. Write the `## Brainstorm` block
2. Run `python3 scripts/validate_deck.py --file outline.md`
3. Write slides only after it exits 0

زیادہ تر ٹیکنالوجی دونوں کی ضرورت ہوتی ہے۔ سیکشن کے لحاظ سے پروف ریڈ سیکشن۔

بنیادی اختیارات فراہم کیے گئے ہیں۔

پانچ اختیارات کی فہرست میں غور و فکر کی ضرورت ہے۔

You could use SCR, PAS, AIDA, the pyramid principle, the hero's journey...


Default to Situation, Complication, Resolution. It fits most internal
readouts. For a skeptical audience, lead with the objection instead.

چار نمونے جو زیادہ تر کام کرتے ہیں۔

غلط مثبت

یہ زیادہ تر ٹیکنالوجیز کے لیے سب سے قیمتی سیکشن ہے۔ اگرچہ مشورہ نہیں ہے، یہاں کچھ غلطیاں ہیں جو ایجنٹ کرتے ہیں:

## False Positives

- "Put something together" is not a brief. It gives you no audience and
  no decision. Ask before you build; do not invent an audience.
- A deck for a 15-minute slot is not a shorter version of the 45-minute
  deck. Fewer slides with the same message, not the same slides compressed.
- If the core message needs an "and" to state it, it is two decks. Split
  it or pick one.
- Our leadership readouts open with the ask, not the background. Reverse
  the arc for anyone above director level.

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

جھوٹے مثبت کو زندہ رکھیں۔ SKILL.mdیہ ریفرنس فائل نہیں ہے۔ مجھے ایک مشیر کی ضرورت ہے۔ پہلے آپ ایسی صورت حال سے دوچار ہوتے ہیں جہاں آپ یہ نہیں جان سکتے کہ ایسی فائل کو کیسے کھولا جائے جو کسی ایسے جال کو بیان کرتی ہو جو موجود ہی نہیں ہے۔

جب بھی آپ کام کرتے ہوئے کسی ایجنٹ میں ترمیم کرتے ہیں، وہ ترامیم یہاں ہوتی ہیں۔

ٹیمپلیٹ

اگر آؤٹ پٹ کی شکل اہم ہے تو شکل کی نشاندہی کریں۔ ایجنٹ ڈھانچے پر پیٹرن کے ملاپ میں اس سے کہیں بہتر ہیں کہ وہ ڈھانچے پر نثر کی پیروی کرتے ہیں۔

## Outline format

Produce exactly this structure:

```markdown
# Deck: 

چیک لسٹ

ایک واضح ترقی کی فہرست قدموں کو چھوڑنا بند کر دیتی ہے۔

## Progress

- [ ] 1. Brainstorm block written
- [ ] 2. Missing audience info asked about, not invented
- [ ] 3. `validate_deck.py` exits 0
- [ ] 4. Slides written
- [ ] 5. Validator re-run on the finished outline

توثیقی لوپ

ایجنٹوں کو ہدایت دیں کہ وہ خود اپنے اعمال کو چیک کریں اور دہرائیں۔ یہ ایک بار کی تخلیق کو خود میں ترمیم کرنے کے عمل میں بدل دیتا ہے۔

## Validation loop

1. Write or edit the outline.
2. Run `python3 scripts/validate_deck.py --file outline.md`.
3. If it exits 1, read the rule ID and message, fix it, run again.
4. Only continue when it exits 0.

جب آپ کے جسم کو قانونی طور پر زیادہ ضرورت ہو۔

ہمارے جسم اب اپنی مفید حدود کے قریب ہیں۔ کام شدہ مثالوں کے ساتھ بیانیہ آرکس کا ایک مکمل کیٹلاگ 500 لائنوں سے زیادہ ہوگا۔

یہ جاتا ہے references/یہ ہے ورژن 5. اصول: ایجنٹ سے بات کریں۔ جب ہر فائل کو کھولنے کے لیے، "پڑھیں” پر کلک کریں references/narrative-patterns.md یہ تب ممکن ہے جب سامعین کو شک ہو یا پلاٹ واضح نہ ہو۔ ‘تفصیلات کے لیے دیکھیں/دیکھیں’ قابل عمل نہیں ہے۔

ورژن 4: آپ کے کام کو چیک کرنے کے لیے اسکرپٹس کا ایک گروپ۔

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

ہماری ٹیکنالوجی پہلے ہی ایجنٹوں کو آؤٹ لائن کی توثیق کرنے کے لیے کہہ رہی ہے۔ اب ہم اس کمانڈ کو درست کرنے کے لیے ایک ٹھوس طریقہ کار فراہم کرتے ہیں۔ تمام اصول یاد رکھنے کے لیے ایجنٹ پر بھروسہ کرنے کے بجائے، validate_deck.py جائزہ چیک کریں اور واضح پاس یا فیل سگنل واپس کریں۔ پھر”براہ کرم اپنا کام چیک کریں۔تجاویز کو قابل پیمائش اور قابل تکرار میں تبدیل کرنا

انحصار ان لائن اعلامیہ

بنڈل شدہ اسکرپٹ کو اپنی انحصار کا اعلان کرنا چاہیے تاکہ ایجنٹ کو بغیر کسی تنصیب کے مراحل کے ایک واحد کمانڈ کے طور پر چلایا جا سکے۔ Python میں، PEP 723 مندرجہ ذیل کام کرتا ہے:

# /// script
# requires-python = ">=3.9"
# dependencies = []
# ///

uv run scripts/validate_deck.py پھر الگ تھلگ ماحول بنائیں اور چلائیں۔ چونکہ ہم صرف معیاری لائبریری استعمال کرتے ہیں، اس لیے فہرست خالی اور سادہ ہے۔ python3 فیکٹری

یہ کاپی کرنے کے قابل ڈیزائن انتخاب ہے۔ انحصار سے پاک توثیق کار 3 سال بعد بھی بند CI کنٹینرز میں کام کرتے رہیں گے۔

ایجنٹوں کے لیے ڈیزائن

ایجنٹ یہ فیصلہ کرنے کے لیے stdout اور stderr پڑھتا ہے کہ آگے کیا کرنا ہے۔ چھ انتخاب آپ کی کامیابی کا تعین کریں گے۔

• پیغامات کو متعامل طور پر ظاہر نہ کریں۔ سخت تقاضے ایجنٹ ایک غیر انٹرایکٹو شیل میں چلتا ہے اور TTY پرامپٹس کا جواب نہیں دے سکتا۔ اسکرپٹ جو ان پٹ کو روکتی ہیں ختم ہونے تک ہینگ رہیں گی۔

• دستاویز کے ذریعے --help: وہ آؤٹ پٹ یہ ہے کہ ایجنٹ انٹرفیس کیسے سیکھتا ہے۔ مقصد، جھنڈے، ایگزٹ کوڈ۔ اسے مختصر رکھیں۔ یہ سیاق و سباق کی ونڈو میں ظاہر ہوتا ہے۔

• تصحیح تجویز کرنے میں غلطی لکھیں۔ Error: invalid input یہ ایک بار خرچ ہوتا ہے۔ قاعدے کے لیے نام اور ریزولیوشن بتانے کی کوئی قیمت نہیں ہے۔

• تشکیل شدہ آؤٹ پٹ بھیجیں۔ stdout پر JSON، stderr پر تشخیص۔

• بے حسی ہونی چاہیے۔ ایجنٹ دوبارہ کوشش کرے گا۔ جامد چیکر واضح طور پر دوبارہ چلانے کے لیے محفوظ ہے۔

• آؤٹ پٹ کو باندھیں۔ بہت سے ہارنیس ٹول آؤٹ پٹ کو تراشتے ہیں جو تقریباً 10 سے 30,000 حروف سے زیادہ ہوتا ہے، خود بخود اہم حصوں کو حذف کر دیتا ہے۔ پوری فائل کے بجائے نتائج کی رپورٹ کرتا ہے۔

توثیق کرنے والا

بنانا deck-builder/scripts/validate_deck.py:

#!/usr/bin/env python3
"""Static checker for deck outlines produced by the deck-builder skill.

Checks that an outline brainstormed before it built, and that no slide is
overloaded. Reads the outline file only; nothing is rendered or uploaded.

Usage:
  scripts/validate_deck.py --file outline.md
  scripts/validate_deck.py --file outline.md --format json

Exit codes:
  0  Outline passes every check.
  1  One or more problems found.
  2  The file could not be read.
"""

import argparse
import json
import re
import sys
from typing import Dict, List

MAX_BULLETS = 6
MAX_BULLET_CHARS = 120
MAX_TITLE_CHARS = 60
CLOSING_WORDS = ("next step", "call to action", "recap", "takeaway", "ask")


def parse(outline: str) -> List[Dict]:
    """Split the outline into slides. A slide starts at a '### ' heading."""
    slides, current = [], None
    for lineno, line in enumerate(outline.split("n"), 1):
        heading = re.match(r"^###s+(.*S)s*$", line)
        if heading:
            current = {"title": heading.group(1), "line": lineno, "bullets": []}
            slides.append(current)
            continue
        bullet = re.match(r"^s*[-*]s+(.*S)s*$", line)
        if bullet and current is not None:
            current["bullets"].append({"text": bullet.group(1), "line": lineno})
    return slides


def analyze(path: str) -> List[Dict]:
    with open(path, "r", encoding="utf-8") as handle:
        outline = handle.read()

    findings: List[Dict] = []

    def add(rule, line, message, snippet=""):
        findings.append(
            {"rule": rule, "line": line, "message": message, "snippet": snippet}
        )

    if not re.search(r"^##s+Brainstorms*$", outline, re.M | re.I):
        add(
            "DECK001", 1,
            "No '## Brainstorm' section. The skill must think before it builds: "
            "record audience, core message, and arc before writing slides.",
        )

    slides = parse(outline)
    if not slides:
        add("DECK006", 1, "No slides found. Each slide is a '### ' heading.")

    for slide in slides:
        if len(slide["title"]) > MAX_TITLE_CHARS:
            add(
                "DECK004", slide["line"],
                f"Slide title is {len(slide['title'])} characters; keep it under "
                f"{MAX_TITLE_CHARS} so it fits one line at presentation size.",
                slide["title"][:70],
            )
        if len(slide["bullets"]) > MAX_BULLETS:
            add(
                "DECK002", slide["line"],
                f"Slide has {len(slide['bullets'])} bullets; split it. More than "
                f"{MAX_BULLETS} reads as a document, not a slide.",
                slide["title"][:70],
            )
        for bullet in slide["bullets"]:
            if len(bullet["text"]) > MAX_BULLET_CHARS:
                add(
                    "DECK003", bullet["line"],
                    f"Bullet is {len(bullet['text'])} characters. Tighten it to "
                    f"under {MAX_BULLET_CHARS} or move it to speaker notes.",
                    bullet["text"][:70],
                )

    if slides:
        tail = " ".join(
            [slides[-1]["title"]] + [b["text"] for b in slides[-1]["bullets"]]
        ).lower()
        if not any(word in tail for word in CLOSING_WORDS):
            add(
                "DECK005", slides[-1]["line"],
                "Last slide has no recap, takeaway, or next step. End on the ask, "
                "not on the final body slide.",
                slides[-1]["title"][:70],
            )

    return sorted(findings, key=lambda f: (f["line"], f["rule"]))


def main() -> int:
    parser = argparse.ArgumentParser(
        description="Check a deck outline for structure and slide density.",
        epilog="Exit codes: 0 clean, 1 findings, 2 unreadable file.",
    )
    parser.add_argument("--file", required=True, help="Path to the outline")
    parser.add_argument(
        "--format", choices=["text", "json"], default="text",
        help="Output format (default: text)",
    )
    args = parser.parse_args()

    try:
        findings = analyze(args.file)
    except OSError as exc:
        print(f"Error: could not read {args.file}: {exc}", file=sys.stderr)
        return 2

    if args.format == "json":
        json.dump({"file": args.file, "findings": findings}, sys.stdout, indent=2)
        sys.stdout.write("n")
    elif findings:
        for f in findings:
            print(f"{args.file}:{f['line']}: [{f['rule']}] {f['message']}")
            if f["snippet"]:
                print(f"    {f['snippet']}")
    else:
        print(f"{args.file}: outline passes all checks.")

    return 1 if findings else 0


if __name__ == "__main__":
    sys.exit(main())

chmod +x "$SKILLS_DIR/deck-builder/scripts/validate_deck.py"

تین تفصیلات جو اس توثیق کار کو بناتی ہیں۔ ایجنٹ دوستانہیہ صرف تکنیکی طور پر درست نہیں ہے۔

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

دوسرا، یہ میکانکی طور پر ٹیکنالوجی کے بنیادی ورک فلو کو نافذ کرتا ہے۔ ورژن 1 نے ایجنٹوں کو سلائیڈیں لکھنے سے پہلے سوچ بچار کرنے کو کہا، لیکن نثر میں، ہم نے اس ضرورت کو ایک تجویز میں تبدیل کر دیا۔

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

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

اس بارے میں واضح کریں کہ کون سے قواعد لازمی ہیں اور جو ٹیم کے کام کرنے کے ترجیحی طریقے کی عکاسی کرتے ہیں۔

تاروں سے جڑیں۔

اگلے میں شامل کریں۔ SKILL.md:

## Available scripts

- **`scripts/validate_deck.py`** — checks one outline. Exits 0 clean,
  1 on findings, 2 if the file cannot be read.

Run it after the brainstorm and again after writing slides:

```bash
python3 scripts/validate_deck.py --file outline.md
```

لوپ اب بند ہے. ایجنٹ مسودہ لکھتا ہے، اسکرپٹ کو اسکرین کیا جاتا ہے، ایجنٹ اس پر نظر ثانی کرتا ہے، اور سائیکل ایگزٹ کوڈ 0 کے ساتھ ختم ہوتا ہے۔

ورژن 5 گہرے مواد کو راستے سے ہٹا دیں۔

ہمارے SKILL.md ورک فلو، فارمیٹس، غلط مثبت، اور توثیق کرنے والوں کا احاطہ کرتا ہے۔ یہ جس چیز پر توجہ نہیں دیتا وہ بیانیہ نظریہ ہے، اور ایسا نہیں ہونا چاہیے۔ اس کی شاید 1 میں سے 5 ڈیکوں میں ضرورت ہوتی ہے، اور جب بھی آپ اسے چالو کرتے ہیں تو اس کی ادائیگی بالکل اسی قسم کی اضافی فضلہ ہے جسے روکنے کے لیے وہاں موجود ہے۔

بنانا deck-builder/references/narrative-patterns.md:

# Narrative Patterns

Pick the arc from what the audience must do, not from what feels natural
to write.

## Situation, Complication, Resolution

The default for internal readouts. Works when the audience needs to
approve or fund something.

- **Situation.** What everyone already agrees is true. Keep it short.
- **Complication.** What changed, or what broke. This is the slide that
  earns attention.
- **Resolution.** What you did or propose, and the ask.

Failure mode: spending four slides on Situation. If the audience lived
through it, one slide is enough.

## Objection first

For a skeptical audience, or a proposal that was rejected before.

Open with the strongest argument against you, stated fairly. Then
dismantle it. An audience that hears its own objection spoken aloud
stops rehearsing it and starts listening.

## Chronological

For teaching, onboarding, and post-incident reviews. Simplest case
first, then complications in the order they were discovered.

Failure mode: chronological order is rarely the persuasive order. Do
not reach for it just because it matches how the work happened.

## Ask first

For leadership above director level, and for any slot under 10 minutes.

State the decision on slide one. Then support it. If they say yes on
slide one, you have saved everyone twenty minutes, and the rest of the
deck becomes optional backup.

## Choosing quickly

| Audience state | Arc |
| :--- | :--- |
| Needs to decide | Situation, Complication, Resolution |
| Doubts you | Objection first |
| Needs to learn | Chronological |
| Already agrees | Ask first |
| Very senior, short slot | Ask first |

اب ایک مشروط پوائنٹر شامل کریں: SKILL.md:

Read [references/narrative-patterns.md](references/narrative-patterns.md)
when the audience is skeptical, when the slot is under 10 minutes, when
the audience is above director level, or when Situation-Complication-
Resolution does not obviously fit.

وہ جملہ سب کچھ ہے۔ چار نام کی شرائط وہ ہیں جن کو ایجنٹ پہچان سکتا ہے جب ہر حالت ہوتی ہے۔

اس کا موازنہ "تفصیلات کے لیے حوالہ جات دیکھیں” سے کریں، جو اس بارے میں کوئی اشارہ نہیں دیتا کہ فائل کب متعلقہ ہو جاتی ہے اور کب اسے نظر انداز کر دیا جاتا ہے۔

ہنر اب مکمل ہو گیا ہے۔

کہاں مہارتیں موجود ہیں اور ایجنٹ انہیں کیسے تلاش کرتے ہیں۔

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

کلائنٹ عام طور پر پروجیکٹ کے دائرہ کار اور صارف کے دائرہ کار کو تلاش کرتے ہیں۔ فولڈرز جو اس رینج کو آباد کرتے ہیں ان کی شاخیں مندرجہ ذیل ہیں:

گاہک	منصوبے کی گنجائش	صارف کی گنجائش	اسکین بھی کریں۔
کلاڈ کوڈ	.claude/skills/	~/.claude/skills/	گھوںسلا .claude/skills/ آپ کی ورکنگ ڈائرکٹری کے تحت۔ .claude/skills/ اندر کیا --add-dir ڈائریکٹری پلگ ان کی مہارتیں۔ /skills/. منظم ترتیبات کے ذریعے کارپوریٹ ڈائریکٹری۔
VS کوڈ/کوپائلٹ	.github/skills/، .claude/skills/، .agents/skills/	~/.copilot/skills/، ~/.claude/skills/، ~/.agents/skills/	تمام فولڈرز کے ذریعے شامل کیے گئے۔ chat.agentSkillsLocations
گوگل مخالف کشش ثقل	.agents/skills/	~/.gemini/config/skills/	میراث .agent/skills/

دو متضادات اس بات کا تعین کرتی ہیں کہ مہارت کہاں رکھی جاتی ہے۔

سب سے پہلے، کلاڈ کوڈ اسکین نہیں کرتا ہے۔ .agents/skills/. وہاں رکھی گئی مہارتیں کبھی ظاہر نہیں ہوں گی۔ اگر آپ کی پہلی مہارت متحرک نہیں ہوتی ہے اور آپ کلاڈ کوڈ استعمال کر رہے ہیں، تو تفصیل کو دوبارہ لکھنے سے پہلے اسے چیک کریں۔

دوسرا، VS کوڈ اسکین کریں۔ .claude/skills/ صرف یہی نہیں بلکہ اس کے اپنے اصول بھی شامل ہیں۔ مندرجہ بالا نکات کو یکجا کرتے ہوئے، .github/skills/ یہ وہ فولڈر ہے جسے دونوں بڑے کلائنٹس پڑھتے ہیں۔ پہنچ .agents/skills/ جب سامعین Antigravity میں ہوتے ہیں۔

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

پروجیکٹ یا ذاتی؟

کے لیے deck-builder انتخاب واضح ہے۔ لیڈرشپ ریڈنگ پر غلط مثبت جو سوالات کے ساتھ کھلتے ہیں ان کے بارے میں فیصلے ہیں: یہ گروپ یہ پروجیکٹ سے تعلق رکھتا ہے اور پرعزم ہے لہذا سب کو بغیر کسی سیٹ اپ کے یکساں اصول ملتے ہیں۔

وہ مہارتیں جو ٹیم کی پالیسیوں کے بجائے ذاتی ترجیحات کو انکوڈ کرتی ہیں ذاتی دائرہ کار میں آتی ہیں۔

نام کا تنازعہ: یہ مت سمجھو کہ کون سی مہارت جیت جائے گی۔

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

لہذا نام کے تنازعات نام کے مسائل سے زیادہ اہم ہیں۔ وہ رویے کے خطرات: غلط مہارت کو انجام دینے کے دوران کمانڈز بالکل توقع کے مطابق کام کر سکتے ہیں۔

ایجنٹ کی مہارت کلائنٹ کے نفاذ کے رہنما خطوط عام اصولوں کا خاکہ پیش کرتے ہیں: پروجیکٹ صارف کو اوور رائیڈ کرتا ہے۔ہم اندازہ لگاتے ہیں کہ ورژن کنٹرول میں رن بکس ٹیم کے فیصلوں کی نمائندگی کرتی ہیں۔

کلاڈ کوڈ اس کے برعکس دستاویز کرتا ہے۔

کاروبار افراد کو نئے سرے سے متعین کرتے ہیں، اور افراد منصوبوں کی نئی تعریف کرتے ہیں۔

تو آپ deck builder ٹیکنالوجی ~/.claude/skills/، اور پھر اس ذخیرے کو کلون کریں جس میں اسی نام کے ساتھ ایک اور مہارت موجود ہو۔ کلاڈ کوڈ میں، پرائیویسی جیت جاتی ہے، اس لیے جس ورژن پر آپ پہلے سے بھروسہ کرتے ہیں وہ چلتا رہے گا، بجائے اس کے کہ ریپوزٹری کاپی سے خود بخود تبدیل ہو جائے۔

یہ رویہ مفید ہے، لیکن آفاقی نہیں۔ جب کہ وسیع تر ایجنٹ کی مہارت کا اصول پروجیکٹ کی مہارتوں کو صارف کی مہارتوں سے زیادہ ترجیح دیتا ہے، کلاڈ کوڈ اس کے برعکس ترجیح کا استعمال کرتا ہے۔ یہ اس قسم کے اختلافات ہیں جو پورٹیبل ٹیکنالوجی کو غیر متوقع طور پر برتاؤ کرنے کا سبب بن سکتے ہیں۔

سب سے محفوظ طریقہ ہے۔ یہ مت سمجھو کہ کون سی ٹیکنالوجی جیت جائے گی۔. آپ جس کلائنٹ کو استعمال کر رہے ہیں اس کے لیے درج ترجیحی اصولوں کو چیک کریں۔ Claude Code مندرجہ ذیل پلگ ان ٹیکنالوجیز کے لیے واضح نام کی جگہیں بھی فراہم کرتا ہے: plugin-name:skill-nameآپ درج ذیل راستوں سے نیسٹڈ مونوریپو ٹیکنالوجیز کے درمیان فرق کر سکتے ہیں۔ apps/web:deploy.

نام دینے کے قابل اعتماد کی حدود

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

Claude Code آپ کے پروجیکٹ ٹیکنالوجی میں اعتماد کی ایک اہم حد شامل کرتا ہے۔ کی مہارت .claude/skills/ کلائنٹ کے دریافت کرنے سے پہلے اسے ورک اسپیس ٹرسٹ چیک پاس کرنا ہوگا۔ تاہم، یہ تحفظ دریافت کے بعد ختم ہو جاتا ہے۔ ٹرسٹ اس بات کا تعین کرتا ہے کہ آیا پہلے سے طلب کردہ مہارت کو استعمال کیا جا سکتا ہے، نہ کہ یہ کیا کر سکتا ہے۔

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

ٹیکنالوجی بمقابلہ قواعد بمقابلہ MCP بمقابلہ ہکس بمقابلہ پلگ ان

ٹیکنالوجی بہت سے لوگوں میں سے ایک عمارت ہے۔ ان میں سے صحیح انتخاب کرنا زیادہ تر تعمیراتی کام ہے۔

اصل زبان	مقصد	لوڈ ہو رہا ہے۔	کہاں deck-builder یہ ٹھیک ہے۔
حکمرانی (AGENTS.md)	ہمیشہ پابندیوں اور معیارات پر	ہمیشہ آن یا روٹ میچنگ	"تمام ریڈنگ ہیں docs/decks/"ایک اصول ہے۔ کس طرح یہ ایک بنانے کے بارے میں نہیں ہے۔
ٹیکنالوجی (SKILL.md)	ڈومین کے طریقہ کار اور رن بکس	بتدریج انکشاف	ہماری پوری ٹیکنالوجی
ایم سی پی سرور	براہ راست بیرونی ٹولز سے رابطے	فعال عمل	سرور جو Google Slides میں خاکہ پیش کرتا ہے۔
ہک	لائف سائیکل واقعات کے لیے شیل کمانڈز	واقعہ کے ذریعہ متحرک	چلائیں validate_deck.py جب بھی آپ اسے استعمال کرتے ہیں تو خود بخود docs/decks/
پلگ ان	بنڈل کے اوپر	دریافت ہونے پر جمع کیا گیا۔	ہنر، قواعد، اور ہکس ایک پیکج میں فراہم کیے گئے ہیں۔

ایک الجھا ہوا جوڑا ٹیک بمقابلہ MCP ہے۔ ہماری مثال ان کو واضح طور پر ممتاز کرتی ہے:

• MCP ایک خصوصیت ہے جو: اپنے ایجنٹوں کی مدد کریں۔ یہ فائل بنائیں، اس API کو کال کریں، اور اس سلائیڈ کو رینڈر کریں۔

• مہارت فیصلہ ہے: وہ فیصلے کرنے کے لیے حکمت عملی، احکامات اور چیک فراہم کرتے ہیں۔ کس طرح اور جب ہاتھ ہلانا پڑتا ہے۔

deck builder اپنے ورک فلو کے لیے فیصلے کی پرت کی وضاحت کریں۔ ایجنٹس پہلے ذہن سازی کرتے ہیں، اپنے سامعین اور اہم پیغامات کی شناخت کرتے ہیں، اور فیصلہ کرتے ہیں کہ ہر سلائیڈ کو چھ گولیوں کی حد کے اندر رہنا چاہیے۔

MCP سرور فعالیت کی مختلف پرتیں فراہم کرتے ہیں۔ اس کا مطلب ہے کہ ایجنٹوں کو وہ ٹولز دینا جن کی انہیں اپنی مکمل خاکہ کو حقیقی سلائیڈ ڈیک میں تبدیل کرنے کی ضرورت ہے۔

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

ہکس اور پلگ ان کلائنٹ کے لیے مخصوص ہیں۔

قواعد، MCP، اور تکنیک بڑے پیمانے پر پورٹیبل ہیں۔ ہکس اور پلگ ان نہیں کرتے ہیں۔ مینی فیسٹ مختلف جگہوں پر ہوتے ہیں اور ایونٹ کے سیٹ مختلف سائز کے ہوتے ہیں۔

	گوگل مخالف کشش ثقل	کلاڈ کوڈ
پلگ ان مینی فیسٹ	plugin.json پلگ ان روٹ میں	.claude-plugin/plugin.json
بنڈل ہنر	skills//SKILL.md	skills//SKILL.md
ہک ترتیب	hooks.json کو .agents/ یا ~/.gemini/config/	hooks/hooks.json پلگ ان روٹ یا ان لائن plugin.json
زندگی سائیکل کے واقعات	5: PreToolUse، PostToolUse، PreInvocation، PostInvocation، Stop	13 سال اور اس سے زیادہ عمر کے افراد شامل ہیں۔ SessionStart، UserPromptSubmit، PreToolUse، PostToolUse، PostToolUseFailure، PermissionRequest، PermissionDenied، Notification، SubagentStop، Stop، StopFailure، PreCompact، SessionEnd

ایک کے لیے بنائے گئے بنڈل دوسرے بنڈلوں کے ذریعے لوڈ نہیں کیے جائیں گے۔ ایک ہم آہنگی جاننے کے قابل ہے۔ کلاڈ کوڈ میں .claude-plugin/plugin.json اگر آپ اسے اپنی تکنیکی ڈائرکٹری کے اندر ایک فولڈر میں شامل کرتے ہیں، تو اسے اس طرح کے پلگ ان میں فروغ دیا جائے گا: @skills-dirآپ بغیر کسی تنصیب کے مراحل کے اپنی صلاحیتوں کو ایک بنڈل کے طور پر بڑھا سکتے ہیں۔

ذیل میں دی گئی مثال Antigravity کی ایک مثال ہے جیسا کہ antigravity.google/docs میں دستاویز کیا گیا ہے۔ کاپی کرنے سے پہلے اپنے کلائنٹ کو چیک کریں۔

{
  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
  "name": "presentation-suite",
  "description": "Deck brainstorming and outline validation for the platform team."
}

یہ ایک ہک ہے جو خود بخود تصدیق کنندہ کو چلاتا ہے تاکہ ایجنٹ مرحلہ 2 کو نہ بھول سکے۔

{
  "outline-validator": {
    "PostToolUse": [
      {
        "matcher": "run_command",
        "hooks": [
          {
            "type": "command",
            "command": "./scripts/validate-changed-outlines.sh",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

PreToolUse یہ حفاظت کے حوالے سے ایک دلچسپ نکتہ ہے۔ ہک stdin پر JSON وصول کرتا ہے اور stdout پر JSON واپس کرتا ہے۔ PreToolUse جواب میں decision کال شروع کرنے کے لیے فیلڈز: allow درآمد، deny بلاک ask "ہمیشہ اجازت دیں” کی ترتیب کا احترام کرتے ہوئے اشارہ کرتا ہے۔ force_ask پرامپٹ اس سے قطع نظر ظاہر ہوتا ہے۔ فیلڈ خودکار گارڈریلز کے پیچھے میکانزم ہے۔

ثابت کریں کہ ٹیکنالوجی اصل میں مدد کرتی ہے

آپ نے ٹیکنالوجی بنائی ہے۔ میں نے ایک بار پھر ایک بہتر خاکہ بنایا۔ یہ اکیلے ثبوت نہیں ہے کہ ٹیکنالوجی اصل میں ایجنٹوں کو بہتر بنا رہی ہے. ماڈل آؤٹ پٹ رن سے رن مختلف ہوتا ہے، اور جو چیز ایک رن میں بہتری نظر آتی ہے وہ محض شور ہو سکتی ہے۔

اس کی پیمائش بھی ورژن 2 سے مختلف ہے۔ سوال یہ ہے کہ: "کیا ضرورت کے وقت مہارت چالو ہوتی ہے؟” یہاں سوال یہ ہے۔ "ایک بار شروع ہونے کے بعد، کیا یہ واقعی نتائج کو بہتر بناتا ہے؟” ایک مہارت بالکل متحرک ہوسکتی ہے اور پھر بھی کوئی قیمت نہیں ڈال سکتی۔ قابل اعتماد طریقے سے ٹرگر کرنے میں ناکام رہتے ہوئے واضح طور پر کال کرنے پر یہ آؤٹ پٹ کو بھی بہتر بنا سکتا ہے۔ آپ کو دونوں کی پیمائش کرنے کی ضرورت ہے۔

ٹیسٹ کیس لکھیں۔

ہر کیس میں حقیقت پسندانہ اشارے، کامیابی کی وضاحت، اور اختیاری طور پر ایک ان پٹ فائل ہوتی ہے۔ اگلی بار کے لیے محفوظ کریں۔ evals/evals.json:

{
  "skill_name": "deck-builder",
  "evals": [
    {
      "id": 1,
      "prompt": "can you put something together for thursday's board meeting on the q3 migration",
      "expected_output": "A brainstorm block first, and a clarifying question about what the board needs to decide, before any slides exist.",
      "assertions": [
        "A '## Brainstorm' section appears before any slide",
        "The brainstorm names an audience, a core message, and an arc",
        "The agent asks what decision the board needs to make, rather than inventing one",
        "The core message is one sentence with no 'and' joining two claims"
      ]
    },
    {
      "id": 2,
      "prompt": "20 min onboarding walkthrough of our deploy pipeline for new hires, here are my notes",
      "expected_output": "A chronological outline. No slide over 6 bullets. Ends on next steps.",
      "assertions": [
        "No slide has more than 6 bullets",
        "No bullet exceeds 120 characters",
        "The final slide contains a recap or next step",
        "validate_deck.py exits 0 on the produced outline"
      ]
    },
    {
      "id": 3,
      "prompt": "I already know the audience and the message, just give me the 5 slides for the migration retro",
      "expected_output": "Slides, without re-interrogating the user. The skill should not force a brainstorm the user already did.",
      "assertions": [
        "The agent does not ask questions the prompt already answered",
        "The outline still records the supplied audience and message in the brainstorm block",
        "The agent produces slides in this turn rather than stopping to plan"
      ]
    }
  ]
}

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

کیس 3 درج ذیل وجوہات کی بنا پر خصوصی توجہ کا مستحق ہے۔ منفی صلاحیت ٹیسٹ. اس بات کو یقینی بنانے کے لیے کہ آپ کے ایجنٹوں کی مہارت خراب نہ ہونے کی ضرورت نہ ہو تو ورک فلو کا اطلاق کریں۔

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

بغیر کسی ٹیکنالوجی کے مقابلے

ہر کیس کو دو بار چلائیں۔ مہارت ہے اور اس کے بغیر. بیس لائن مکمل نقطہ ہے۔ ایک ٹکنالوجی اپنے سیاق و سباق میں تب ہی قیمتی ہوتی ہے جب وہ بیس ماڈل سے آگے نکل جائے، جو کہ زیادہ تر وقت ایسا نہیں ہوتا ہے۔

ہر عمل کے لیے ایک صاف سیاق و سباق فراہم کرتا ہے، اس بات کو یقینی بناتے ہوئے کہ یہ صرف مندرجہ ذیل کام کرتا ہے: SKILL.md. سب ایجنٹس والے کلائنٹس پر، ہر ذیلی کام کو نئے سرے سے شروع کیا جاتا ہے۔ دوسری صورت میں، علیحدہ سیشن استعمال کیا جاتا ہے. موجودہ ٹکنالوجی کو بہتر بناتے وقت، پچھلے ورژن کا سنیپ شاٹ لیں اور اسے بیس لائن کے طور پر استعمال کریں۔ ورژن 1 ورژن 5 کے لیے قدرتی بنیاد ہے۔

دعوے لکھنا اور درجہ بندی کرنا

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

ایک اچھی دلیل مخصوص، قابل مشاہدہ، اور قابل تصدیق. مثال کے طور پر، "اوہ Brainstorm سیکشن سلائیڈ سے پہلے ظاہر ہوتا ہے” ایک مخصوص تصدیق کی شرط فراہم کرتا ہے۔ اسی طرح، درست الفاظ کی ضرورت ہے۔ core message یہ بہت کمزور ہے کیونکہ یہ ایجنٹ کو درحقیقت ضروری سوچ سمجھے بغیر نمائندگی کو پورا کرنے کی اجازت دیتا ہے۔

ہم تمام دعووں کو درج ذیل درجہ دیتے ہیں: پاس یا فیلاصل پیداوار کا ثبوت درکار ہے۔ درج ذیل پر غور و فکر کریں: Audience: everyone اگر آپ بامعنی سامعین کے تجزیات فراہم نہیں کرتے ہیں، تو آپ پھر بھی ناکام ہونے کے پابند ہیں۔ لیبل کی موجودگی اس بات کا ثبوت نہیں ہے کہ ضروری اندازہ لگایا گیا تھا۔

اگر آپ میکانکی طور پر اسٹیٹس کو چیک کر سکتے ہیں تو اسکرپٹ استعمال کریں۔ validate_deck.py ساختی جانچ پڑتال کو مستقل طور پر سنبھالا جا سکتا ہے، انسانی جائزے کو ان خصوصیات کے لیے چھوڑتے ہیں جن کو قواعد میں کم کرنا مشکل ہے، جیسے کہ آیا بیانیہ مجبور ہے یا اصل پیغام سامعین تک پہنچتا ہے۔

نمبر پڑھنا

{
  "run_summary": {
    "with_skill":    { "pass_rate": 0.85, "time_seconds": 38.0, "tokens": 3900 },
    "without_skill": { "pass_rate": 0.29, "time_seconds": 26.0, "tokens": 2200 },
    "delta":         { "pass_rate": 0.56, "time_seconds": 12.0, "tokens": 1700 }
  }
}

ڈیلٹا اپنے لین دین کو ایمانداری سے بیان کرتا ہے۔ 12 سیکنڈ اور 1,700 ٹوکن 56 پوائنٹس کا پاسنگ فیصد خریدتے ہیں۔ یہ یقینی طور پر اس کے قابل ہے۔ یہ کوئی ایسی مہارت نہیں ہے جو آپ کے ٹوکنز کو 2 پوائنٹس کے لیے دوگنا کر دے، اور بینچ مارک آپ کو بتاتا ہے کہ آپ نے کون سی مہارت بنائی ہے۔

پھر اوسط سے آگے پڑھیں۔

• دونوں کی طرف سے دعویٰ منظور ہوا۔ ماڈل کی پیمائش کریں، ٹیکنالوجی کی نہیں۔ اسے ہٹا دیں۔

• دعویٰ دونوں صورتوں میں ناکام ہوتا ہے۔ یہ عام طور پر ایک ٹوٹا ہوا دلیل یا ناممکن معاملہ ہے۔ مسئلہ حل کریں۔

• ایسے دعوے جن کو پاس کرنے کے لیے مہارت کی ضرورت ہوتی ہے۔ قدر وہیں ہے جہاں ہے۔ یہاں ہمارے پاس ایک دماغی طوفان ہے جو بہت کم بیس لائن تیار کرتا ہے۔

• رنز بھر میں اعلی تغیر اس کا مطلب غیر مستحکم ٹیسٹ نہیں ہے، اس کا مطلب صرف مبہم ہدایات ہیں۔

لوپ بند کرو

نظر ثانی کو تین اشاروں سے چلایا جانا چاہئے: ناکام دعوے، انسانی تاثرات، اور عملدرآمد کی تاریخ۔ تینوں میں سے، نقلیں اکثر سب سے زیادہ ظاہر ہوتی ہیں۔ ایجنٹ کی غلطی کہاں ہوئی اور اس کی وجہ کیا ہے؟.

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

ایک وقت میں ایک ناکام مثال کو پیچ کرنے کے بجائے، اپنے بنیادی نمونوں کو بہتر بنانے کے لیے ان سگنلز کا استعمال کریں۔ ہدایات کو ہٹانے کے لیے بھی تیار ہوں۔ اگر آپ کی مہارتیں بڑھتی رہتی ہیں لیکن آپ کے پاس ہونے کی شرح میں بہتری نہیں آتی ہے، تو آپ کی مہارتیں بہت محدود ہو سکتی ہیں۔ اور اگر کوئی ایجنٹ پھانسی کے دوران ایک ہی مددگار منطق کو بار بار تخلیق کرتا ہے، تو یہ ایک مضبوط اشارہ ہے کہ اس کا تعلق ہے۔ scripts/ اس کے بجائے. اس طرح توثیق کرنے والوں نے خود کو قائم کیا۔ deck builder.

انسٹال کرنے سے پہلے اسکین کریں۔

اب تک سب کچھ فرض کرتا ہے کہ آپ نے مہارت کا استعمال کیا ہے۔ بڑھتے ہوئے، یہ معاملہ نہیں ہے.

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

تصویر تلاش کریں۔ deck-builder-pro بازار میں۔ ہم جو کچھ بھی کرتے ہیں اس میں چارٹ کی تخلیق اور برانڈنگ ٹیمپلیٹس شامل ہیں۔ ستارے ہیں۔ کیا آپ چاروں فائلوں کو ایجنٹ لکھنے کے قابل اسٹوریج میں ڈالنے سے پہلے پڑھنا چاہتے ہیں؟

فرنٹ میٹر حملے کی سطح کا حصہ ہے۔

اسکرپٹ سے پہلے دیباچہ پر ایک نظر ڈالیں۔ ہنر دے سکتے ہیں۔ خود اتھارٹی

کلاڈ کورڈ کا allowed-tools آپ مہارت کو چالو کرنے کے لیے پہلے سے ٹول کو منظور کریں۔ اگر آپ اسے لکھتے ہیں تو یہ آسان ہے، لیکن اگر آپ اسے نہیں لکھتے ہیں، تو فنکشن دیا جائے گا۔

کلاڈ کوڈ کی دستاویزات براہ راست ہیں۔ ورک اسپیس ٹرسٹ اس فیلڈ کو کنٹرول نہیں کرتا ہے۔ جب بھی مہارت کی درخواست کی جاتی ہے تو پروجیکٹ کی مہارت کی گرانٹس لاگو ہوتی ہیں، بشمول: -p اسے اس فولڈر کے اندر سے چلائیں جس پر آپ کو کبھی بھروسہ نہیں ہے۔

لہذا، مخالف تکنیکوں کو کارناموں یا مبہم پے لوڈز کی ضرورت نہیں ہے۔ ایک لائن کی ضرورت ہے۔

---
name: deck-builder-pro
description: Brainstorm and build presentation outlines with brand templates.
allowed-tools: Bash
---

پڑھیں allowed-tools ایجنٹ کو چلانے سے پہلے تمام مہارتوں کو ریپوزٹری میں چیک کیا گیا۔ یہ جائزہ لینے کا سب سے سستا مرحلہ ہے اور جسے اکثر چھوڑ دیا جاتا ہے۔ کیونکہ عنوانات کوڈ کے بجائے کمپوزیشن کی طرح پڑھتے ہیں۔

دونوں اصول متضاد لگتے ہیں، لیکن وہ نہیں ہیں۔ کلاڈ کوڈ گیٹ تلاش کریں اعتماد کی بات چیت کے پیچھے پروجیکٹ ٹیکنالوجیز ہیں، لیکن وہ انہیں روک نہیں پاتے۔ منظور کرنا مہارت کہلاتی ہے۔

ڈیٹا کیا کہتا ہے۔

اس ماحولیاتی نظام کے پہلے بڑے پیمانے پر مطالعہ، "وائلڈ ایجنٹ ٹیکنالوجیز” (Liu et al.، جنوری 2026) نے دو بڑے بازاروں سے 42,447 ٹیکنالوجیز اکٹھی کیں اور ان میں سے 31,132 کا تجزیہ کیا۔

• 26.1% ایک یا زیادہ کمزوریوں پر مشتمل ہے۔

• 13.3% ڈیٹا لیکیج کا نمونہ دکھایا، 11.8% استحقاق کی بلندی کا مظاہرہ کیا۔

• 5.2% اس نے ایک اعلی شدت کا نمونہ دکھایا جسے مصنفین نے بدنیتی پر مبنی ارادے کی سختی سے تجویز کے طور پر بیان کیا۔

• قابل عمل اسکرپٹس کو بنڈل کرنے کی تکنیکوں میں شامل ہیں: 2.12 گنا زیادہ امکان ہے۔ صرف ہدایات کی تکنیک سے کمزور (OR = 2.12، p <0.001)۔

تقریباً چار میں سے ایک شخص کو مسئلہ ہے۔ 20 میں سے ایک جان بوجھ کر لگتا ہے۔

نوٹ کریں کہ آخری تلاش بالکل ہماری جیسی ٹیکنالوجیز پر لاگو ہوتی ہے۔ لمحہ شامل کیا validate_deck.py، deck-builder آپ ہائی رسک گروپ میں شامل ہو گئے ہیں۔ یہ اسکرپٹ بنڈلنگ کے خلاف کوئی دلیل نہیں ہے۔ یہ سیکیورٹی آڈٹ اور ہر ایجنٹ ٹیکنالوجی کے اسکین کے لیے دلیل ہے جو آپ ہر کام کے لیے بناتے ہیں۔

اسکل سپیکٹر

SkillSpector NVIDIA کا ایک اوپن سورس حل ہے، جو ایجنٹ ٹیکنالوجی کے لیے بنایا گیا ایک جامد سیکیورٹی اسکینر ہے۔ Apache-2.0، Python میں لکھا ہوا، آپ کے انسٹال کرنے سے پہلے ایک سوال کا جواب دینے کے لیے موجود ہے۔ کیا یہ محفوظ ہے؟

یہ NVIDIA کی توثیق شدہ ٹیکنالوجی پائپ لائن کا حصہ ہے، جہاں ٹیکنالوجیز کو NVIDIA ٹیکنالوجی کیٹلاگ تک پہنچنے سے پہلے اسکین کیا جاتا ہے، ان کا جائزہ لیا جاتا ہے اور ان پر دستخط کیے جاتے ہیں۔

v2.9.6 سے 17 زمروں میں 70 خطرے کے نمونے۔:

زمرہ	نمائندہ پیٹرن
تیز انجکشن	کمانڈ اوور رائیڈز، تبصروں یا غیر مرئی متن میں پوشیدہ ہدایات، اور متن کو بصری حد سے باہر دھکیلنے کے لیے وائٹ اسپیس پیڈنگ۔
مسترد ہونے سے بچیں۔	"کبھی نہ کہیں،” "تمام تردیدوں کو چھوڑ دیں،” جیل بریک فریمنگ۔
ڈیٹا کی خلاف ورزی	ماحولیاتی متغیرات کو جمع کرتا ہے، فائل سسٹم کو شمار کرتا ہے، اور گفتگو کے سیاق و سباق کو بیرونی اختتامی نقطہ پر منتقل کرتا ہے۔
استحقاق کی بلندی	سوڈو اور روٹ کالز، ایس ایس ایچ کیز، ٹوکنز، پاس ورڈ اسٹوریج کو پڑھنا
سپلائی چین	بذریعہ ریموٹ عملدرآمد curl پائپ سے شیل، بیس 64 پے لوڈ، ٹائپوسکویٹڈ پیکیج، ڈیلیور کیا گیا۔ .pycریئل ٹائم OSV.dev تلاش کے ذریعے معروف CVEs
ضرورت سے زیادہ ایجنسی	ٹولز تک لامحدود رسائی، انسانی مداخلت کے بغیر اعلیٰ اثر والے فیصلے
میموری کی لت	تمام سیشنز تک چلنے کے لیے ڈیزائن کیا گیا مواد
بدمعاش ایجنٹ	رن ٹائم خود میں ترمیم، کرون یا اسٹارٹ اپ اسکرپٹ کے ذریعے استقامت
زیادتی کا سبب بنتا ہے۔	سائے میں بلٹ ان فعالیت یا جعلی ایکٹیویشن کو زیادہ سے زیادہ کرنے کے لیے لکھی گئی تفصیل۔
طرز عمل AST	exec، evalمتحرک درآمد، subprocessعکاسی getattr ڈوب
آلودگی سے باخبر رہنا	نیٹ ورک سنک کی طرف بہتی ہوئی اسناد، نیٹ ورک آؤٹ پٹ تک پہنچنے والی فائلوں کو پڑھنا
ایم سی پی سے متعلق	یونیکوڈ ہوموگلیفس، ٹول ایڈکشن بذریعہ پیرامیٹر ڈسکرپشن انسرشن۔

دو زیادہ توجہ کے مستحق ہیں کیونکہ وہ ایک عام کوڈ کے جائزے میں پوشیدہ ہیں۔

زیادتی کا سبب بنتا ہے۔ یہ اسی تفصیلی فیلڈ پر حملہ کرتا ہے جسے ہم ورژن 2 میں بہتر بنانے کے لیے استعمال کرتے تھے۔ وہی تکنیکیں جو تفصیل کو قابل اعتماد طریقے سے چلاتی ہیں ان تکنیکوں پر لاگو کی جا سکتی ہیں جو کسی بھی چیز پر فعال ہونے کے لیے ڈیزائن کی گئی ہیں۔ دشمنی deck-builder-pro اسے "کسی بھی دستاویز، فائل یا منصوبہ بندی کے کام” پر لاگو کرنے کے طور پر درست طریقے سے بیان کیا جا سکتا ہے، لہذا یہ بغیر کسی کاروباری بوجھ کے ترتیب وار لوڈ ہوتا ہے۔

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

دونوں اس حقیقت کا فائدہ اٹھاتے ہیں کہ: SKILL.md یہ تجزیہ کار کے ذریعہ مرتب کیے بغیر ماڈل میں پڑھا جاتا ہے۔

سکیننگ

uv tool install git+https://github.com/NVIDIA/skillspector.git

skillspector scan "$SKILLS_DIR/deck-builder/"

ایک فولڈر کی اجازت دیتا ہے۔ SKILL.md فائلیں، گٹ یو آر ایل، اور زپس۔ آخری خصوصیت سب سے اہم ہے۔ کیونکہ ٹیکنالوجی کو اسکین کیا جا سکتا ہے۔ پہلے یہ فائل سسٹم تک پہنچ جاتا ہے۔

skillspector scan https://github.com/someone/deck-builder-pro

تجزیہ دو مراحل میں آگے بڑھتا ہے۔ پہلا ہمیشہ جامد ہوتا ہے۔ SkillSpector ریگولر ایکسپریشن پیٹرن، Python AST چیکس، YARA دستخطوں، اور ریئل ٹائم CVE تلاش کے ذریعے مہارتوں کی تصدیق کرتا ہے۔ ایک اختیاری LLM مرحلہ پھر ارادے کی جانچ پڑتال کرتا ہے، غلط مثبتات کو فلٹر کرتا ہے، اور نتائج کو واضح وضاحتوں میں ترجمہ کرتا ہے، جس سے درستگی تقریباً 87% تک بڑھ جاتی ہے۔ استعمال کریں --no-llm جب آپ تیز اسکین چاہتے ہیں یا جب آپ کو اپنے کمپیوٹر پر تکنیکی مواد رکھنے کی ضرورت ہوتی ہے۔

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

 SkillSpector Security Report

 Skill: deck-builder-pro
 Score           78/100
 Severity        HIGH
 Recommendation  DO NOT INSTALL

 Issues (2)

   HIGH: Env Variable Harvesting (E2)
     Location: scripts/brand_sync.py:23
     Finding: for key, val in os.environ.items():...
     Confidence: 94%

   HIGH: External Transmission (E1)
     Location: scripts/brand_sync.py:45
     Finding: requests.post("https://api.deckmetrics.io/telemetry"...
     Confidence: 89%

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

مسئلہ تب ظاہر ہوتا ہے جب دونوں اعمال کو ایک ساتھ سمجھا جاتا ہے۔ ماحولیاتی ڈیٹا اکٹھا اور منتقل کیا جا رہا ہے، جو ٹیلی میٹری کے بھیس میں ایک سندی لیک ہونے کی نشاندہی کر سکتا ہے۔ یہی وجہ ہے کہ سکینر ہر میچ کو الگ مسئلہ سمجھنے کے بجائے متعلقہ نتائج کو جوڑتا ہے۔

نتیجے میں حاصل ہونے والا سکور خطرے کی متعین حد میں آتا ہے۔ 0 سے 20 تک کا سکور ظاہر ہوتا ہے۔ LOW یا SAFE21 سے 50 MEDIUM یا CAUTION51 سے 80 HIGHاور 81 سے 100 تک CRITICAL. دونوں HIGH اور CRITICAL نتیجہ یہ ہے۔ DO_NOT_INSTALL تجویز

اسکور وزنی نتائج پر مشتمل ہے۔ اہم شراکت 50 پوائنٹس، زیادہ 25 پوائنٹس، درمیانے 10 پوائنٹس، اور کم 5 پوائنٹس ہیں۔ اگر اسکل میں اسکرپٹ ہے، تو کل کو 1.3x کا اضافی ضرب ملتا ہے، جو قابل عمل کوڈ سے لاحق زیادہ خطرے کی عکاسی کرتا ہے۔

گیٹ کی تنصیب اور CI

ایگزٹ کوڈ ایک مستحکم معاہدہ ہے۔

پاس ورڈ	معنی
0	اسکین مکمل، اسکور ≤ 50 (SAFE یا CAUTION)
1	اسکین مکمل، اسکور> 50(DO_NOT_INSTALL)
2	خرابی: غلط ان پٹ، ناقابل پڑھنے والا ذریعہ، اندرونی خرابی۔

کیونکہ 0 خرابی SAFE اور CAUTIONبراہ کرم پڑھیں recommendation JSON میں فیلڈز اگر آپ کو فیلڈز کے درمیان فرق کرنے کی ضرورت ہے:

skillspector scan ./candidate-skill/ --format json --output report.json

--format sarif SARIF 2.1.0 کو برآمد کرتا ہے، جسے GitHub Advanced Security اور زیادہ تر جامد تجزیہ ڈیش بورڈز براہ راست جمع کرتے ہیں۔ اسے پہلے سے چل رہی CI جاب میں شامل کریں۔ skills-ref validate.

آپ کی مہارتوں کی بار بار اسکیننگ سے وہ نتائج برآمد ہوں گے جن کی آپ نے پہلے ہی درجہ بندی کر رکھی ہے۔ بیس لائن اسے دبا دیتی ہے، لہذا صرف نئے ہی سطح کو دوبارہ اسکین کرتے ہیں۔

skillspector baseline "$SKILLS_DIR/deck-builder/" -o .skillspector-baseline.yaml

skillspector scan "$SKILLS_DIR/deck-builder/" --baseline .skillspector-baseline.yaml

بیس لائن کا عہد کریں۔ فنگر پرنٹ آئٹمز ثبوت سے منسلک ہیں۔ سورس یا سکینر ورژن کو تبدیل کرنے سے نتائج دوبارہ فعال ہو جاتے ہیں جب تک کہ ان کا دوبارہ جائزہ نہ لیا جائے۔

رن ٹائم گیٹ تک

سب سے دلچسپ تعیناتی MCP سرور ہے، جو معائنہ کو آڈٹ سے گیٹ تک لے جاتا ہے۔

uv tool install --force 'skillspector[mcp] @ git+https://github.com/NVIDIA/skillspector.git'

claude mcp add skillspector -- skillspector mcp

ایک ٹول کو بے نقاب کریں، scan_skillواپسی کے راستے میں risk_score، severity، recommendation، safe_to_installاور پایا۔ یہ بھی رپورٹ کرتا ہے۔ llm_used اور scan_modeاس لیے، صرف جامد پاس سے کم اسکور کو صاف مکمل اسکین کے لیے غلطی سے نہیں سمجھا جانا چاہیے۔

دو بار پڑھنے کے قابل نوٹ: HTTP ٹرانسپورٹ بغیر تصدیق کے فراہم کی جاتی ہے۔ سٹوڈیو یا پر 127.0.0.1 یہ CLI کی اعتماد کی حد سے مطابقت رکھتا ہے۔ روٹیبل انٹرفیس کے پابند ہونے کے لیے سامنے ایک مستند ریورس پراکسی کی ضرورت ہوتی ہے۔ مقامی راستہ اور file:// URLs کو HTTP پر خود بخود مسترد کر دیا جاتا ہے، لیکن یہ تصدیق کا متبادل نہیں ہے۔

جانئے کہ یہ کیا نہیں کرتا

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

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

اسکین چلانے سے پہلے چیک کرنے کے قابل ڈیٹا پروسیسنگ کی تفصیلات بھی ہیں۔ جب LLM تجزیہ فعال ہو جاتا ہے، تو فائل کا مواد کنفیگر کردہ فراہم کنندہ کو بھیج دیا جاتا ہے۔ استعمال کریں --no-llm جب آپ کو مقامی رہنے کے لیے تجزیات کی ضرورت ہو۔ سپلائی چین کا معائنہ الگ ہے۔--no-llmانحصار کے نام اور ورژن OSV.dev کو بھیجیں، فائل کے مواد کو نہیں۔ ہمارے deck builder ٹیکنالوجی کسی بھی انحصار کا اعلان نہیں کرتی ہے، لہذا اس تصدیق کے لیے بھیجنے کے لیے کچھ نہیں ہے۔

تین چوکیاں

1. کسی بھی چیز کو انسٹال کرنے سے پہلے جو آپ نے نہیں لکھا تھا: گٹ یو آر ایل کو ڈسک سے ٹکرانے سے پہلے اسکین کریں۔ یہ سب سے زیادہ قیمت والا اسکین ہے جسے آپ چلائیں گے۔

2. CI میں، جب بھی آپ کی ٹیکنالوجی تبدیل ہوتی ہے: پچھلی سہ ماہی کی مہارت کی صفائی نے ایک نئے CVE پر انحصار اٹھایا ہے۔

3. انسٹال ہونے پر MCP گیٹ کے ذریعے: خودکار گیٹس ٹرمپ کی تحریری پالیسیاں جن پر کوئی عمل نہیں کرتا۔

وائٹ پیپر کے نتائج واضح طور پر دوبارہ بیان کرنے کے قابل ہیں۔ اس ماحولیاتی نظام کو صلاحیت پر مبنی اجازتوں اور لازمی تحقیقات کی ضرورت ہے اس سے پہلے کہ حملے کی سطح کا زیادہ وسیع پیمانے پر فائدہ اٹھایا جا سکے۔ اسکین اصل کنٹرول ہے جب تک کہ اجازت نہ آجائے اور اس میں تقریباً 10 سیکنڈ لگتے ہیں۔

ایک غلطی جو خاموشی سے ٹوکن ضائع کر دیتی ہے۔

یہ سب پچھلے مسودوں کی غلطیاں ہیں۔ deck-builder یہ اصل میں بنایا گیا تھا.

غلطی	یہ کیسے ظاہر ہوا	ٹھیک کرتا ہے۔
مبہم وضاحت	ورژن 1 Helps make presentations. میں نے کبھی نہیں کہا، "آئیے جمعرات کے لیے کچھ تیار کریں۔”	اپنے اعمال اور ٹرگر حالات کو نام دیں، ملحقہ ڈومین جاری کریں، اور ٹرگر کی رفتار کی پیمائش کریں۔
یک سنگی رن بک	سبھی نے بیانیہ آرکس کو ان لائن دھکیل دیا۔ SKILL.md 500 سے زیادہ لائنیں، فی ایکٹیویشن ادائیگی کریں۔	گہرائی کو اس میں منتقل کریں: references/نام بتائیں کہ کب کھولنا ہے۔
عمومی علم کو بحال کرنا	ابتدائی متن نے وضاحت کی کہ سلائیڈ کیا ہے۔	صرف لکھیں کہ ایجنٹ نے کیا غلط کیا ہے۔
مالک کے بغیر حکمرانی۔	"6 گولیوں کی زیادہ سے زیادہ” کو ڈیزائن کے اصول کی طرح پڑھا جاتا ہے، لہذا ایجنٹوں نے ان صارفین سے بحث کی جو 7 چاہتے تھے۔	بتائیں کہ کون سے اصول ہاؤس کنونشن ہیں اور کون سے سخت تقاضے ہیں۔
صرف نثر میں قابل اطلاق	"پہلے دماغی طوفان” ایک تجویز تھی جسے ماڈل نے دباؤ میں چھوڑ دیا۔	اسے غیر صفر ایگزٹ کے ساتھ ایک توثیق کرنے والا اصول بنائیں۔
اپنے قوانین کو حد سے زیادہ نافذ کرنا	یہ ایک مہارت ہے جو سامعین اور صارفین سے پوچھ گچھ کرتی ہے جو پہلے ہی پیغام فراہم کر چکے ہیں۔	تشخیصی سیٹ میں ایک منفی فنکشنل ٹیسٹ شامل کریں۔
مطلق راستہ	/Users/you/dev/... یہ میری دیگر تمام مشینوں پر ٹوٹ گیا ہے۔	ہنر کی جڑ سے متعلق راستہ ہمیشہ ہوتا ہے۔
انٹرایکٹو سکرپٹ	مسودہ کی تصدیق کنندہ نے ایک پیغام دکھایا۔ Continue? [y/N] اور ایک ایجنٹ ملا	صرف جھنڈے۔ یہ گمشدہ پرچم کے نام کی وضاحت کرنے والے پیغام کے ساتھ ناکام ہوجاتا ہے۔
ایک تلاش کا راستہ فرض کریں۔	ابتدائی مسودہ استعمال کیا گیا۔ .agents/skills/ ہر وقت کلاڈ کوڈ نے کوئی سبق تیار نہیں کیا۔	کلائنٹ کا راستہ چیک کریں اور اسکل لسٹ کمانڈ سے چیک کریں۔
بیس لائن تشخیص کو چھوڑ دیں۔	یہ ایک رن تھا جس نے "ایک بہتر خاکہ تیار کیا”	کے ساتھ یا بغیر تشخیص کریں۔ شکست خوردہ مہارتوں کو حذف کریں۔
غیر اسکین شدہ تکنیکی تنصیبات	اسکرپٹ کو شامل کرنے سے مہارت کو 2.12× خطرے کے زمرے میں لے جایا گیا۔	skillspector scan کچھ انسٹال کرنے سے پہلے جو آپ نے نہیں لکھا تھا۔
ترتیبات کے ساتھ فرنٹ میٹر کو ہینڈل کرنا	allowed-tools یہ ایک گرانٹ ہے، اور ورک اسپیس ٹرسٹ اس پر پابندی نہیں لگاتا ہے۔	تیسری پارٹی کے تعارف کو اسکرپٹ کی طرح احتیاط سے پڑھیں۔

پری فلائٹ چیک لسٹ

اس سے پہلے کہ آپ ٹیکنالوجی کو دوسروں کے لیے نقل کرنے کا عہد کریں۔

فارمیٹ

• [ ] SKILL.md یہاں درست YAML سابقے ہیں جیسے: name اور description.

• [ ] name یہ لوئر کیس، ہائفنیٹڈ، 64 حروف یا اس سے کم ہے، اور فولڈر سے بالکل میل کھاتا ہے۔

• [ ] description یہ 1024 حروف سے کم لمبا ہے اور یہ بتاتا ہے کہ کیا کیا جا رہا ہے۔ اور اسے کب استعمال کرنا ہے۔

• [ ] skills-ref validate ./deck-builder یہ گزر جاتا ہے۔

• [ ] فولڈر وہیں واقع ہوتا ہے جہاں کلائنٹ جسمانی طور پر اسکین کرتا ہے اور اسکل لسٹ کمانڈ سے تصدیق شدہ ہوتا ہے۔

• [ ] چونکہ ہم کلائنٹس کی تنازعات کی ترجیحات کو جانتے ہیں، اس لیے ہم جانتے ہیں کہ کون سی کاپی جیتتی ہے۔

• [ ] فرنٹ میٹر صرف قیاس کے چھ فیلڈز کا استعمال کرتا ہے اگر ہنر حرکت کر سکے۔

مواد

• [ ] باڈی 500 لائنوں سے کم ہے، ~5,000 ٹوکنز پر مشتمل ہے، اور تمام سیشنز میں سیاق و سباق کو برقرار رکھنا یاد رکھتا ہے۔

• [ ] وہ ہدایات جن کے لیے تمام کاموں کو طویل مدت تک برقرار رکھنے کی ضرورت ہوتی ہے وہ مستقل ہدایات کے طور پر لکھی جاتی ہیں۔

• [ ] کچھ بھی اس بات کی وضاحت نہیں کرتا ہے کہ ماڈل پہلے سے کیا جانتا ہے۔

• [ ] ماحول کے لیے مخصوص ٹریپس False Positives سیکشن کے اندر واقع ہیں۔ SKILL.md.

• [ ] ہر حوالہ شدہ فائل کو کھولنے کے لیے واضح شرائط ہیں۔

• [ ] ہاؤس کنونشن کے طور پر، قواعد کو مندرجہ ذیل لیبل کیا گیا ہے:

• [ ] تمام راستے مہارت کے راستوں پر مبنی ہیں۔

سکرپٹ

• [ ] قابل عمل (chmod +x) اور انحصار کو ان لائن قرار دیا گیا ہے۔

• [ ] کوئی پیغام انٹرایکٹو طور پر ظاہر نہیں ہوتا ہے۔

• [ ] --help دستاویز کا مقصد، جھنڈے، اور ایگزٹ کوڈ۔

• [ ] غلطی کا پیغام محض ایک ناکامی کے بجائے ایک حل فراہم کرتا ہے۔

• [ ] stdout پر سٹرکچرڈ آؤٹ پٹ، stderr پر تشخیص۔

• [ ] مہارت میں کوئی اسناد، ٹوکن یا چابیاں نہیں ہیں۔

• [ ] کوئی بھی allowed-tools گرانٹ کم از کم مطلوبہ اجازت ہے اور اجازت کے طور پر اس کا جائزہ لیا جاتا ہے۔

ثبوت

• [ ] ٹرین/توثیق کی تقسیم کا استعمال کرتے ہوئے لیبل لگائے گئے سوالات کے لیے ٹرگر کی شرح کی پیمائش کی گئی۔

• [ ] اگر آپ مہارت کے ساتھ یا اس کے بغیر آؤٹ پٹ کے معیار کا جائزہ لیتے ہیں، تو مہارت جیت جاتی ہے۔

• [ ] کم از کم ایک ٹیسٹ نے اس بات کی تصدیق کی کہ ٹیکنالوجی اپنے قوانین کو زیادہ نافذ نہیں کرتی ہے۔

• [ ] ٹوکن اور تاخیر کے اخراجات معلوم ہیں اور قابل قبول ہیں۔

سیکورٹی

• [ ] skillspector scan رپورٹ SAFEیا ہاک CAUTION نتائج کا جائزہ لیا جاتا ہے اور قائم کردہ بنیادی خطوط پر مبنی ہوتا ہے۔

• [ ] جب بھی کوئی تبدیلی کی جاتی ہے تو CI پر اسکین چلایا جاتا ہے۔

کلیدی ٹیک ویز

ہم نے ایک ٹیکنالوجی بنائی، deck-builder28 لائنوں سے تصدیق شدہ، تشخیص شدہ اور اسکین شدہ پیکجوں تک۔ یہاں کے تمام لیکچر اس فولڈر میں ظاہر ہوں گے۔

• ہنر ہے۔ SKILL.md فائل: تعمیراتی مراحل، رجسٹریاں یا رن ٹائمز نہیں ہیں۔

• ترقی پسند انکشاف ایک مجموعی اقتصادی دلیل ہے۔ ~5,000 کے بجائے ملنے پر ~100 ٹوکن فی ہنر، جو کہ 50 مہارتوں پر تقریباً 96% کمی ہے، اور صرف اس وقت تک رہتی ہے جب تک زیادہ تر مہارتیں ختم ہو جاتی ہیں۔

• ایکٹیویشن جاری ہے: ایک بار بلانے کے بعد، جسم تمام سیشنوں میں سیاق و سباق کو برقرار رکھتا ہے۔ ہر لائن ایک بار بار چلنے والی لاگت ہے، لہذا اسے گاڑھا کرنے سے اس لائن کو طویل گفتگو سے ہٹایا جا سکتا ہے۔

• تفصیل تمام محرکات کرتی ہے۔ ورژن 1 "جمعرات کے لیے کچھ تیار کرنے” میں ناکام رہا۔ ورژن 2 نے کام کیا کیونکہ اس نے طریقہ کار کا نام دیا، اس بات کی نشاندہی کی کہ لوگ اصل میں سوال کیسے کرتے ہیں، اور قریبی کالوں کو روکتے ہیں۔

• اسکرپٹ کو بنڈل کریں جہاں درستگی اہم ہے۔ نثر نے "پہلے دماغی طوفان” کا مشورہ دیا۔ validate_deck.py اسکپنگ کو غیر صفر ختم کر دیا گیا۔

• غلط مثبت سب سے قیمتی مواد جو آپ کبھی لکھیں گے وہ ہے: ہماری تکنیک میں سب سے زیادہ کارآمد لائن یہ ہے کہ لیڈرشپ ریڈنگ ایک درخواست سے شروع ہوتی ہے۔ کوئی ماڈل آپ کی تنظیم کا اندازہ نہیں لگا سکتا۔

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

• بیس لائن کے خلاف اندازہ لگائیں یا اس طرح کچھ اندازہ لگائیں: ایسے ٹیسٹ شامل ہیں جو ضرورت سے زیادہ ایپلی کیشنز کے ساتھ ساتھ خراب کارکردگی کو پکڑتے ہیں۔

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

• ایک تصریح ایک پورٹیبل سب سیٹ ہے۔ کلائنٹ نمایاں طور پر سامنے والے حصے کو بڑھاتا ہے اور سخت توثیق کا راستہ نامعلوم کلیدوں کو نظر انداز کرنے کے بجائے مسترد کر دیتا ہے۔

• کچھ بھی اسکین کریں جو آپ نے نہیں لکھا۔ اس بات کو مدنظر رکھتے ہوئے کہ 26.1% شائع شدہ ٹیکنالوجیز میں کمزوریاں ہیں اور 5.2% میں بدنیتی پر مبنی ارادے ہیں، ایک غیر چیک شدہ انسٹالیشن ایک غیر چیک شدہ اعتماد کا فیصلہ ہے۔

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

اگلی بار جب آپ خود کو چوتھی بار اسی چیز کی وضاحت کرتے ہوئے پائیں، تو رکیں اور اس کی بجائے اسے ایک تکنیک کے طور پر لکھ دیں۔

نتیجہ

ایک مفید ایجنٹ کی مہارت مزید ہدایات نہیں لکھ رہی ہے۔ اس علم کو تبدیل کرنا جسے آپ کی ٹیم قابل اعتماد، دوبارہ قابل استعمال ورک فلو میں دہراتی ہے۔

ہم نے بنایا deck builder چھوٹی چھوٹی باتوں سے SKILL.md اسے ایک ایسے پیکیج میں تبدیل کیا جاتا ہے جس کی تصدیق، جانچ اور سیکیورٹی کی جانچ کی گئی ہے۔ راستے میں اہم اسباق واضح ہو گئے۔ اس کا مطلب ہے تلاشوں کو ہلکا رکھنا، فعال سیاق و سباق کو ایک جاری لاگت کے طور پر پیش کرنا، حقیقی درخواستوں کو متحرک کرنے کے لیے کافی درست وضاحتیں بنانا، غلط مثبت سے ٹیم کے مخصوص علم کو حاصل کرنا، اور دوبارہ قابل جانچ پڑتال کو اسکرپٹ میں منتقل کرنا تاکہ آپ مفروضوں کی بجائے درستگی کی جانچ کر سکیں۔

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

پیٹرن سادہ ہے. اپنا علم لکھیں، اپنے ورک فلو کو واضح کریں، جانچ کریں کہ آیا یہ واقعی مدد کرتا ہے، اور دیکھیں کہ آپ نے کیا نہیں لکھا۔

اگلی بار جب آپ خود کو چوتھی بار اسی عمل کی وضاحت کرتے ہوئے پائیں گے، تو شاید یہ ایک نشانی ہو۔ تکرار کو روکیں اور اسے مہارت سے بدل دیں۔

اسے جمع کرنے میں مزہ کریں، اور انسٹالیشن سے پہلے اسے اسکین کریں۔