SwiftUI Agent Skills गाइड

अगर केवल एक चुननी हो: Apple के लिखे मार्गदर्शन और कम API भ्रम के लिए ameyalambat128/swiftui-skills चुनें। व्यापक iOS इंजीनियरिंग कवरेज और सटीक फ़्रेमवर्क रूटिंग के लिए dpearson2699/swift-ios-skills चुनें। सबसे मज़बूत संयोजन: पहली लाइब्रेरी को तथ्य-स्रोत की परत बनाएँ और दूसरी से केवल वे 5–10 विशेषज्ञ skills इंस्टॉल करें जिनकी आपके प्रोजेक्ट को ज़रूरत है।

AI से बनाए गए SwiftUI कोड में सबसे आम समस्या अमान्य सिंटैक्स नहीं, बल्कि ऐसा कोड है जो केवल सही दिखता है: state का स्वामित्व साफ़ नहीं होता, navigation patterns पुराने होते हैं, concurrency की सीमाएँ अस्पष्ट होती हैं या कोई ऐसा API इस्तेमाल होता है जो मौजूद ही नहीं है। Agent Skills एक सामान्य मॉडल को Apple प्लेटफ़ॉर्म की स्पष्ट इंजीनियरिंग सीमाओं के साथ काम करने वाला सहयोगी बनाती हैं।

Agent Skill असल में क्या है?

Skill आमतौर पर एक डायरेक्टरी होती है जिसमें SKILL.md फ़ाइल होती है। यह Codex, Claude Code और Cursor जैसे कोडिंग एजेंट को बताती है कि किसी क्षमता को कब सक्रिय करना है, पहले कौन-से संदर्भ पढ़ने हैं, किन नियमों का पालन करना है और नतीजे का प्रारूप कैसा होना चाहिए। यह न Xcode एक्सटेंशन है, न Swift package। इसे AI के लिए टीम की इंजीनियरिंग पुस्तिका और किसी खास विषय के ज्ञान पैक का मेल समझें।

हर नियम वाली एक बहुत लंबी prompt के उलट, Skills केवल प्रासंगिक होने पर लोड हो सकती हैं। SwiftUI animation के काम में animation मार्गदर्शन आता है, commerce के काम में StoreKit की खरीद और verification के नियम आते हैं, और scrolling की समस्या debug करते समय performance मार्गदर्शन लोड होता है। काम के अनुसार मिला यह संदर्भ आमतौर पर ज़्यादा सटीक होता है और कम token इस्तेमाल करता है।

दोनों तरीकों पर एक नज़र

तरीका एक: Xcode दस्तावेज़ों को AI के लिए तथ्य का स्रोत बनाएँ

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

निकाली गई सामग्री केवल SwiftUI layout तक सीमित नहीं है। इसमें App Intents, AlarmKit, StoreKit, WebKit, SwiftData inheritance, Swift Concurrency, Liquid Glass, visionOS widgets और InlineArray तथा Span जैसी low-level performance primitives भी शामिल हैं।

ध्यान रखने योग्य सीमाएँ

• macOS और Xcode 26 या उसके बाद का संस्करण ज़रूरी है। दस्तावेज़ डायरेक्टरी भर जाने तक Skill को SwiftUI मार्गदर्शन नहीं देना चाहिए।
• यह एक व्यापक entry point है। जटिल प्रोजेक्ट में फिर भी केंद्रित अनुरोध चाहिए, जैसे “Apple दस्तावेज़ों के अनुसार state ownership और navigation की समीक्षा करें।”
• स्थानीय Xcode संस्करण संदर्भ का संस्करण तय करता है, इसलिए availability पर अलग निष्कर्षों से बचने के लिए टीम को एक जैसी toolchain इस्तेमाल करनी चाहिए।

तरीका दो: साथ मिलाकर इस्तेमाल की जा सकने वाली 84 iOS Skills

यह रिपॉज़िटरी सटीक routing में बेहतर है। आपको हर संदर्भ में Apple development का पूरा संग्रह नहीं चाहिए। SwiftData, StoreKit 2, App Intents और WidgetKit इस्तेमाल करने वाला subscription app उन Skills के साथ SwiftUI patterns, Swift Concurrency, testing और accessibility इंस्टॉल कर सकता है।

नीचे इस लेख के अपडेट के समय की पूरी 84-Skill सूची है। अपने project stack से कवरेज मिलाने के लिए हर समूह खोलें।

कैसे चुनें: संख्या से नहीं, काम से शुरू करें

स्थिति A: SwiftUI के लिए AI का इस्तेमाल शुरू करना

Apple दस्तावेज़ों की सीमाओं के लिए पहले swiftui-skills इंस्टॉल करें। फिर 84-Skill संग्रह से swiftui-patterns, swiftui-navigation, swift-concurrency, swift-testing और ios-accessibility जोड़ें। ये पाँच नई परियोजनाओं में सबसे आम समस्याओं को कवर करती हैं।

स्थिति B: किसी मौजूदा प्रोडक्ट में फ़ीचर बनाना

उस तकनीक के आधार पर चुनें जिसका अभी इस्तेमाल हो रहा है, उस आधार पर नहीं जो किसी दिन काम आ सकती है। subscriptions के लिए storekit जोड़ें। system surfaces के लिए app-intents और widgetkit जोड़ें। अधिक data वाले apps के लिए swiftdata या core-data और on-device AI products के लिए apple-on-device-ai जोड़ें।

स्थिति C: code review और reliability का काम

swiftui-performance, debugging-instruments, metrickit, swift-security, ios-accessibility और app-store-review को प्राथमिकता दें। यह सेट code generator से ज़्यादा release gatekeeper की तरह काम करता है।

इंस्टॉलेशन: सामान्य एजेंट और Codex

स्थानीय Apple दस्तावेज़ों वाली Skill इंस्टॉल करें

# सीधे इंस्टॉल करें और Xcode से दस्तावेज़ निकालें
curl -fsSL https://swiftui-skills.ameyalambat.com/install | bash

# या skills CLI इस्तेमाल करें
npx skills add ameyalambat128/swiftui-skills

किसी remote script को shell में pipe करने से पहले रिपॉज़िटरी में installer की समीक्षा करें। इंस्टॉलेशन के बाद, इंस्टॉल की गई Skill डायरेक्टरी से setup.sh चलाएँ और agent session को restart करें, ताकि वह नई Skill खोज सके।

84-Skill संग्रह से अपनी पसंद की Skills चुनें

# interactive picker खोलें और Skills तथा target agents चुनें
npx skills add dpearson2699/swift-ios-skills

# केवल चुनी हुई क्षमताएँ इंस्टॉल करें
npx skills add dpearson2699/swift-ios-skills \
  --skill swiftui-patterns \
  --skill swift-concurrency \
  --skill swift-testing

# जाँचें और अपडेट करें
npx skills check
npx skills update

Codex में एक Skill इंस्टॉल करें

$skill-installer install \
  https://github.com/dpearson2699/swift-ios-skills/tree/main/skills/swiftui-patterns

आखिरी डायरेक्टरी को सूची में दिए किसी भी Skill नाम से बदलें। प्रोजेक्ट के खास नियम project scope में होने चाहिए। दोबारा इस्तेमाल किया जा सकने वाला SwiftUI और engineering मार्गदर्शन personal shared scope में होना चाहिए।

ज़्यादा भरोसेमंद संयुक्त वर्कफ़्लो

1. लक्ष्य और deployment target बताएँ। एजेंट को बताएँ कि काम कोई feature, refactor या review है। minimum iOS version भी बताएँ, ताकि नए APIs बिना शर्त इस्तेमाल न हों।
2. तथ्य-स्रोत की परत को पहले दस्तावेज़ चुनने दें। swiftui-skills से काम में इस्तेमाल किए गए Apple दस्तावेज़ों और availability constraints की सूची माँगें।
3. केवल काम से जुड़ी Skills लोड करें। पूरे catalog को एक काम में जोड़ने के बजाय navigation के लिए swiftui-navigation और खरीद के लिए storekit इस्तेमाल करें।
4. पूरी जाँच की माँग करें। एजेंट से target build करने, tests चलाने और UI changes के लिए Dynamic Type, VoiceOver तथा dark mode जाँचने को कहें।
5. निर्णयों को project rules में दर्ज करें। बार-बार आने वाले architecture decisions हर काम में दोबारा तय करने के बजाय project Skill या AGENTS.md में होने चाहिए।

दोबारा इस्तेमाल की जा सकने वाली task prompt इस तरह शुरू हो सकती है:

Use local Apple documentation as the API source of truth,
and use swiftui-patterns, swift-concurrency, and swift-testing.
Goal: implement a testable asynchronous loading screen for an iOS 26 app.
List the selected documentation and state ownership first, then modify the code, build, and run tests.
Do not introduce an architecture that the project does not already use.

संस्करण और लाइसेंस: आखिरी दो जाँच

Apple प्लेटफ़ॉर्म APIs तेज़ी से बदलते हैं। इस लेख की जाँच July 6, 2026 के swiftui-skills commit और July 4, 2026 के swift-ios-skills commit के अनुसार की गई थी। रिपॉज़िटरी की सामग्री, समर्थित संस्करण और Skill की संख्या बदल सकती है। beta frameworks को हमेशा मौजूदा Xcode SDK से जाँचें।

लाइसेंस भी अलग हैं: swiftui-skills MIT इस्तेमाल करता है, जबकि swift-ios-skills PolyForm Perimeter 1.0.0 इस्तेमाल करता है। यह app development और closed-source commercial workflows की अनुमति देता है, लेकिन सामग्री को किसी प्रतिस्पर्धी प्रोडक्ट के रूप में दोबारा पैक करने पर रोक लगाता है। टीम में वितरण, बदलाव या commercial integration से पहले upstream LICENSE पढ़ें।

अक्सर पूछे जाने वाले सवाल

क्या SwiftUI Agent Skills आधिकारिक Apple दस्तावेज़ों की जगह लेती हैं?

नहीं। Skill एजेंट को सही समय पर नियम लोड और लागू करने में मदद करती है। API की अंतिम availability, platform behavior और review requirements को फिर भी मौजूदा Xcode SDK और Apple की आधिकारिक सामग्री से जाँचना चाहिए।

क्या मैं दोनों Skill लाइब्रेरी इंस्टॉल कर सकता हूँ?

हाँ। दोनों एक-दूसरे की पूरक हैं: एक स्थानीय Apple दस्तावेज़ों का तथ्य-स्रोत देती है, जबकि दूसरी किसी खास framework और engineering के workflows देती है। सब कुछ डिफ़ॉल्ट रूप से इंस्टॉल करने के बजाय हर प्रोजेक्ट के लिए Skills चुनें।

क्या सभी 84 Skills इंस्टॉल करना बेहतर है?

ज़रूरी नहीं। Apple प्लेटफ़ॉर्म के कई प्रोजेक्ट संभालने वाली टीम को इसका लाभ मिल सकता है, लेकिन एक प्रोडक्ट में बार-बार इस्तेमाल होने वाली पाँच से दस Skills रखना आमतौर पर ज़्यादा स्पष्ट होता है। इससे यह पता लगाना भी आसान होता है कि मार्गदर्शन कहाँ से आया।

क्या ये Skills केवल Codex के लिए हैं?

नहीं। दोनों रिपॉज़िटरी Codex, Claude Code और Cursor सहित कई एजेंट का समर्थन करती हैं। इंस्टॉलेशन path और discovery mechanism हर एजेंट के मौजूदा संस्करण पर निर्भर करते हैं।