نصب اسکیل در Claude؛ راهنمای اپ Claude و Claude Code

برای نصب اسکیل در Claude دو راه هست و انتخابش به جایی بستگی دارد که با Claude کار می‌کنید. در اپ Claude (وب یا دسکتاپ)، پوشه اسکیل را فشرده می‌کنید و فایل ZIP را از بخش Customize > Skills بارگذاری می‌کنید. در Claude Code، پوشه اسکیل را در مسیر ~/.claude/skills/ می‌گذارید. برای استفاده از اسکیل در اپ Claude باید اجرای کد را در تنظیمات حساب فعال کنید؛ اما نصب اسکیل محلی در Claude Code به روشن‌کردن این گزینه در اپ Claude وابسته نیست.

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

اسکیل در Claude چه کاری می‌کند؟

اسکیل یک پوشه است که دست‌کم یک فایل به نام SKILL.md دارد. بالای این فایل نام و توضیح کوتاه اسکیل می‌آید و پایینش دستورهایی که Claude باید دنبال کند. پوشه می‌تواند اسکریپت، قالب یا فایل مرجع هم داشته باشد.

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

پیش از نصب، این سه مورد را بررسی کنید

1. پلن حساب. طبق راهنمای رسمی Anthropic، کاربران Free، Pro، Max، Team و Enterprise نیز می‌توانند اسکیل سفارشی آپلود کنند؛ بنابراین برای آپلود لزوماً خرید Pro لازم نیست. اگر این گزینه را نمی‌بینید، ابتدا فعال‌بودن قابلیت‌ها، وضعیت حساب و محدودیت‌های سازمانی را بررسی کنید.
2. اجرای کد. در پلن‌های فردی به Settings > Capabilities بروید و گزینه Code execution and file creation را روشن کنید. در نسخه تازه تنظیمات، نام این گزینه Create and edit files است. این پیش‌نیاز مربوط به اسکیل‌ها در اپ Claude است؛ نصب فایل SKILL.md در محیط محلی Claude Code مسیر و تنظیمات خودش را دارد.
3. حساب سازمانی. در Team و Enterprise، مالک سازمان باید در Organization settings > Plugins & skills، در زبانه Policy، هر دو گزینه اجرای کد و Skills را فعال کند. در Team این گزینه‌ها از پیش روشن‌اند، ولی در Enterprise مالک باید روشنشان کند.

این راهنما برای کسانی است که به Claude دسترسی رسمی دارند. فهرست کشورهایی که Anthropic در آن‌ها سرویس می‌دهد را در سایت خود Anthropic ببینید.

نصب اسکیل در اپ Claude، قدم‌به‌قدم

1. پوشه اسکیل را آماده کنید. نام پوشه باید با نام اسکیل یکی باشد.
2. از خود پوشه یک فایل ZIP بسازید. یعنی پوشه را فشرده کنید، نه فقط فایل‌های داخلش را.
3. در اپ Claude به Customize > Skills بروید.
4. روی دکمه + و بعد Create skill بزنید.
5. گزینه Upload a skill را انتخاب کنید و فایل ZIP را بدهید.
6. بعد از آپلود، اسکیل در همان صفحه فهرست می‌شود. اگر خاموش بود، روشنش کنید.

اسکیلی که آپلود می‌کنید فقط برای خود شما فعال است. در حساب‌های Team و Enterprise، به اشتراک گذاشتن آن با همکاران فقط وقتی ممکن است که مالک سازمان این کار را مجاز کرده باشد.

اسکیل‌های رسمی Anthropic، یعنی Word، Excel، PowerPoint و PDF، نصب جداگانه ندارند. وقتی اجرای کد روشن باشد، Claude هر وقت لازم بداند خودش از آن‌ها استفاده می‌کند.

فایل ZIP را چطور بسازیم که خطا ندهد

ساختار ساده یک اسکیل این شکل است:

my-skill/
├── SKILL.md
├── scripts/      (اختیاری)
└── references/   (اختیاری)

فایل SKILL.md باید با یک بخش کوتاه بین دو خط --- شروع شود که دست‌کم نام و توضیح اسکیل را دارد:

---
name: my-skill
description: این اسکیل چه کاری می‌کند و کی باید از آن استفاده شود.
---

راهنمای رسمی Claude برای خطای آپلود چهار دلیل رایج را نام برده است:

نصب اسکیل در Claude Code

هنوز Claude Code را نصب نکرده‌اید؟ اول آموزش نصب Claude Code در ویندوز و مک و شروع اولین پروژه را انجام دهید، سپس به همین صفحه برگردید و اسکیل را در پوشه مخصوصش قرار دهید. نصب اسکیل در Claude Code با آپلود ZIP در اپ Claude تفاوت دارد.

در Claude Code آپلودی در کار نیست؛ اسکیل یک پوشه روی کامپیوتر شماست. جای پوشه تعیین می‌کند اسکیل کجا در دسترس باشد:

• اسکیل شخصی، برای همه پروژه‌ها: ~/.claude/skills/نام-اسکیل/SKILL.md
• اسکیل پروژه، فقط برای همان پوشه یا مخزن: .claude/skills/نام-اسکیل/SKILL.md. اگر این پوشه را در مخزن کد بگذارید، هم‌تیمی‌ها هم آن را دارند.
• اسکیل داخل پلاگین: با نصب پلاگین می‌آید و با نام /نام-پلاگین:نام-اسکیل صدا زده می‌شود.

برای دیدن اسکیل‌هایی که بارگذاری شده‌اند، دستور /skills را بزنید. هر اسکیل را هم می‌توانید مستقیم با /نام-اسکیل اجرا کنید. ویرایش فایل‌های داخل این پوشه‌ها بدون بستن برنامه اعمال می‌شود. فقط اگر پوشه اصلی skills را تازه ساخته‌اید، یک بار /reload-skills بزنید.

اسکیل‌های اپ Claude در Claude Code هم می‌آیند. اگر در Claude Code با همان حساب Claude وارد شوید، اسکیل‌هایی که در تنظیمات Claude فعال کرده‌اید، از نسخه 2.1.273 به بعد خودکار بارگذاری می‌شوند. در خروجی /skills زیر عنوان «claude.ai sync» دیده می‌شوند. این همگام‌سازی یک‌طرفه است، پس اسکیل را در خود اپ Claude ویرایش کنید. اگر با کلید API یا از راه سرویس‌هایی مثل Amazon Bedrock وارد شده باشید، همگام‌سازی انجام نمی‌شود.

تجربه پلی‌مدیا: در ۱۰ آبان ۱۴۰۵، برای مقاله‌های همین مجله یک اسکیل شخصی در پوشه ~/.claude/skills ساختیم. Claude Code بدون بستن و باز کردن برنامه، اسکیل تازه را در فهرست اسکیل‌هایش نشان داد و از همان لحظه از آن استفاده کرد.

اسکیل را از کجا بیاوریم و پیش از نصب چه بخوانیم

اسکیل فقط متن نیست؛ می‌تواند اسکریپت اجرا کند و به Claude بگوید با فایل‌ها و ابزارهای شما چه کند. راهنمای رسمی Anthropic صریحاً می‌گوید اسکیل را فقط از منبع مطمئن نصب کنید. خطرهایی که نام برده، تزریق دستور (prompt injection) و بیرون فرستادن اطلاعات است. پیش از روشن کردن اسکیلی که از جای دیگری گرفته‌اید، حتی اگر همکارتان فرستاده باشد:

• فایل SKILL.md را کامل بخوانید و ببینید دقیقاً از Claude چه می‌خواهد.
• اسکریپت‌های پوشه scripts و فایل‌های همراه را نگاه کنید.
• مراقب دستورهایی باشید که Claude را به سایت یا سرور ناشناس وصل می‌کنند.
• در Claude Code، اگر بالای فایل فیلد allowed-tools آمده، بدانید این فیلد به اسکیل اجازه می‌دهد بعضی ابزارها را بدون پرسیدن از شما اجرا کند.

مستندات Anthropic منبع مطمئن را اسکیلی می‌داند که خودتان ساخته‌اید یا از خود Anthropic گرفته‌اید. هر اسکیل دیگری، از جمله اسکیل‌هایی که می‌خرید، باید پیش از نصب همین بررسی را بگذراند.

اگر تازه با هوش مصنوعی کار می‌کنید، ابتدا نقشه راه ۳۰ روزه آموزش هوش مصنوعی برای مبتدی‌ها را مطالعه کنید و سپس نصب اسکیل را روی یک کار کوچک امتحان کنید. اگر دنبال اسکیل آماده برای کار فارسی هستید، اسکیل‌های هوش مصنوعی پلی‌مدیا را ببینید. برای یک نمونه عملی از کار با اسکیل، مقاله ساخت موشن‌گرافیک با Claude و اسکیل قدم‌به‌قدم یک پروژه موشن فارسی را جلو می‌برد. اگر با ChatGPT یا Codex کار می‌کنید، روش نصب فرق دارد و در راهنمای نصب اسکیل در ChatGPT و Codex آمده است.

اطلاعات این مطلب در تاریخ ۱۱ آبان ۱۴۰۵ با منابع رسمی Anthropic بررسی شده است: Use skills in Claude در راهنمای Claude و Extend Claude with skills در مستندات Claude Code و Agent Skills در مستندات توسعه‌دهندگان. نام منوها ممکن است در به‌روزرسانی‌های بعدی تغییر کند.

این مطلب با کمک ابزار هوش مصنوعی تهیه شده و نکات فنی آن با مستندات رسمی ذکرشده تطبیق داده شده است.