اسکلز اور ٹولز

مشترکہ اسکلز .agents/skills/ میں رہتی ہیں۔ انہی سورسز میں ترمیم کریں، پھر Claude Code کے لیے .claude/skills/ بنانے کی خاطر yarn ai-workflow:sync چلائیں۔ Codex اور Cursor براہِ راست .agents/skills/ دریافت کرتے ہیں؛ دہری .codex/skills/ یا .cursor/skills/ روٹ ڈائریکٹریاں بحال نہ کریں۔

مشترکہ رول پرامپٹس .agents/roles/*.md میں رہتے ہیں۔ یہ ریپوزٹری سے مخصوص سورس فارمیٹ ہے، ایجنٹس کی دریافت کا کوئی نیٹو راستہ نہیں۔ scripts/ai-workflow-files.mjs ان سورسز کو نیچے دی گئی ایپ سے مخصوص فائلوں میں تبدیل کرتی ہے؛ yarn ai-workflow:sync انہیں لکھتا ہے۔ تیار کردہ فائلوں کو ان کے سورسز کے ساتھ ہی کمٹ کریں تاکہ نئے چیک آؤٹ میں پہلے کوئی جنریٹر چلائے بغیر نیٹو کنفیگریشن موجود ہو۔ کوئی سورس ہٹانے کے بعد اس کے متروک تیار کردہ آؤٹ پٹس صراحتاً ہٹائیں؛ ویلیڈیٹر فائلیں خاموشی سے مٹانے کے بجائے ان کی نشاندہی کرتا ہے۔

نیٹو دریافت کے راستے

2026-09-12 کو سرکاری دستاویزات سے تصدیق شدہ:

ایپ	پروجیکٹ کی ہدایات	اس ریپوزٹری میں استعمال ہونے والی اسکلز	اس ریپوزٹری میں استعمال ہونے والے کسٹم ایجنٹس
Codex	AGENTS.md	.agents/skills/<name>/SKILL.md	تیار کردہ .codex/agents/<name>.toml
Cursor	AGENTS.md؛ Cursor سے مخصوص مشروط قواعد کے لیے .cursor/rules/*.mdc بدستور دستیاب ہے	.agents/skills/<name>/SKILL.md	تیار کردہ .cursor/agents/<name>.md
Claude Code	CLAUDE.md، @AGENTS.md کو امپورٹ کرتی ہے	تیار کردہ .claude/skills/<name>/SKILL.md	تیار کردہ .claude/agents/<name>.md

ماخذ: Codex اسکلز، Codex سب ایجنٹس، Cursor قواعد، Cursor اسکلز، Cursor سب ایجنٹس، Claude میموری، Claude اسکلز، Claude سب ایجنٹس۔

نیٹو ایجنٹ ڈائریکٹریوں کی جگہ .agents/roles استعمال نہ کریں، اور یہ فرض نہ کریں کہ Claude، .agents/skills دریافت کرتا ہے۔ Claude پھر بھی وہاں موجود کسی حوالہ شدہ فائل کو عام پروجیکٹ کانٹیکسٹ کے طور پر پڑھ سکتا ہے۔ مطابقت کے لیے Cursor، .claude/skills بھی دریافت کرتا ہے؛ کاپیاں ہم آہنگ رہتی ہیں، مگر اس کی شائع شدہ اسکلز گائیڈ یہ واضح نہیں کرتی کہ ان روٹ ڈائریکٹریوں کے درمیان دہرے اندراجات کیسے ختم کیے جاتے ہیں۔ یہ وعدہ کرنے کے بجائے کہ دہرے اندراجات ظاہر نہیں ہو سکتے، انسٹال شدہ ایپ کا اسکل کیٹلاگ چیک کریں۔

AI ڈائریکٹریاں .gitattributes کے ذریعے LF لائن اینڈنگز استعمال کرتی ہیں تاکہ تیار کردہ متن تمام پلیٹ فارمز پر یکساں رہے۔ اسکلز کے معاون اثاثے بائٹ در بائٹ کاپی کیے جاتے ہیں۔

اسکلز

اسکل	مقصد
commit	مجاز، محدود دائرے والے مقامی کمٹس بنانا
commit-format، issue-format	درخواست پر فارمیٹ کی تجاویز
make-closed-issue	مجاز ایشو، محدود دائرے والا کمٹ اور PR بنانا
review-and-merge-pr	PR پر فیڈ بیک کی چھانٹی؛ اصلاح/اشاعت/مرج صرف مطلوبہ دائرے کے اندر
fix-merge-conflicts	تنازعات حل کرنا اور مرج شدہ نتیجے کی تصدیق
release	ریلیز کی عبارت تیار کرنا اور ریلیز کے مجاز اقدامات انجام دینا
code-quality-review	ایسے ڈِفس جو معمولی نہ ہوں، یا صراحتاً اٹھائے گئے معیار کے کسی خدشے کا جائزہ
retro	سامنے آنے والی غلطیوں کو ایسی مرکوز جانچوں یا رہنمائی میں بدلنا جو انہیں دہرانے سے روکیں
refactor-pass، deslop	موجودہ تبدیلیوں کی مطلوبہ صفائی
debug-agent	شواہد پر مبنی ڈیبگنگ، ضرورت پڑنے پر انسٹرومنٹیشن کے ساتھ
you-might-not-need-an-effect	ایفیکٹ/میمو کا مرکوز جائزہ
vercel-react-best-practices	قابلِ اطلاق React کارکردگی رہنمائی؛ اس Vite کلائنٹ کے لیے Next.js/صرف سرور والے قواعد چھوڑ دیں
translate	ترجمے تیار کرنا، پھر نقشے ایک ہی رائٹر کے ذریعے لاگو کرنا
playwright-cli، inspect-elements	براؤزر تصدیق اور DOM سے سورس تک میپنگ
profile-browsing	محدود دائرے میں براؤزر اور React پروفائلنگ
test-apk	فراہم کردہ ساتھی Android ریپر کی تصدیق
impeccable، improve-threejs	محدود دائرے میں انٹرفیس ڈیزائن اور Three.js رینڈرنگ کا جائزہ
implement-plan	اختیاری محدود ڈیلیگیشن کے ساتھ منصوبے پر عمل درآمد
readme	تصدیق شدہ پروجیکٹ دستاویزات کی دیکھ بھال
context7	ورژن کے لحاظ سے موزوں لائبریری دستاویزات حاصل کرنا
find-skills	صراحتاً درخواست کیے جانے پر اضافی اسکلز تلاش کرنا

رولز اور ماڈلز

browser-check، profiler، test-apk، translator اور reviewer کے لیے کسٹم رولز برقرار رکھیں۔ عام نفاذ اور کوڈ کی دریافت کے لیے ہارنیس کا بلٹ اِن ورکر/جنرل پرپز یا ایکسپلورر رول استعمال کریں۔ قبولیت کے معیارات اور ملکیت پیرنٹ طے کرتا ہے؛ بھاری جانچیں ایک ہی مالک چلاتا ہے۔

Codex کی ایجنٹ فائلوں میں name، description اور developer_instructions شامل ہوتے ہیں۔ .codex/config.toml، max_concurrent_threads_per_session کے ذریعے بیک وقت چلنے والے چائلڈ ایجنٹس کی حد چار مقرر کرتی ہے۔ مشترکہ رول میٹا ڈیٹا میں نام، تفصیل اور اختیاری سینڈ باکس موڈ ہوتا ہے؛ اس میں جان بوجھ کر ماڈل کے فیلڈز نہیں رکھے گئے۔

تینوں ایپس میں کمٹ شدہ اسکلز اور کسٹم ایجنٹس سے ماڈل اور ریزننگ کے فیلڈز باہر رکھیں۔ اس سے ہر ایپ کی دستاویزی ترجیحی ترتیب کے مطابق رن ٹائم پر کال کے وقت کے انتخاب، صارف کے ڈیفالٹس اور پیرنٹ سے وراثت ممکن ہوتی ہے۔ Claude کے فیملی عرفی نام ورژن کی دیکھ بھال کم کرتے ہیں مگر پھر بھی ایک فیملی چن لیتے ہیں؛ Cursor کے ورژن والے ماڈل کو مستقبل میں اپ ڈیٹس درکار ہوں گی۔ ضرورت ہو تو ایسے انتخاب صارف/سیشن کی ترتیبات میں رکھیں۔ وراثت اس بات کا وعدہ نہیں کرتی کہ موجودہ بہترین ماڈل خود بخود چنا جائے گا۔ کوئی latest عرف ایجاد نہ کریں اور نہ معمول کے کاموں میں ماڈل کیٹلاگ کی تحقیق شامل کریں۔ دیکھیں Codex میں انتخاب، Claude میں انتخاب اور Cursor میں انتخاب۔

sandbox-mode: read-only کو Codex کے سینڈ باکس اور Cursor کے readonly سے ملایا جاتا ہے؛ Claude کی ٹول فہرست اور رول کی ہدایات اس کے ریویو ورک فلو کو محدود کرتی ہیں، مگر Bash تک رسائی آپریٹنگ سسٹم کی سطح کا سینڈ باکس نہیں ہے۔

مشترکہ اسکلز کا فرنٹ میٹر، جہاں قابلِ اطلاق ہو، صارف کے چلائے جانے والے ورک فلوز کے لیے disable-model-invocation: true استعمال کرتا ہے۔ Codex کی متعلقہ ترتیب agents/openai.yaml میں policy.allow_implicit_invocation: false کے طور پر موجود ہے؛ ویلیڈیٹر دونوں کا تقاضا کرتا ہے۔ انووکیشن میٹا ڈیٹا صریح اجازت کے قواعد کی تکمیل کرتا ہے؛ ریویو کی درخواست کبھی بھی محض اس لیے اشاعت کی اجازت نہیں دیتی کہ کسی اسکل میں اشاعت کے اقدامات شامل ہیں۔

جانچیں اور دریافت

• yarn ai-workflow:sync انسٹال شدہ js-yaml اور smol-toml کی مدد سے مطابقتی آؤٹ پٹس دوبارہ تیار کرتا ہے۔
• yarn ai-workflow:check سورس/فرنٹ میٹر/کنفیگز کو پارس کرتا ہے، اور تیار کردہ آؤٹ پٹس، انووکیشن میٹا ڈیٹا، ماڈل فیلڈز کی جگہ، اور صرف فارمیٹر والی ہک وائرنگ کی جانچ کرتا ہے۔ یہ ماڈل شناخت کنندگان کو کسی فراہم کنندہ کے کیٹلاگ سے ملا کر حل نہیں کرتا۔
• yarn ai-workflow:test ہک پے لوڈز اور ورک فلو کی تیاری/توثیق کے لیے الگ تھلگ Node فکسچرز چلاتا ہے۔
• کسی ایجنٹ ایپلیکیشن کو اپ گریڈ کرنے کے بعد اسی ایپلیکیشن میں اسکلز/رولز کی دریافت کی تصدیق کریں۔ سنٹیکس/برابری کی جانچیں لوڈر کی جانچ کا متبادل نہیں۔ اگر کوئی موجودہ سیشن پرانا کیٹلاگ برقرار رکھے تو ایپلیکیشن دوبارہ لوڈ کریں۔
• ہکس کے لیے ہارنیس میں پروجیکٹ پر اعتماد اور ہک کا جائزہ درکار ہے؛ کسی جانچ کو پاس کرانے کے لیے اعتماد کو بائی پاس نہ کریں۔ دیکھیں hooks-setup.md۔

مفید ہدایات کی دیکھ بھال

OpenAI کی اسکلز اور پرامپٹس سے متعلق رہنمائی پر عمل کریں (2026-09-12 کو جائزہ لیا گیا): وضاحتیں دو ٹوک رکھیں، تفصیلات صرف متعلقہ ہونے پر لوڈ کریں، اور صارف کے مطلوبہ دائرے کو برقرار رکھیں۔ مشترکہ اسکلز مختلف ماڈلز کے کام آتی ہیں؛ معمول کے نفاذی انتخاب کی گنجائش دیتے ہوئے پروجیکٹ سے مخصوص اٹل اصول برقرار رکھیں۔

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

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

ٹولز اور براؤزر کی ملکیت

موجودہ اسکل/ٹول کیٹلاگ اور پروجیکٹ میں انسٹال شدہ CLIs کو ترجیح دیں۔ GitHub کے لیے gh، براؤزر تصدیق کے لیے playwright-cli، اور جب لائبریری کا رویہ اہم ہو تو سرکاری/ورژن سے مخصوص دستاویزات استعمال کریں۔ دہری اسکلز انسٹال کرنے، یا محض کسی موجودہ فارمیٹر کو چلانے کے لیے غیر پن شدہ پیکیج لانے سے گریز کریں۔

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

تمام براؤزر سیشنز ./scripts/pw-session.sh استعمال کرتے ہیں، جو پوری مشین پر ایک ہی فعال براؤزر کی پابندی نافذ کرتا ہے۔ بطورِ ڈیفالٹ ایک نیا الگ تھلگ سیشن استعمال کریں۔ موجودہ ذاتی براؤزر تک رسائی کے لیے صریح اجازت درکار ہے؛ بعد کے مراحل میں وہی اجازت دوبارہ استعمال کریں۔ متاثرہ رویے کے مطابق براؤزرز/ویو پورٹس منتخب کریں، منتخب انجن یکے بعد دیگرے چلائیں، صفائی میں بالکل اسی نام والا سیشن بند کریں، اور close-all/kill-all کبھی استعمال نہ کریں۔ دیکھیں playwright-cli اسکل اور verification.md۔