اسکیل چیست؟ راهنمای کامل Agent Skills برای Claude، Codex و Cursor

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

اسکیل (Agent Skill) راه‌حلی است که حالا تقریباً همه‌ی دستیارهای جدی برنامه‌نویسی و کار روزمره از آن پشتیبانی می‌کنند: دانش و روش کار را یک بار در یک پوشه‌ی کوچک بنویسید، و دستیار هر وقت لازم شد خودش آن را بخواند و همان‌طور اجرا کند.

در این راهنما می‌بینید اسکیل دقیقاً چیست، چرا با وجود سادگی این‌قدر مؤثر است، چه فرقی با پرامپت، MCP و ساب‌ایجنت دارد و روی کدام ابزارها کار می‌کند.

#اسکیل دقیقاً چیست؟

اسکیل یک پوشه است. تنها چیزی که اجباری است، فایلی به نام SKILL.md در همان پوشه است. بقیه اختیاری‌اند:

my-skill/
├── SKILL.md        ← دستورالعمل اصلی (اجباری)
├── scripts/        ← کدهای آماده که دستیار اجرا می‌کند
├── references/     ← مستندات مفصل که فقط در صورت نیاز خوانده می‌شود
└── assets/         ← قالب‌ها، فونت‌ها، تصویرها و داده‌ها

فایل SKILL.md دو بخش دارد. بالای آن یک سربرگ کوتاه (frontmatter) است با دو فیلد اجباری: name و description. زیر آن، دستورالعمل به زبان ساده نوشته می‌شود؛ همان چیزی که به یک همکار تازه‌کار و باهوش می‌گفتید.

---
name: writing-persian-ui
description: Writes and reviews Persian interface copy: buttons, errors,
  empty states and ZWNJ. Use when the user asks for Persian UI text or microcopy.
---

# Persian UI writing
هر متن رابط باید به یک سؤال کاربر جواب بدهد…

طبق مشخصات استاندارد Agent Skills، نام اسکیل حداکثر ۶۴ کاراکتر است و فقط حروف کوچک انگلیسی، عدد و خط تیره دارد، و باید با نام پوشه یکی باشد. توضیح (description) حداکثر ۱۰۲۴ کاراکتر است و باید بگوید اسکیل چه می‌کند و کی باید از آن استفاده شود.

#راز اصلی: بارگذاری مرحله‌به‌مرحله

اگر اسکیل فقط یک فایل متنی است، چرا از یک پرامپت طولانی بهتر کار می‌کند؟ جواب در روشی است که به آن افشای تدریجی (progressive disclosure) می‌گویند. دستیار همه‌ی اسکیل‌ها را یک‌جا نمی‌خواند؛ در سه مرحله و فقط به‌اندازه‌ی لازم:

1. کشف: هنگام شروع، فقط نام و توضیح همه‌ی اسکیل‌ها خوانده می‌شود؛ حدود ۱۰۰ توکن برای هر اسکیل. پس می‌توانید ده‌ها اسکیل نصب کنید بدون این‌که حافظه‌ی گفتگو پر شود.
2. فعال‌سازی: وقتی درخواست شما با توضیح یک اسکیل جور شد، متن کامل SKILL.md خوانده می‌شود. استاندارد توصیه می‌کند این متن زیر ۵٬۰۰۰ توکن و زیر ۵۰۰ خط بماند.
3. اجرا: فایل‌های references/ و scripts/ فقط وقتی باز می‌شوند که کار واقعاً به آن‌ها برسد. یک اسکریپت حتی لازم نیست خوانده شود؛ فقط اجرا می‌شود و خروجی‌اش به دستیار می‌رسد.

نتیجه‌ی این طراحی ساده است: حجم دانشی که می‌توانید بسته‌بندی کنید عملاً سقف ندارد، ولی هزینه‌اش فقط وقتی پرداخت می‌شود که لازم باشد. اسکیل طراحی آیکون می‌تواند ده‌ها صفحه قاعده و چند اسکریپت بررسی کیفیت داشته باشد، و تا وقتی آیکون نخواسته‌اید، فقط دو خط از حافظه را می‌گیرد.

#اسکیل، پرامپت، MCP یا ساب‌ایجنت؟

این چهار مفهوم زیاد با هم اشتباه گرفته می‌شوند، در حالی که هر کدام برای کاری ساخته شده‌اند:

یک تشبیه کمک می‌کند: MCP دسترسی است، اسکیل مهارت. سرور MCP فیگما به دستیار اجازه می‌دهد فایل طراحی را بخواند؛ اسکیل دیزاین‌سیستم به او می‌گوید با آن فایل چه کند، چه چیزی را بررسی کند و خروجی را با چه استانداردی تحویل بدهد. بهترین نتیجه‌ها معمولاً از ترکیب این دو می‌آید.

#روی چه ابزارهایی کار می‌کند؟

Anthropic اسکیل‌ها را اول برای Claude معرفی کرد و در دسامبر ۲۰۲۵ قالب آن را به‌صورت یک استاندارد باز منتشر کرد. از آن به بعد ابزارهای زیادی همین قالب را پذیرفته‌اند؛ یعنی یک اسکیل را یک بار می‌نویسید و روی چند ابزار استفاده می‌کنید:

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

#اسکیل خوب چه شکلی است؟

همه‌ی اسکیل‌ها مثل هم نیستند. فرق یک اسکیل حرفه‌ای با یک فایل متنی معمولی در چند چیز است:

• یک کار مشخص: اسکیل «کمک به طراحی» خیلی کلی است؛ اسکیل «طراحی آیکون روی شبکه‌ی ۲۰ پیکسلی با شش سبک» دقیقاً می‌داند چه کند.
• توضیحی که کلمات کاربر را دارد: اگر کاربران شما می‌گویند «نیم‌فاصله» یا «ریزمتن»، همین کلمات باید در توضیح باشد.
• کوتاه و بدون توضیح واضحات: مدل باهوش است. اسکیل فقط چیزی را می‌گوید که مدل از قبل نمی‌داند.
• اسکریپت برای کارهای شکننده: هرجا خطا گران است (بررسی کیفیت SVG، ساخت فایل، اعتبارسنجی)، یک اسکریپت تست‌شده از یک پاراگراف توضیح مطمئن‌تر است.
• تست‌شده با سناریوهای واقعی: اسکیل بدون ارزیابی فقط یک حدس است.

این اصول را با جزئیات و مثال در مقاله‌ی ۹ اصل نوشتن یک اسکیل حرفه‌ای توضیح داده‌ام.

#از کجا شروع کنیم؟

اگر تا حالا اسکیل استفاده نکرده‌اید، ساده‌ترین راه این است:

1. یک کار تکراری را انتخاب کنید که هر هفته برای دستیارتان توضیح می‌دهید.
2. یک اسکیل آماده برای همان کار نصب کنید، یا اولین اسکیل خودتان را با کمک یک اسکیل‌ساز بنویسید.
3. چند بار با درخواست واقعی امتحانش کنید و هرجا اشتباه کرد، همان را به اسکیل اضافه کنید.

اسکیل‌هایی که در فروشگاه Skills می‌بینید همان‌هایی‌اند که خودم هر روز با آن‌ها کار می‌کنم؛ هر کدام با اسکریپت، منابع و سناریوهای ارزیابی. اگر می‌خواهید بیشتر بدانید، صفحه‌ی اسکیل چیست؟ را هم ببینید.

#خلاصه

• اسکیل یک پوشه با فایل SKILL.md است که دانش و روش کار را به دستیار می‌دهد.
• دستیار اسکیل را مرحله‌به‌مرحله می‌خواند، پس می‌توانید ده‌ها اسکیل داشته باشید بی‌آن‌که حافظه پر شود.
• MCP دسترسی می‌دهد، اسکیل مهارت؛ و این دو با هم بهترین کار را می‌کنند.
• قالب SKILL.md یک استاندارد باز است و روی Claude، Codex، Cursor و ابزارهای دیگر کار می‌کند.