سبد خرید شما خالی است.
آموزش نصب اسکیل در ChatGPT و Codex؛ راهنما و رفع خطا
10دقیقه
آنچه در این مقاله می‌خوانید [پنهان‌سازی]
پاسخ کوتاه: نصب اسکیل هوش مصنوعی به محیطی که استفاده می‌کنید بستگی دارد. برای فایل مستقل در Codex، پوشه‌ای را نصب کنید که SKILL.md مستقیماً داخل آن است. در ChatGPT دسکتاپ، اسکیل‌ها از بخش Skills مدیریت می‌شوند؛ در وب و موبایل، اسکیل‌های بسته‌بندی‌شده در Plugin مسیر توزیع قابل نصب دارند. صرفاً پیوست‌کردن ZIP در گفت‌وگو را نصب اسکیل فرض نکنید.
نکته مهم پیش از شروع: «Skill»، «Plugin» و «GPT سفارشی» یک چیز نیستند. اسکیل پوشه‌ای از دستورالعمل‌ها و منابع قابل استفاده مجدد است؛ پلاگین روش توزیع قابلیت‌های قابل نصب در ChatGPT است؛ GPT سفارشی نیز تنظیمات و دانش مخصوص یک دستیار را در محیط ChatGPT نگه می‌دارد.
Skill در ChatGPT و Codex چیست؟
اسکیل مجموعه‌ای سازمان‌یافته از دستورالعمل‌هاست که به ChatGPT یا Codex می‌گوید یک کار مشخص را با چه فرایند، قواعد و منابعی انجام دهد. قلب هر اسکیل فایل SKILL.md است. یک اسکیل حرفه‌ای می‌تواند پوشه‌های تکمیلی مانند references، scripts و assets هم داشته باشد.
برای مثال، اسکیل مقاله‌نویسی می‌تواند روش تحقیق، ساختار مقاله، لحن برند، چک‌لیست کنترل کیفیت تولید محتوا با هوش مصنوعی و نمونه خروجی را یکجا نگه دارد. در نتیجه لازم نیست برای هر مقاله تمام این دستورها را دوباره بنویسید.
پیش‌نیازهای نصب Skill
اگر هنوز با پرامپت‌نویسی، ارزیابی پاسخ‌های هوش مصنوعی و ساخت پروژه آشنا نیستید، پیش از نصب اسکیل‌ها از نقشه راه ۳۰ روزه آموزش کاربردی هوش مصنوعی شروع کنید؛ نصب اسکیل مرحله‌ای تکمیلی پس از یادگیری این مبانی است.
- فایل ZIP اسکیل را از منبع قابل اعتماد دریافت کرده باشید.
- به یک کامپیوتر ویندوز، macOS یا Linux دسترسی داشته باشید.
- برای نصب محلی، Codex CLI یا افزونه Codex در محیط توسعه را نصب و وارد حساب خود کرده باشید.
- در صورت استفاده از ChatGPT دسکتاپ، برنامه را به نسخه فعلی به‌روزرسانی کرده باشید.
- پیش از اجرا، فایل‌های اسکریپت و سطح دسترسی موردنیاز بسته را بررسی کنید.
مرحله اول: ساختار فایل ZIP را بررسی کنید
پس از دانلود، فایل ZIP را Extract کنید. ساختار درست معمولاً باید شبیه نمونه زیر باشد:
your-skill/
├── SKILL.md
├── references/
├── scripts/
└── assets/وجود همه پوشه‌های فرعی الزامی نیست، اما SKILL.md باید وجود داشته باشد. یکی از خطاهای رایج، ایجاد یک پوشه اضافه هنگام Extract است؛ یعنی مسیر نهایی به‌شکل your-skill/your-skill/SKILL.md درمی‌آید. در این حالت باید همان پوشه‌ای را نصب کنید که فایل SKILL.md مستقیماً داخل آن است.
فایل SKILL.md را پیش از نصب بررسی کنید
وجود فایل به‌تنهایی کافی نیست. در استاندارد Agent Skills، ابتدای آن باید بخش مشخصات YAML با دو فیلد name و description داشته باشد. نام فنی اسکیل باید با نام پوشه آن مطابقت داشته باشد؛ برای نام از حروف کوچک انگلیسی، عدد و خط تیره استفاده کنید. مرجع ساختار و نام‌گذاری Agent Skills.
نمونهٔ آموزشی برای پوشه‌ای با نام content-brief؛ این نمونه فقط ساختار فایل را نشان می‌دهد:
---
name: content-brief
description: Prepare a Persian content brief with audience, message, format and review criteria.
---
ابتدا مخاطب، هدف و قالب محتوا را مشخص کن.
سپس بریف کوتاه و معیار بازبینی خروجی را بنویس.در بستهٔ آماده، مشخصات سازنده و مسیر منابع را خودسرانه تغییر ندهید. اگر دو اسکیل هم‌نام در Codex دارید، مسیر هرکدام را بررسی کنید؛ اسکیل‌های هم‌نام با هم ادغام نمی‌شوند. مرجع شناسایی اسکیل‌ها در Codex.
روش اول: نصب اسکیل در Codex؛ مسیر فایل ZIP
برای بسته‌های قابل دانلود پلی‌مدیا، این روش روشن‌ترین و قابل پیش‌بینی‌ترین مسیر است. طبق راهنمای رسمی OpenAI، Codex اسکیل‌های محلی را در سطح کاربر یا پروژه شناسایی می‌کند.
۱. نصب برای همه پروژه‌های کاربر
اگر می‌خواهید اسکیل در پروژه‌های مختلف شما در دسترس باشد، پوشه Extractشده را در مسیر زیر قرار دهید:
$HOME/.agents/skills/your-skill/در macOS و Linux، $HOME همان پوشه کاربری شماست. در ویندوز نیز باید مسیر متناظر پوشه کاربر را باز کنید و پوشه‌های .agents/skills را در صورت نبودن بسازید.
۲. نصب فقط برای یک پروژه
اگر اسکیل مخصوص یک سایت یا پروژه است، آن را در پوشه همان پروژه قرار دهید:
your-project/.agents/skills/your-skill/این انتخاب برای اسکیل‌های وابسته به برند مناسب‌تر است؛ چون دستورالعمل‌های یک پروژه ناخواسته در پروژه‌های دیگر فعال نمی‌شوند.
۳. بررسی مسیر نهایی
در پایان، این فایل باید در دسترس باشد:
.../.agents/skills/your-skill/SKILL.mdاگر فایل یک پوشه عمیق‌تر باشد، پوشه داخلی را جابه‌جا کنید تا مسیر اصلاح شود.
۴. شروع دوباره Codex
Codex معمولاً تغییرات اسکیل را تشخیص می‌دهد. اگر اسکیل در فهرست دیده نشد، یک نشست تازه باز کنید یا Codex را یک‌بار ببندید و دوباره اجرا کنید.
۵. فراخوانی اسکیل
در Codex می‌توانید فهرست اسکیل‌ها را با /skills ببینید یا یک اسکیل را با نام آن فراخوانی کنید:
$your-skill
موضوع: راهنمای انتخاب ابزار هوش مصنوعی برای تولید محتوا
مخاطب: مدیران کسب‌وکارهای کوچک
هدف: مقاله آموزشی و قابل انتشارنام دقیق فراخوانی معمولاً در ابتدای فایل SKILL.md یا راهنمای همراه محصول نوشته شده است.
روش دوم: استفاده از اسکیل در ChatGPT دسکتاپ
براساس مستندات فعلی OpenAI، اسکیل‌های مستقل در برنامه دسکتاپ ChatGPT در دسترس‌اند و از بخش Skills در نوار کناری مدیریت می‌شوند. این بخش اسکیل‌هایی را که در پروژه‌های مختلف ساخته‌اید نشان می‌دهد.
- برنامه دسکتاپ ChatGPT را باز و به حساب خود وارد شوید.
- از نوار کناری، بخش Skills را باز کنید و اسکیل‌های موجود را بررسی کنید.
- اگر اسکیل موردنظر در حساب شما نصب است، در گفت‌وگو
@را تایپ و نام آن را انتخاب کنید.
برای فایل ZIP دانلودی: مستندات عمومی بررسی‌شده، مسیر یکسانی با دکمه Import برای همه حساب‌ها مشخص نمی‌کنند. مسیر نصب همان بسته را دنبال کنید؛ اگر نسخه مستقل سازگار با Codex دارید، از روش محلی بالا استفاده کنید. وجود بخش Skills به‌تنهایی به معنی امکان واردکردن هر ZIP نیست. مرجع رسمی OpenAI درباره اسکیل‌ها و محیط‌های پشتیبانی‌شده.
آیا می‌توان اسکیل را در ChatGPT وب یا موبایل نصب کرد؟
اسکیل مستقل به‌صورت پوشه محلی در ChatGPT وب و موبایل نصب نمی‌شود. برای استفاده چندسکویی، اسکیل باید داخل یک Plugin ارائه شود. پلاگین‌ها در نسخه وب، دسکتاپ و موبایل ChatGPT قابل استفاده‌اند و اسکیل‌های داخل آن‌ها با علامت @ فراخوانی می‌شوند.
- در ChatGPT بخش Plugins را باز کنید.
- پلاگین موردنظر را از کاتالوگ یا لینک نصب ارائه‌دهنده انتخاب کنید.
- دسترسی‌های درخواست‌شده را بررسی و نصب را تأیید کنید.
- در گفت‌وگو،
@را تایپ و نام پلاگین یا اسکیل آن را انتخاب کنید.
اگر محصول فقط شامل فایل ZIP است، آن را با Plugin اشتباه نگیرید. ZIP برای نصب محلی یا واردکردن در محیط‌های پشتیبانی‌شده آماده می‌شود؛ لینک Plugin مسیر نصب در ChatGPT وب و موبایل است.
چطور مطمئن شویم Skill درست نصب شده است؟
پس از نصب، یک درخواست کوچک و قابل بررسی اجرا کنید. برای نمونه، از یک اسکیل مقاله‌نویسی بخواهید فقط «هدف، مخاطب و ساختار پیشنهادی» را برای یک موضوع مشخص آماده کند. سپس این موارد را بررسی کنید:
- آیا اسکیل با نام درست شناسایی شد؟
- آیا قبل از تولید خروجی، اطلاعات ضروری را از شما گرفت؟
- آیا لحن و مراحل نوشته‌شده در راهنمای اسکیل رعایت شد؟
- آیا فایل‌ها یا منابع همراه بسته در صورت نیاز خوانده شدند؟
رفع خطاهای رایج نصب اسکیل
اسکیل در فهرست دیده نمی‌شود
ابتدا مسیر پوشه و وجود مستقیم فایل SKILL.md را بررسی کنید. سپس نشست تازه‌ای باز کنید. اگر از ChatGPT وب یا موبایل استفاده می‌کنید، به یاد داشته باشید که ZIP اسکیل مستقل در این محیط‌ها نصب نمی‌شود.
فایل SKILL.md پیدا نمی‌شود
احتمالاً پوشه اشتباه را جابه‌جا کرده‌اید یا فایل ZIP کامل Extract نشده است. نام فایل باید دقیقاً SKILL.md باشد، نه SKILL.md.txt.
اسکیل نصب شده اما خودکار فعال نمی‌شود
توضیح اسکیل ممکن است با درخواست شما تطبیق کافی نداشته باشد. آن را صریحاً با $نام-اسکیل در Codex یا @نام-اسکیل در ChatGPT فراخوانی کنید.
اسکیل به ابزار یا سایت دسترسی ندارد
نصب اسکیل به‌تنهایی اشتراک ابزار، اتصال سایت، کلید API یا مجوز دسترسی ایجاد نمی‌کند. اگر اسکیل برای اجرای کار به یک Connector، MCP یا سرویس خارجی نیاز دارد، آن اتصال باید جداگانه نصب و تأیید شود. برای کار روی محتوای سایت، راهنمای اتصال ChatGPT به وردپرس مراحل راه‌اندازی اتصال و آزمایش روی پیش‌نویس را توضیح می‌دهد.
در فضای کاری سازمانی گزینه Skills یا Plugins غیرفعال است
مدیر فضای کاری می‌تواند دسترسی به اسکیل‌ها و پلاگین‌ها را کنترل کند. در این حالت باید از مدیر Workspace بخواهید وضعیت قابلیت و سیاست نصب را بررسی کند.
چک‌لیست امنیتی پیش از اجرای اسکیل
- منبع و سازنده بسته را بشناسید.
- فایل‌های پوشه
scriptsرا پیش از اجرا مرور کنید. - کلید API، رمز عبور یا اطلاعات حساس را داخل فایل‌های اسکیل ذخیره نکنید.
- برای اتصال به سایت یا سرویس خارجی، کمترین سطح دسترسی لازم را بدهید.
- خروجی‌های مهم را پیش از انتشار، خرید یا اجرای نهایی بازبینی انسانی کنید.
چطور اسکیل هوش مصنوعی مناسب کارمان را انتخاب کنیم؟
پیش از نصب، خروجی موردنیازتان را مشخص کنید. برای انتخاب و مقایسه‌ی بسته‌ها می‌توانید اسکیل‌های هوش مصنوعی پلی‌مدیا را بر اساس نوع کار بررسی کنید:
- اسکیل‌های مقاله‌نویسی و سئو برای مسیر محتوای متنی.
- اسکیل‌های طراحی و محتوای تصویری برای انتخاب ابزار متناسب با محتوای بصری.
- اسکیل‌های موشن‌گرافیک برای بررسی بسته‌های موشن.
- اسکیل‌های تدوین و تکمیل ویدیو برای مراحل پس از ضبط یا تولید.
- اسکیل‌های پیش‌تولید و پرامپت ویدیویی برای برنامه‌ریزی پیش از اجرا.
پیش از خرید هر بسته، چهار مورد را بررسی کنید:
- محیط سازگار: محصول باید با محیط کاری شما سازگار باشد. سازگاری با یک میزبان، اجرای آن در همه‌ی نسخه‌ها و حساب‌ها را تضمین نمی‌کند.
- نوع خروجی: روشن کنید متن، پرامپت، پروژه‌ی قابل‌ویرایش یا فایل نهایی می‌خواهید. توضیحات و نمونه‌ی همان محصول را ملاک قرار دهید.
- پیش‌نیاز اجرا: بعضی بسته‌ها به اجرای کد، فونت یا فایل ورودی نیاز دارند. نصب اسکیل به‌تنهایی این پیش‌نیازها را فراهم نمی‌کند.
- محتویات و مجوز: فهرست فایل‌ها، روش نصب و شرایط استفاده را بخوانید. پیش از خرید چند بسته، هم‌پوشانی محتویات آن‌ها را بررسی کنید.
برای دیدن یک کاربرد عملی، آموزش ساخت موشن با Claude و اسکیل را بخوانید. این مسیر کمک می‌کند پیش از انتخاب بسته، مراحل آماده‌سازی و بازبینی خروجی را بشناسید.
نمونه نصب اسکیل‌های پلی‌مدیا
برای هر بستهٔ دانلودی، ابتدا محیط سازگار و روش نصب نوشته‌شده در صفحه و راهنمای همان محصول را بررسی کنید. اگر نسخهٔ مستقل سازگار با Codex دارید، پوشهٔ حاوی SKILL.md را در مسیر .agents/skills قرار دهید. فایل نصب پلاگین یا آرشیو چندمحصولی را بدون بررسی ساختار، به‌جای یک اسکیل مستقل نصب نکنید.
- اسکیل مقاله‌نویسی حرفه‌ای فارسی و سئو برای تحقیق، طراحی ساختار و نگارش مقاله فارسی
- اسکیل Seedance Director برای تبدیل ایده فارسی به پرامپت ویدیویی ساختاریافته
- اسکیل ساخت پست اسلایدی Carousel Studio برای هوک، متن، طراحی و کپشن؛ خروجی تصویر به ابزارهای محیط اجرا بستگی دارد.
- اسکیل ساخت PDF فارسی با فونت یکان‌بخ برای جزوه، گزارش و پیشنهاد همکاری؛ پیش‌نیازهای رندر را در صفحه محصول بررسی کنید.
مشاهده همه اسکیل‌های آماده پلی‌مدیا
پرسش‌های متداول
آیا می‌توان فایل ZIP اسکیل را مستقیماً در ChatGPT.com آپلود کرد؟
خیر؛ مستندات فعلی OpenAI نصب مستقیم پوشه یا ZIP اسکیل مستقل را برای ChatGPT وب اعلام نمی‌کند. در وب و موبایل، مسیر توزیع قابل نصب Plugin است.
برای استفاده از اسکیل باید برنامه‌نویسی بلد باشم؟
برای استفاده روزمره خیر. باید بتوانید فایل ZIP را Extract کنید، پوشه را در مسیر درست قرار دهید و نام اسکیل را فراخوانی کنید. اسکریپت‌های پیشرفته ممکن است پیش‌نیاز جداگانه داشته باشند که باید در راهنمای محصول ذکر شود.
فرق @ و $ برای فراخوانی چیست؟
در ChatGPT اسکیل یا پلاگین را با @ انتخاب می‌کنید. در Codex می‌توانید از /skills برای دیدن فهرست و از $ برای فراخوانی مستقیم اسکیل استفاده کنید.
آیا Skill اشتراک ChatGPT یا ابزارهای دیگر را هم شامل می‌شود؟
خیر. اسکیل یک بسته دستورالعمل و منابع است. اشتراک ChatGPT، اعتبار تولید تصویر یا ویدیو، API و اتصال سرویس‌های خارجی جداگانه تهیه می‌شوند.
منابع رسمی و تاریخ بررسی
مسیرهای نصب و ساختار فایل در این راهنما در ۱۷ اکتبر ۲۰۲۶ با مستندات رسمی OpenAI و استاندارد Agent Skills تطبیق داده شدند. چون رابط کاربری و دامنه دسترسی قابلیت‌ها ممکن است تغییر کند، پیش از نصب وضعیت نسخه برنامه و حساب خود را بررسی کنید.
- Build skills — ChatGPT Learn
- Plugins — ChatGPT Learn
- Skills & Plugins overview — ChatGPT Learn
- استاندارد ساختار فایل Agent Skills
نصب اسکیل با دادن مجوز مدیریت سایت یکی نیست. برای اتصال واقعی، مجوزها و روش قطع دسترسی MCP را بررسی کنید؛ سپس گردش کار تولید و مدیریت محتوای وردپرس با ChatGPT را اجرا کنید.
