نوشتن description اسکیل؛ چطور کاری کنیم دستیار اسکیل را پیدا کند

رایج‌ترین شکایت از اسکیل‌ها این است: «اسکیل را نصب کردم ولی دستیار هیچ‌وقت سراغش نمی‌رود.» تقریباً همیشه مشکل در یک جاست: description.

دستیار قبل از باز کردن هر اسکیل، فقط نام و توضیح آن را می‌بیند. اگر توضیح نگوید اسکیل برای چه کاری است و کی باید استفاده شود، دستیار دلیلی برای باز کردنش نمی‌بیند. این مقاله فرمولی است که برای همه‌ی اسکیل‌های این سایت استفاده کرده‌ام.

#فرمول: چه می‌کند + کی + کلمات کاربر + کی نه

یک description خوب چهار بخش دارد:

1. چه می‌کند: کار اصلی، با فعل و مشخص. «Designs and reviews 20px UI icons as SVG».
2. کی استفاده شود: موقعیت‌هایی که باید اسکیل را باز کند. «Use when the user asks for an icon, an icon set, or an icon review».
3. کلمات کاربر: واژه‌هایی که کاربران واقعاً به کار می‌برند، از جمله فارسی. «or mentions آیکون، آیکون‌ست».
4. کی نه: مرز با کارهای مشابه. «Not for logos or illustrations».

طبق مشخصات استاندارد، description حداکثر ۱۰۲۴ کاراکتر است. معمولاً ۳۰۰ تا ۶۰۰ کاراکتر کافی است.

#سوم‌شخص بنویسید

راهنمای رسمی Anthropic روی این تأکید دارد: description مستقیم وارد دستور سیستمی دستیار می‌شود، پس باید سوم‌شخص باشد. «Writes Persian UI copy» درست است؛ «I can help you write…» و «You can use this to…» نه.

#کلمات فارسی را فراموش نکنید

کاربر فارسی‌زبان می‌نویسد «یه پوستر برای کانالم بساز». اگر description فقط انگلیسی باشد، دستیار باید خودش ترجمه را حدس بزند. با آوردن چند کلمه‌ی فارسی رایج (پوستر، بنر، کاور، استوری) این حدس لازم نیست. همه‌ی اسکیل‌های این سایت هر دو زبان را در توضیحشان دارند.

#اشتباه‌های رایج

#چطور تست کنیم؟

description را با درخواست‌های واقعی بسنجید، نه با حدس. دو فهرست بنویسید:

• باید باز شود: ده درخواستی که کاربران واقعاً می‌نویسند، با کلمه‌های مختلف، فارسی و انگلیسی.
• نباید باز شود: ده درخواست شبیه که مال اسکیل دیگری است.

هر کدام را در گفتگوی تازه امتحان کنید و ببینید دستیار اسکیل را باز می‌کند یا نه. هر جا اشتباه کرد، کلمه یا مرز لازم را به description اضافه کنید.

#خلاصه

description آگهی اسکیل برای خود دستیار است: بگویید چه می‌کند، کی، با چه کلماتی و کی نه. سوم‌شخص بنویسید، کلمه‌ی فارسی اضافه کنید و با درخواست واقعی تست کنید. بقیه‌ی اصول نوشتن اسکیل را در ۹ اصل نوشتن یک اسکیل حرفه‌ای آورده‌ام.