چطور اسکیل سفارشی کلاد بسازیم؟

یه بار امتحان کن: به‌جای اینکه خودت کار کنی به هوش مصنوعی یاد بده تا برات انجام بده.

فرقش از زمین تا آسمونه.

یعنی تو باید اسکیل (مهارت) خودت رو بهش آموزش بدی. این با پرامپت نویسی فرق داره و یه فرآیند کامل هست؛

دقیقا باید همون چیزی که توی ذهنت موقع کار کردن اتفاق می‌افته رو تیکه‌تیکه بهش یاد بدی.

توی این راهنما، قدم‌به‌قدم نشونت می‌دم چطور همین اتفاق رو برای مهارت خودت رقم بزنی.

اسکیل‌ها برای کاربرای همه پلن‌های کلاد در دسترسه. این قابلیت نیاز به فعال بودن Code Execution داره.

اول باید چکار کنی؟

۱. رفتن به تنظیمات و روشن کردن Code Execution
تو Claude برو به Settings > Capabilities و مطمئن شو گزینه‌ی “Code execution and file creation” روشنه. این قابلیت رو وب، دسکتاپ و موبایل روی همه‌ی پلن‌ها در دسترسه؛ فقط باید فعالش کنی.

۲. فعال کردن خود اسکیل‌ها
بعد از این، برو به Customize > Skills و اسکیل‌هایی که می‌خوای رو (چه اسکیل‌های آماده مثل PDF یا Excel، چه اسکیل سفارشی که خودت آپلود می‌کنی) روشن کن. بدون این مرحله، حتی اگه Code execution روشن باشه، کلود از اون اسکیل خاص استفاده نمی‌کنه.

خلاصه ترتیب کار:

1. Settings > Capabilities → روشن کردن Code execution and file creation
2. Customize > Skills → روشن کردن اسکیل مورد نظر (آماده یا سفارشی)

اسکیل‌های سفارشی بهت این امکان رو می‌دن که کلود رو با دانش تخصصی و روش کاری مخصوص سازمان یا استایل شخصیت تقویت کنی.

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

اسکیل‌ها می‌تونن خیلی ساده باشن، فقط چندتا خط دستورالعمل، یا خیلی پیچیده، شامل چندتا فایل با کدهای اجرایی. بهترین اسکیل‌ها این ویژگی‌ها رو دارن:

• یه کار مشخص و تکرارشونده رو حل می‌کنن
• دستورالعمل‌های واضحی دارن که کلود بتونه دنبالش کنه
• در صورت نیاز، مثال دارن
• مشخص می‌کنن کِی باید استفاده بشن
• روی یه روش کاری تمرکز دارن، نه اینکه بخوان همه‌چیز رو با هم انجام بدن

ضبط کردن اسکیل

۱. نوشتن دستی فایل skill.md 

یه فایل بساز، توش یه فایل skill.md با متادیتای name و description بنویس (مثل مثالی که در ادامه اومده)، دستورالعمل‌ها رو به مارک‌داون اضافه کن، در صورت نیاز فایل‌ها و اسکریپت کمکی هم بذار، بعد زیپش کن و از طریق Customize > Skills آپلودش کن.

۲. ساخت اسکیل با کمک خود کلود (بدون نوشتن دستی)

می‌تونی تو Customize > Skills رو دکمه‌ی “+” بزنی و “Create skill” رو انتخاب کنی. اونجا معمولاً گزینه‌ای مثل “Create with Claude” هست؛ یعنی به‌جای اینکه خودت skill.md بنویسی، فقط با زبون خودت (فارسی هم می‌تونی) توضیح می‌دی که اسکیل قراره چیکار کنه و کِی استفاده بشه، و کلود خودش فایل و ساختارش رو می‌سازه. این عملاً همون نتیجه‌ی ضبط کردنه، فقط به‌جای نشون دادن با ویدیو، با توضیح متنی انجامش می‌دی.

۳. تکمیل یه اسکیل تو یه مکالمه‌ی معمولی

یه روش دیگه اینه که یه کار رو تو یه مکالمه با کلود انجام بدی و در پایان از کلود بخوای که “این روند رو به یه اسکیل تبدیل کن”. کلود از روی خود مکالمه ساختار و دستورالعمل رو استخراج می‌کنه.

ساخت فایل skill.md

هر اسکیل حداقل از یه فایل تشکیل شده که یه فایل skill.md توش هست، و این فایل هسته‌ی اصلی اسکیله. این فایل باید با یه YAML frontmatter شروع بشه که فیلدهای name و description رو نگه می‌داره؛ این دوتا متادیتای اجباری هستن. علاوه بر این می‌تونه شامل متادیتای اضافه، دستورالعمل برای کلود یا فایل‌های مرجع، اسکریپت‌های اجرایی یا ابزار (tools) هم باشه.

فیلدهای متادیتای اجباری

• name: یه اسم قابل‌فهم برای اسکیلت (حداکثر ۶۴ کاراکتر) مثال: Brand Guidelines
• description: یه توضیح واضح از اینکه این اسکیل چیکار می‌کنه و کِی باید استفاده بشه. این خیلی مهمه—کلود از همین برای تشخیص اینکه کِی اسکیلت رو صدا بزنه استفاده می‌کنه (حداکثر ۲۰۰ کاراکتر). مثال: Apply Acme Corp brand guidelines to presentations and documents, including official colors, fonts, and logo usage.

فیلدهای متادیتای اختیاری

• dependencies: پکیج‌های نرم‌افزاری که اسکیلت بهشون نیاز داره. مثال: python>=3.8, pandas>=1.5.0

متادیتای فایل skill.md اولین لایه‌ی یه سیستم “افشای تدریجی” (progressive disclosure) هست؛ یعنی دقیقاً همون مقدار اطلاعاتی که کلود لازم داره بفهمه کِی باید از اسکیل استفاده کنه رو بهش می‌ده، بدون اینکه لازم باشه کل محتوا رو بخونه.

بدنه‌ی مارک‌داون

بدنه‌ی مارک‌داون، لایه‌ی دوم جزئیاته که بعد از متادیتا میاد؛ یعنی کلود در صورت نیاز، بعد از خوندن متادیتا سراغ این می‌ره. بسته به کاری که داری انجام می‌دی، کلود می‌تونه به فایل skill.md دسترسی داشته باشه و از اسکیل استفاده کنه.

مثال یه فایل skill.md:

اسکیل راهنمای برند

## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents

## Overview
این اسکیل راهنمای رسمی برند Acme Corp رو ارائه می‌ده...

## Brand Colors
رنگ‌های رسمی برند ما اینا هستن:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)

## Typography
Headers: Montserrat Bold
Body text: Open Sans Regular

## Logo Usage
همیشه لوگوی رنگی رو رو پس‌زمینه‌ی روشن استفاده کن...

## When to Apply
این راهنما رو موقع ساخت این‌ها اعمال کن:
- ارائه‌های پاورپوینت
- سندهای ورد برای اشتراک‌گذاری بیرونی
- محتوای مارکتینگ
- گزارش‌های مشتری

اضافه کردن منابع

اگه اطلاعات بیشتری داری که تو یه فایل skill.md جا نمی‌شه (مثلاً بخش‌هایی که فقط تو موقعیت‌های خاص کاربرد دارن)، می‌تونی با اضافه کردن فایل‌های دیگه به فایل اسکیلت، محتوا اضافه کنی. مثلاً یه فایل REFERENCE.md بساز که اطلاعات تکمیلی و مرجع رو نگه می‌داره. با اشاره کردن بهش تو skill.md، به کلود کمک می‌کنی تصمیم بگیره آیا موقع اجرای اسکیل بهش نیاز داره یا نه.

اضافه کردن اسکریپت

برای اسکیل‌های پیشرفته‌تر، می‌تونی فایل‌های کد اجرایی به skill.md وصل کنی تا کلود بتونه کد اجرا کنه. مثلاً اسکیل‌های سند ما از این زبان‌ها و پکیج‌ها استفاده می‌کنن:

• پایتون (pandas، numpy، matplotlib)
• جاوااسکریپت/Node.js
• پکیج‌هایی برای کمک به ویرایش فایل
• ابزارهای بصری‌سازی (visualization)

نکته: کلود و Claude Code می‌تونن موقع لود شدن اسکیل، پکیج‌ها رو از مخازن استاندارد (پایتون PyPI، جاوااسکریپت npm) نصب کنن. اما امکان نصب پکیج‌های اضافه در زمان اجرا برای API Skills وجود نداره—همه‌ی وابستگی‌ها باید از قبل تو کانتینر نصب شده باشن.

پکیج کردن اسکیل

وقتی فایل اسکیلت کامل شد:

1. مطمئن شو اسم فایل با اسم اسکیلت یکی باشه.
2. یه فایل ZIP از اون فایل بساز.
3. زیپ باید فایل اسکیل رو به‌عنوان ریشه داشته باشه (نه یه فایل).

ساختار درست:

my-skill.zip
  └── my-skill/
      ├── skill.md
      └── resources/

ساختار غلط:

my-skill.zip
  └── (فایل‌ها مستقیم تو ریشه‌ی زیپ)

تست کردن اسکیل

قبل از آپلود

1. فایل skill.md رو از نظر وضوح بازبینی کن.
2. مطمئن شو description دقیقاً منعکس‌کننده‌ی این باشه که کلود کِی باید از اسکیل استفاده کنه.
3. چک کن همه‌ی فایل‌های ارجاع‌شده، تو محل درستشون موجود باشن.
4. با چندتا پرامپت نمونه تست کن تا مطمئن بشی کلود درست اسکیل رو صدا می‌زنه.

بعد از آپلود کردن به کلود

1. اسکیل رو تو Customize > Skills فعال کن.
2. چندتا پرامپت مختلف که باید اسکیل رو فعال کنن رو امتحان کن.
3. فرآیند فکر کردن کلود رو بررسی کن تا مطمئن بشی داره اسکیل رو لود می‌کنه.
4. اگه کلود اونجوری که انتظار داری از اسکیل استفاده نمی‌کنه، description رو اصلاح کن.

وقتی داری رو یه اسکیل با کلود تو چت کار می‌کنی، می‌تونی فایل‌های اسکیل رو مستقیم همون جایی که کنار مکالمه باز می‌شن ویرایش کنی. متنی که می‌خوای عوض بشه رو هایلایت کن، رو “Edit with Claude” کلیک کن، و درخواستت رو تایپ کن. برای اسکیل‌هایی که چند فایل دارن، درخواست‌های ویرایش رو تو همه‌ی فایل‌ها بذار و با هم بفرست؛ کلود همه رو یکجا اعمال می‌کنه. برای اطلاعات بیشتر، مقاله‌ی ویرایش آرتیفکت‌ها رو ببین.

📌 نکته برای پلن‌های Team و Enterprise: برای اینکه یه اسکیل رو در دسترس همه‌ی کاربرای سازمانت بذاری، به مقاله‌ی “Provision and manage skills for your organization” سر بزن.

بهترین روش‌ها 

• متمرکز نگهش دار: برای روش‌های کاری مختلف، اسکیل‌های جدا بساز. چندتا اسکیل متمرکز بهتر از یه اسکیل بزرگ و همه‌کاره کار می‌کنن.
• توضیحات واضح بنویس: کلود از توضیحات برای تصمیم‌گیری استفاده می‌کنه که کِی اسکیلت رو صدا بزنه. دقیق باش که کِی کاربرد داره.
• ساده شروع کن: با دستورالعمل‌های ساده تو مارک‌داون شروع کن، بعد اگه لازم شد اسکریپت پیچیده اضافه کن. همیشه می‌تونی بعداً اسکیل رو گسترش بدی.
• از مثال استفاده کن: ورودی و خروجی نمونه تو فایل skill.md بذار تا کلود بفهمه موفقیت یعنی چی.
• مرحله‌به‌مرحله تست کن: بعد از هر تغییر مهم تست کن، نه اینکه بخوای یه اسکیل پیچیده رو یهو کامل بسازی.
• اسکیل‌ها می‌تونن رو هم سوار بشن: اسکیل‌ها نمی‌تونن مستقیم به هم اشاره کنن، ولی کلود می‌تونه به‌صورت خودکار از چندتاشون با هم استفاده کنه. همین ترکیب‌پذیری یکی از قوی‌ترین بخش‌های قابلیت اسکیل‌هاست.
• مشخصات باز Agent Skills رو بررسی کن: راهنمای agentskills.io رو دنبال کن تا اسکیل‌هایی که می‌سازی رو پلتفرم‌های دیگه‌ای که این استاندارد رو قبول دارن هم کار کنن.

برای یه راهنمای عمیق‌تر درباره‌ی ساخت اسکیل، به “Skill authoring best practices” تو داکیومنت‌های کلود سر بزن.

ملاحظات امنیتی

موقع اضافه کردن اسکریپت به فایل skill.md دقت کن:

• اطلاعات حساس (کلید API، پسورد) رو تو کد هاردکد نکن.
• قبل از فعال کردن هر اسکیلی که دانلود می‌کنی، بازبینیش کن.
• برای دسترسی به سرویس‌های خارجی، از اتصالات MCP مناسب استفاده کن.

اسکیل‌های نمونه به عنوان مرجع

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

منبع