Agent Skills — قالب چندسازنده برای دستورالعمل‌های وظیفه عامل LLM
در 2026-10-20، Agent Skills همان استاندارد بازی است که Anthropic در دسامبر 2025 منتشر کرد: SKILL.md فقط به name و description نیاز دارد، محتوا در سه سطح بارگذاری میشود، و Claude Code، claude.ai، Claude API و OpenAI Codex / ChatGPT همگی یک فایل واحد را می‌خوانند.
Skills چه هستند: تفاوت آنها با Pluginها و MCP
یک Skill یک پوشه است که شامل SKILL.md (شامل name و description در YAML frontmatter و دستورالعمل‌های وظیفه در markdown) به‌همراه scripts، references و assets اختیاری است. Anthropic آنها را منابع قابل‌استفاده مجدد و مبتنی بر فایل‌سیستم می‌نامد: مدل درخواست شما را با description تطبیق میدهد، سپس بدنه و اسکریپت‌هایی را که لازم دارد میخواند، و فقط خروجی یک اسکریپت وارد بافت میشود. این‌ها با Pluginها (بسته‌های ویژگی سمت کلاینت) و MCP (پروتکل ابزار خارجی) متفاوت‌اند — Skills ابزار یا قابلیت‌های کلاینت نیستند؛ آنها بسته‌های دستورالعمل «چگونگی انجام کار» هستند. یک Plugin میتواند چندین Skill داشته باشد، و یک Skill میتواند به ابزارهای MCP ارجاع دهد.
مشخصات SKILL.md: فیلدهای الزامی و یک مثال حداقلی
SKILL.md از YAML frontmatter برای اعلام name و description استفاده میکند و بدنه بهصورت markdown برای دستورالعمل‌هاست. در مشخصات، فقط name و description الزامی هستند؛ license، compatibility، metadata و allowed-tools اختیاری‌اند و allowed-tools هنوز آزمایشی است. مثال حداقلی رسمی، name را روی pdf-processing تنظیم میکند و استخراج متن و جدول‌ها از فایل‌های PDF، پر کردن فرم‌ها و ادغام اسناد را توصیف میکند، برای استفاده زمانی که کاربر به PDFها، فرم‌ها یا استخراج سند اشاره میکند. name حداکثر 64 کاراکتر است، فقط حروف کوچک، اعداد و خط تیره، بدون خط تیره در ابتدا یا انتها؛ description غیرخالی و حداکثر 1024 کاراکتر است. پوشه بهصورت skill-name/SKILL.md به‌همراه scripts/، references/ و assets/ اختیاری است. بدنه شامل مراحل برای مدل است، برای نمونه: 1. فایل‌هایی را که باید پردازش شوند از پیام کاربر استخراج کنید؛ 2. برای خروجی گرفتن نتیجه، ./scripts/extract.py را فراخوانی کنید. مدل این Skill را وقتی درخواست مرتبط با PDF می‌بیند، بهصورت خودکار بارگذاری میکند.
مخزن رسمی Skills و نمونه‌های شرکا
مخزن رسمی anthropics/skills مجموعه‌ای از پیاده‌سازی‌های مرجع را منتشر میکند و README آنها را در دسته‌های طرح خلاقانه، توسعه فنی، ارتباطات سازمانی و Skillهای سند دسته‌بندی میکند؛ docx، pdf، pptx و xlsx نسخه‌هایی با کد منبع در دسترس (source-available) هستند که پشتوانه قابلیت‌های سند Claudeاند، در حالی که بیشتر بقیه متن‌باز تحت Apache 2.0 هستند. در سمت پلتفرم، Skillهای سند از پیش ساخته‌شده وجود دارند: PowerPoint (pptx)، Excel (xlsx)، Word (docx) و PDF (pdf) که در claude.ai و API آماده استفاده هستند. مخزن همچنین یک قالب Skill و یک نسخه از مشخصات را ارائه میکند، و در Claude Code میتوانید مخزن را بهعنوان یک plugin marketplace ثبت کنید و از آن نصب کنید؛ بخش Partner Skills در README در حال حاضر Skill Claude متعلق به Notion را برجسته میکند. تجمیع‌کننده اجتماعی SkillsMP (skillsmp.com) خود را پروژه‌ای مستقل و جامعه‌محور معرفی میکند که منابع عمومی GitHub را تجمیع میکند تا کشف Skill آسان‌تر شود.
سازگاری چندسازنده و توزیع سازمانی
پس از آنکه Anthropic در دسامبر 2025 Skills را به استاندارد باز تبدیل کرد، مستندات خود OpenAI بیان میکنند که Codex و ChatGPT همان SKILL.md را می‌خوانند: Codex، Skillهای محلی را از $CWD/.agents/skills، $HOME/.agents/skills و /etc/codex/skills بارگذاری میکند؛ این Skillها با /skills یا $ بهصورت صریح فراخوانی میشوند و Codex همچنین میتواند با تطبیق description یک Skill را فعال کند. همان SKILL.md در Claude Code، Codex CLI و ChatGPT اجرا میشود — یک‌بار بنویسید و در چند سازنده مستقر کنید، هرچند سطوح همگام‌سازی نمی‌شوند: Skillهایی که در claude.ai بارگذاری میشوند باید جداگانه در API بارگذاری شوند، Skillهایی که از طریق API بارگذاری میشوند در claude.ai در دسترس نیستند، و Skillهای Claude Code مبتنی بر فایل‌سیستم و جدا از هر دو هستند. در سمت سازمانی، Skillهای سفارشی در claude.ai برای هر کاربر جداگانه‌اند و Anthropic اعلام میکند که claude.ai از مدیریت متمرکز ادمین یا توزیع در سطح سازمان برای Skillهای سفارشی پشتیبانی نمی‌کند؛ سازمان‌های Claude Enterprise میتوانند اسکن محتوای Skill را برای Skillهای بارگذاری‌شده در claude.ai و Claude Cowork فعال کنند، در حالی که Skillهای بارگذاری‌شده از طریق Skills API اسکن نمی‌شوند، و یک درخواست API حداکثر از 20 Skill پشتیبانی میکند.
FAQ
آیا Skill با subagentهای سفارشی یکسان است؟
خیر. یک subagent سفارشی، واحد ارسال در Claude Code است با prompt، ابزارها و قواعد ارسال مخصوص خود. Skill یک بسته دستورالعمل سطح بالاتر است که میتواند توسط عامل اصلی یا هر subagent بارگذاری شود. یک subagent میتواند به چندین skill ارجاع دهد: روش رسمی، فیلد skills است که محتوای کامل skill را در زمان راه‌اندازی از پیش در زمینه آن subagent بارگذاری میکند، و عکس آن هم کار میکند — یک skill با context: fork درون یک subagent فورک‌شده اجرا میشود.
آیا میتوانید با یک Skill مدل را ملزم کنید که از یک رفتار پرهیز کند؟
نه بهعنوان یک محدودیت سخت — Skillها «توصیهها و دستورالعملهایی» هستند که مدل میتواند تحت فشار از آنها منحرف شود. Anthropic یک skill را بهعنوان دستورالعملها و اسکریپتها تعریف میکند، بنابراین اینکه Claude از آنها پیروی میکند یا نه، یک پرسش ارزیابی است (چکلیست رسمی، پیروی از دستورالعمل و دقت فعالسازی را پوشش میدهد). برای محدودیتهای واقعی، از سازوکارهای Claude Code استفاده کنید: disallowed-tools تا زمانی که skill فعال است ابزارها را از مجموعه در دسترس حذف میکند، allowed-tools ابزارها را از پیش تأیید میکند، و disable-model-invocation: true مانع از آن میشود که Claude خودبهخود skill را فراخوانی کند. از Skillها برای «چگونه درست انجام دادن» استفاده کنید؛ قواعد سخت را جای دیگری بگذارید.
آیا Codex و ChatGPT میتوانند از همان قالب SKILL.md استفاده کنند؟
بله. Skillها مخزنهای متنی markdown هستند — با git clone بهصورت محلی استفاده کنید: Claude Code آنها را از ~/.claude/skills/ یا .claude/skills/ میخواند و Codex از پوشههای .agents/skills. در کنار درگاه QCode برای مدلهای Claude/Codex/GPT، همان SKILL.md در میان ارائهدهندگان مختلف کار میکند. مستندات OpenAI میگوید Skillها بر پایه استاندارد باز agent skills ساخته میشوند: فایل SKILL.md باید شامل name و description باشد، و Codex و ChatGPT با نام و description هر skill شروع میکنند و سپس وقتی تصمیم بگیرند از آن استفاده کنند، SKILL.md کامل را بارگذاری میکنند.
استفاده از Agent Skills در میان ارائهدهندگان با QCode
QCode دسترسی به مدلهای Claude / GPT / چینی را در یک بسته ارائه میدهد — همه سازگار با استاندارد Agent Skills. یک بار بنویسید، همه‌جا اجرا کنید.
پلن QCode خود را آغاز کنیدایجاد حساب کاربری QCode
یک کلید برای Claude، GPT و مدلهای چینی، با صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models.