नाम और दायरा चुनना

एक skill, एक काम

हर skill के लिए एक सुसंगत काम का लक्ष्य रखें: "release-notes", "pr-review", "db-migration-check", "browser-automation"। जो skill पाँच असंबंधित काम करना चाहे उसका description अस्पष्ट होता है, ग़लत trigger होता है और बनाए रखना कठिन; तीखे descriptions वाली पाँच छोटी skills एक विशाल से बेहतर चलती हैं। नाम छोटे अक्षरों और hyphens वाले, वर्णनात्मक और folder नाम से मेल खाते हों; ऐसे क्रिया-या-संज्ञा वाक्यांश पसंद करें जो आप बोलकर कहते ("pr-review"), चतुर नामों से बचें। दायरे की सीमा स्पष्ट तय करें: skill क्या नहीं करती ("deploy नहीं करती; सिर्फ़ तैयारी जाँचती है")। दो skills एक ही अनुरोध से मेल खा सकें तो या तो उन्हें मिलाएँ, उनके descriptions तीखे करें ताकि वे अलग हों, या एक को नाम लेकर दूसरी को सौंपने दें।

नाम दें, वर्णन करें, संरचना दें

Description तय करता है कि skill उपयोग होगी या नहीं; body तय करती है कि वह चलेगी या नहीं।

अच्छे और ख़राब नाम व दायरे

ऐसे नाम जो बताएँ skill क्या करती है, और दायरे जो बताएँ क्या नहीं।

POOR                      BETTER                       why
helper                    release-notes                says what it does
my_skill_v2               pr-review                    lowercase, hyphens, no version in the name
devops-everything         deploy-check, rollback-plan  one job each, sharp descriptions
stuff                     db-migration-check           discoverable by name and by description

Scope line in the body:  "Does NOT deploy or modify files; it only reports readiness."

त्वरित जाँच: एक विशाल skill की जगह कई छोटी skills क्यों पसंद करें?

• छोटी skills हमेशा तेज़ हैं
• तीखे descriptions सही trigger होते हैं और बनाए रखना आसान है
• विशाल skills की अनुमति नहीं
• यह files की संख्या शून्य करता है