मुख्य कंटेंट तक स्किप करें

स्किल्स और टूल्स

साझा स्किल्स .agents/skills/ में रहती हैं। इन्हीं सोर्स को संपादित करें, फिर Claude Code के लिए .claude/skills/ जनरेट करने हेतु yarn ai-workflow:sync चलाएँ। Codex सीधे .agents/skills/ में स्किल्स ढूँढता है।

साझा रोल प्रॉम्प्ट .agents/roles/*.md में रहते हैं। यह रिपॉज़िटरी-विशिष्ट सोर्स फ़ॉर्मैट है, कोई नेटिव एजेंट डिस्कवरी पथ नहीं। scripts/ai-workflow-files.mjs इन सोर्स को नीचे दी गई ऐप-विशिष्ट फ़ाइलों में बदलती है; yarn ai-workflow:sync उन्हें लिखता है। जनरेट की गई फ़ाइलों को उनके सोर्स के साथ कमिट करें, ताकि नए चेकआउट में पहले कोई जनरेटर चलाए बिना नेटिव कॉन्फ़िगरेशन मौजूद रहे। कोई सोर्स हटाने के बाद उसके अप्रचलित जनरेट किए गए आउटपुट स्पष्ट रूप से हटाएँ; वैलिडेटर फ़ाइलें चुपचाप मिटाने के बजाय उनकी रिपोर्ट करता है।

नेटिव डिस्कवरी पथ​

2026-09-12 को आधिकारिक दस्तावेज़ों से सत्यापित:

ऐपप्रोजेक्ट निर्देशइस रिपॉज़िटरी द्वारा इस्तेमाल की जाने वाली स्किल्सइस रिपॉज़िटरी द्वारा इस्तेमाल किए जाने वाले कस्टम एजेंट
CodexAGENTS.md.agents/skills/<name>/SKILL.mdजनरेट की गई .codex/agents/<name>.toml
Claude CodeCLAUDE.md, @AGENTS.md को इंपोर्ट करता हैजनरेट की गई .claude/skills/<name>/SKILL.mdजनरेट की गई .claude/agents/<name>.md

स्रोत: Codex स्किल्स, Codex सबएजेंट, Claude मेमोरी, Claude स्किल्स, Claude सबएजेंट।

नेटिव एजेंट डायरेक्टरियों की जगह .agents/roles न रखें, और यह न मानें कि Claude .agents/skills को खोज लेता है। वहाँ की किसी संदर्भित फ़ाइल को Claude फिर भी सामान्य प्रोजेक्ट कॉन्टेक्स्ट की तरह पढ़ सकता है।

AI डायरेक्टरियाँ .gitattributes के ज़रिए LF लाइन एंडिंग इस्तेमाल करती हैं, ताकि जनरेट किया गया टेक्स्ट सभी प्लेटफ़ॉर्म पर एक जैसा रहे। स्किल की सहायक एसेट फ़ाइलें बाइट-दर-बाइट कॉपी की जाती हैं।

स्किल्स​

स्किलउद्देश्य
commitअधिकृत, सीमित दायरे वाले लोकल कमिट बनाना
commit-format, issue-formatअनुरोध किए जाने पर सुझावों को फ़ॉर्मैट करना
make-closed-issueअधिकृत इश्यू, सीमित दायरे वाला कमिट और PR बनाना
review-and-merge-prPR फ़ीडबैक की छँटाई; ठीक करना/प्रकाशित करना/मर्ज करना केवल अनुरोधित दायरे में
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 के लिए कस्टम रोल बनाए रखें। सामान्य इंप्लीमेंटेशन और कोड खोज के लिए हार्नेस का बिल्ट-इन worker/general-purpose या explorer रोल इस्तेमाल करें। पैरेंट स्वीकृति मानदंड और स्वामित्व तय करता है; भारी जाँचें एक ही स्वामी चलाता है।

Codex एजेंट फ़ाइलों में name, description और developer_instructions होते हैं। .codex/config.toml, max_concurrent_threads_per_session के ज़रिए एक साथ चलने वाले चाइल्ड एजेंटों की संख्या चार तक सीमित करता है। साझा रोल मेटाडेटा में नाम, विवरण और वैकल्पिक सैंडबॉक्स मोड होता है; उसमें जानबूझकर कोई मॉडल फ़ील्ड नहीं है।

कमिट की गई स्किल्स और कस्टम एजेंटों से मॉडल और रीज़निंग फ़ील्ड बाहर रखें। इससे हर ऐप की दस्तावेज़ित प्राथमिकता के अनुसार रनटाइम पर इनवोकेशन के विकल्प, उपयोगकर्ता के डिफ़ॉल्ट और पैरेंट से विरासत लागू हो पाते हैं। Claude फ़ैमिली उपनाम संस्करणों के रखरखाव का बोझ घटाते हैं, पर फिर भी एक फ़ैमिली चुन लेते हैं। ज़रूरत हो तो ऐसे विकल्प उपयोगकर्ता/सेशन सेटिंग्स में रखें। विरासत इस बात का वादा नहीं करती कि मौजूदा सबसे अच्छा मॉडल अपने आप चुना जाएगा। कोई latest उपनाम न गढ़ें, और रोज़मर्रा के कामों में मॉडल-कैटलॉग की खोजबीन न जोड़ें। देखें Codex में चयन और Claude में चयन।

sandbox-mode: read-only Codex के सैंडबॉक्स से मैप होता है। Claude की टूल सूची और रोल निर्देश उसके रिव्यू वर्कफ़्लो को सीमित करते हैं, पर Bash पहुँच कोई OS-स्तरीय सैंडबॉक्स नहीं है।

जहाँ लागू हो, उपयोगकर्ता द्वारा चलाए जाने वाले वर्कफ़्लो के लिए साझा स्किल फ़्रंटमैटर 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 में रखें। किसी खास मोड से जुड़े बड़े कमांड या उदाहरणों को वैकल्पिक संदर्भों के रूप में लिंक करें। छोटे विवरणों में ट्रिगर की शर्तें शुरुआत में रखें; केवल किसी कीवर्ड के मेल खा जाने से काम का दायरा नहीं बढ़ना चाहिए। मौजूदा इनवोकेशन मेटाडेटा को बनाए रखें, जब तक उसका व्यवहार जानबूझकर न बदला जा रहा हो।

निर्देशों में बड़े बदलाव के बाद कुछ प्रतिनिधि छोटे और बड़े अनुरोध आज़माकर देखें। जाँचें कि कौन-सी स्किल्स/संदर्भ चुने गए, कार्रवाइयाँ दायरे के भीतर रहीं या नहीं, सत्यापन बदलाव के अनुरूप था या नहीं, और अधिकृत काम पूरा हुआ या नहीं। स्कीमा और फ़िक्स्चर परीक्षण टूलिंग की शुद्धता स्थापित करते हैं, एजेंट के निर्णयों की गुणवत्ता नहीं।

टूल्स और ब्राउज़र स्वामित्व​

मौजूदा स्किल/टूल कैटलॉग और प्रोजेक्ट में इंस्टॉल किए गए CLI को प्राथमिकता दें। GitHub के लिए gh, ब्राउज़र सत्यापन के लिए playwright-cli, और जब लाइब्रेरी का व्यवहार मायने रखता हो तब आधिकारिक/संस्करण-विशिष्ट दस्तावेज़ इस्तेमाल करें। डुप्लिकेट स्किल्स इंस्टॉल करने से, या केवल किसी मौजूदा फ़ॉर्मैटर को चलाने के लिए कोई अनपिन्ड पैकेज लाने से बचें।

MCP का ओवरहेड हार्नेस पर निर्भर करता है: टूल्स की डिफ़र्ड लोडिंग हर स्कीमा को पहले से लोड करने से बचा सकती है। MCP को ही अप्रचलित मानने के बजाय इंटीग्रेशन को प्रासंगिक रखें। मौजूदा CLI विकल्प पुनरुत्पादन-योग्यता और संसाधन नियंत्रण के लिए उपयोगी बने रहते हैं।

सभी ब्राउज़र सेशन ./scripts/pw-session.sh इस्तेमाल करते हैं, जो पूरी मशीन पर एक समय में एक ही सक्रिय ब्राउज़र की शर्त लागू करती है। डिफ़ॉल्ट रूप से एक नया, अलग-थलग सेशन लें। मौजूदा निजी ब्राउज़र तक पहुँच के लिए स्पष्ट अनुमति चाहिए; आगे के चरणों में वही अनुमति दोबारा इस्तेमाल करें। प्रभावित व्यवहार के अनुसार ब्राउज़र/व्यूपोर्ट चुनें, चुने हुए इंजन क्रमवार चलाएँ, सफ़ाई में ठीक उसी नाम वाला सेशन बंद करें, और कभी close-all/kill-all इस्तेमाल न करें। playwright-cli स्किल और verification.md देखें।