Codex में potato-skill सेट अप कीजिए
एक npx कमांड से potato-skill को Codex प्रोजेक्ट में जोड़िए, स्किल को $potato-skill से शुरू कीजिए, और वे कमांड मंज़ूर कीजिए जिन्हें डिफ़ॉल्ट सैंडबॉक्स रोक लेता है।
Codex स्किल आपकी रिपॉज़िटरी के .agents/skills/ से पढ़ता है, और npx skills add davidjurgens/potato-skill --agent codex potato-skill को वहीं कॉपी करता है। Codex स्किल को बिना रीस्टार्ट के उठा लेता है, और $potato-skill CLI और IDE एक्सटेंशन में स्किल को शुरू करता है। स्किल अध्ययन के साथ क्या करती है, यह कोडिंग एजेंट के साथ त्वरित शुरुआत में है, और दूसरे एजेंट के लिए अपने कोडिंग एजेंट में potato-skill इंस्टॉल कीजिए देखिए।
इंस्टॉल करने से पहले
Potato उसी Python वातावरण में इंस्टॉल कीजिए जिसका Codex का शेल इस्तेमाल करता है। स्किल की हेल्पर स्क्रिप्ट Potato की रजिस्ट्री इम्पोर्ट करती हैं और potato कमांड को बुलाती हैं, और स्किल का पहला चरण जाँचता है कि Potato इम्पोर्ट हो पाता है। ब्राउज़र extra और Chromium की मदद से potato preview --screenshot और स्किल की वॉकथ्रू स्क्रिप्ट टास्क को हेडलेस ब्राउज़र में खोल पाती हैं:
pip install 'potato-annotation[preview]'
playwright install chromiumCodex के डिफ़ॉल्ट सैंडबॉक्स में नेटवर्क एक्सेस नहीं है। मंज़ूरी का एक दौर बचाने के लिए दोनों शुरू करने से पहले इंस्टॉल कर लीजिए। skills CLI npx से चलता है और उसे Node.js 22.20 या उसके बाद का वर्शन चाहिए।
स्किल इंस्टॉल करना
इंस्टॉल अपनी रिपॉज़िटरी में चलाइए:
npx skills add davidjurgens/potato-skill --agent codexकमांड SKILL.md, 30 संदर्भ फ़ाइलें और नौ हेल्पर स्क्रिप्ट को .agents/skills/potato-skill/ में कॉपी करता है, और स्रोत को रिपॉज़िटरी की जड़ में skills-lock.json में दर्ज करता है। Codex मौजूदा फ़ोल्डर से लेकर रिपॉज़िटरी की जड़ तक हर फ़ोल्डर में .agents/skills/ खंगालता है, इसलिए रिपॉज़िटरी के किसी सबफ़ोल्डर में शुरू किया सेशन भी स्किल पा लेता है। .agents/skills/ कमिट करने से सहयोगियों को स्किल बिना किसी इंस्टॉल चरण के मिल जाती है।
इसके बजाय मशीन की हर रिपॉज़िटरी के लिए स्किल इंस्टॉल करने के लिए -g जोड़िए:
npx skills add davidjurgens/potato-skill --agent codex -gग्लोबल इंस्टॉल ~/.agents/skills/potato-skill/ में जाता है, जो Codex का उपयोगकर्ता-स्तर का स्किल फ़ोल्डर है। Codex नई स्किल को बिना रीस्टार्ट के पहचान लेता है। स्किल न दिखे तो Codex रीस्टार्ट कीजिए।
इंस्टॉल जाँचना
Codex CLI या IDE एक्सटेंशन में /skills वे स्किल सूचीबद्ध करता है जो Codex को मिलीं, और potato-skill सूची में दिखती है। ChatGPT डेस्कटॉप ऐप में साइडबार का Skills आपके सभी प्रोजेक्ट की स्किल दिखाता है।
अध्ययन शुरू करना
$potato-skill से स्किल का ज़िक्र कीजिए और अध्ययन का विवरण दीजिए:
$potato-skill I want 200 tweets labeled for sentiment on a 5-point scale by three annotators each, with a consent page and two attention checks. Build it and start it.जब कोई अनुरोध स्किल के विवरण से मेल खाता है, जैसे एनोटेशन टास्क बनाना, Potato का config.yaml बदलना या चल रहे अध्ययन की स्थिति देखना, तब Codex स्किल को ज़िक्र के बिना भी लोड करता है।
सैंडबॉक्स और मंज़ूरियाँ
Codex कमांड सैंडबॉक्स में चलाता है। डिफ़ॉल्ट मोड workspace-write कमांड को वर्कस्पेस के भीतर लिखने देता है, नेटवर्क एक्सेस बंद रखकर। नेटवर्क के पीछे की सेटिंग sandbox_workspace_write.network_access है, जिसका डिफ़ॉल्ट false है। on-request मंज़ूरी नीति में Codex सैंडबॉक्स के भीतर काम करता है और कोई कमांड सैंडबॉक्स से बाहर जाने लगे तो पूछता है।
अध्ययन बनाते समय स्किल Codex से कॉन्फ़िग वैलिडेट करवाती है, आपकी मशीन पर Potato सर्वर शुरू करवाती है, टास्क को हेडलेस ब्राउज़र में खुलवाती है और स्किल की हेल्पर स्क्रिप्ट चलवाती है। pip install को नेटवर्क चाहिए, और डिफ़ॉल्ट सैंडबॉक्स में नेटवर्क नहीं है। Codex पूछे तो कमांड पढ़कर उसे सैंडबॉक्स के बाहर चलाने की मंज़ूरी दीजिए। CLI में /permissions अनुमतियों का पिकर खोलता है। IDE एक्सटेंशन और ऐप में वही विकल्प कंपोज़र के नीचे Ask for approval, Approve for me और Full access के रूप में हैं। हर मोड का ब्योरा Codex के सैंडबॉक्सिंग दस्तावेज़ में है।
AGENTS.md
Codex AGENTS.md को फ़ाइल के नाम से पढ़ता है। potato-skill रिपॉज़िटरी की जड़ में एक AGENTS.md है, जो स्किल के नियमों का संक्षिप्त सार है। इस फ़ाइल को अपनी रिपॉज़िटरी की जड़ में कॉपी करने से Codex को नियम बिना किसी इंस्टॉल चरण के मिल जाते हैं। फ़ाइल उन संदर्भ फ़ाइलों और स्क्रिप्ट की ओर इशारा करती है जो सिर्फ़ पूरा इंस्टॉल डिस्क पर रखता है। अध्ययन बनाने के लिए skills CLI वाला इंस्टॉल इस्तेमाल कीजिए। आपकी रिपॉज़िटरी में पहले से AGENTS.md हो तो फ़ाइल को बदलने के बजाय सार को उसी फ़ाइल में जोड़िए।
स्किल को अपडेट करना और हटाना
skills CLI स्किल को नाम से अपडेट करता और हटाता है। ग्लोबल इंस्टॉल के लिए किसी भी कमांड में -g जोड़िए:
npx skills update potato-skill
npx skills remove potato-skillupdate इंस्टॉल की गई कॉपी को GitHub रिपॉज़िटरी से मिलाकर जाँचता है, और रिपॉज़िटरी बदली हो तो कॉपी बदल देता है। remove .agents/skills/potato-skill/ और skills-lock.json में स्किल की प्रविष्टि मिटा देता है।
स्किल को मिटाए बिना बंद करने के लिए ~/.codex/config.toml में स्किल की SKILL.md के पूर्ण पथ के साथ एक प्रविष्टि जोड़िए और Codex रीस्टार्ट कीजिए। प्रविष्टि जो दूसरी सेटिंग्स लेती है, वे Codex के स्किल दस्तावेज़ में हैं:
[[skills.config]]
path = "/path/to/your/repo/.agents/skills/potato-skill/SKILL.md"
enabled = false