نصب و مدیریت مهارت‌ها
این راهنما نشان می‌دهد چگونه یک فضای کاری را با مهارت‌هایی از GitHub پر کنید: یک مخزن را به‌عنوان منبع اضافه کنید، مهارت‌های دلخواه‌تان را از آن نصب کنید و آن‌ها را در طول زمان به‌روز نگه دارید.
نکتهٔ مهمی که پیش از شروع باید بدانید: مخزن منبع مورد اعتماد نیست. نام، توضیح و تعداد ستارهٔ آن را هر کسی که مالکش است می‌نویسد. تنها سیگنال ایمنی‌ای که Control Center به آن اعتماد می‌کند حکم اسکن آنتی‌ویروس است که هر نصب پیش از رسیدن هر چیزی به دیسک یا پرامپت یک عامل از آن می‌گذرد. اگر می‌خواهید استدلالش را بخوانید، بخش مهارت‌های مدل عامل را ببینید؛ این صفحه به جنبهٔ عملی می‌پردازد.
مهارت‌ها در تنظیمات → فضای کاری → مهارت‌ها
(/workspaces/<id>/settings/workspace/skills) قرار دارند. دامنهٔ آن‌ها فضای کاری
است: مهارت‌هایی که اینجا نصب می‌کنید فقط به همین فضای کاری تعلق دارند. این صفحه
شامل دو زبانه است: نصب‌شده (مهارت‌های محلی، همراه با یک ویرایشگر
مهارت جدید) و منابع (فهرست‌های GitHub). هر دو نوشتن از همان دروازهٔ اسکن
عبور می‌کنند.
افزودن یک مخزن مهارت
بخش با عنوان “افزودن یک مخزن مهارت”- تنظیمات → فضای کاری → مهارت‌ها را باز کنید و به زبانهٔ منابع بروید.
- روی افزودن مخزن بزنید.
- نشانی یک مخزن GitHub، مثلاً
https://github.com/anthropics/skills، را جای‌گذاری کنید و تأیید کنید.
سرور بررسی می‌کند که مخزن وجود دارد و با اعتبارنامه‌هایش قابل مشاهده است، سپس آن را به نوار سمت چپ می‌افزاید. هیچ فروشگاه گزینش‌شده‌ای در میان نیست: هر مخزن GitHub کار می‌کند، و همین یعنی داوری دربارهٔ اعتبار آن کار خودتان است — تعداد ستاره شاهد است، نه تضمین.
مهارت‌های یک مخزن همان پوشه‌هایی هستند که یک SKILL.md دارند (تا سه سطح عمق،
به‌علاوهٔ چیدمان بازار افزونهٔ Claude با قالب
plugins/<plugin>/skills/<skill>، و با نادیده گرفتن درخت‌های وابستگی و فروشنده).
اگر شبکه بعداً بگوید این مخزن مهارتی ندارد، معنایش همین است: هیچ پوشه‌ای در آن با
قرارداد مهارت مطابقت نمی‌کند.
بررسی یک مهارت پیش از نصب
بخش با عنوان “بررسی یک مهارت پیش از نصب”یک مخزن را در نوار انتخاب کنید؛ مهارت‌هایش به‌صورت شبکه‌ای در سمت راست نمایان می‌شوند و بالای آن یک فیلد فیلتر قرار دارد که فهرست را بر پایهٔ نام، توضیح یا slug محدود می‌کند. برای باز کردن نمای جزئیات روی یک کارت کلیک کنید. سه چیز را نشان می‌دهد:
- README، که به‌صورت مارک‌داون رندر می‌شود — فایل
README.mdپوشهٔ مهارت، یا بدنهٔSKILL.mdوقتی README وجود ندارد. - پیش‌نمایش اسکن — حکم (
pass،warnیاquarantine)، قابلیت‌هایی که محتوای مهارت اعلام می‌کند (اجرای شل، نوشتن فایل، دسترسی به شبکه…) و هر یافته‌ای که اسکنر ثبت کرده است. - تعداد فایل‌ها — نصب، تمام پوشهٔ مهارت را می‌نویسد، نه فقط
SKILL.mdآن.
پیش‌نمایش دقیقاً همان بایت‌هایی را اسکن می‌کند که نصب خواهد نوشت، پس حکمی که می‌بینید همان حکمی است که نصب دریافت می‌کند؛ هیچ چیزی پشت سر شما بازداوری نمی‌شود.
نصب یک مهارت
بخش با عنوان “نصب یک مهارت”- نمای جزئیات مهارت را باز کنید.
- حکم اسکن را بخوانید. برای حکم
warnیاpass، روی نصب بزنید. - برای حکم
quarantine، دکمهٔ نصب غیرفعال می‌ماند تا ریسک را می‌فهمم — به‌هرحال نصب کن را تیک بزنید. این نادیده‌گرفتن ثبت می‌شود، نه فرض.
نصب پوشهٔ مهارت را در فضای کاری می‌نویسد، یک pin در skills-lock.json ثبت
می‌کند (مخزن منبع، مسیر، کامیتی که از آن آمده و هش محتوا) و مهارت برای عامل‌های
آن فضای کاری در دسترس قرار می‌گیرد. کارتی که نام در حال استفاده خورده باشد
یعنی مهارت دیگری از قبل آن نام را به‌صورت محلی در اختیار دارد — ابتدا آن یکی را
حذف نصب کنید.
به‌روزرسانی مهارت‌ها در طول زمان
بخش با عنوان “به‌روزرسانی مهارت‌ها در طول زمان”کارت‌های مهارت‌های نصب‌شده نشان حمل می‌کنند: نصب‌شده، یا به‌روزرسانی موجود وقتی مخزن از کامیتی که pin کرده‌اید جلوتر رفته باشد. نمای جزئیات را باز کنید و روی به‌روزرسانی بزنید تا در کامیت جدید دوباره واکشی شود. به‌روزرسانی از همان دروازهٔ اسکن نصب می‌گذرد — مهارتی که نسخهٔ جدیدش قرنطینه شود رد می‌شود و همان نسخه‌ای که داشتید سر جای خود می‌ماند. هش نسخهٔ قدیمی به‌عنوان مرجع بازگردانی در قفل نگه داشته می‌شود.
حذف نصب یک مهارت، برداشتن یک مخزن
بخش با عنوان “حذف نصب یک مهارت، برداشتن یک مخزن”حذف نصب (در نمای جزئیات یک مهارت نصب‌شده، یا حذف در زبانهٔ نصب‌شده) پوشهٔ مهارت و pin قفلش را با هم برمی‌دارد — مهارت حذف‌نصب‌شده چیزی پشت سر نمی‌گذارد.
برداشتن یک مخزن از نوار فقط فهرست را برمی‌دارد: مهارت‌هایی که از آن نصب کرده‌اید نصب‌شده می‌مانند و همچنان به‌روزرسانی می‌شوند، چون یک pin مخزن را با نام ثبت می‌کند نه با ارجاع به مدخل منبع. اگر می‌خواهید دوباره مرورش کنید، مخزن را بازافزودن کنید.
فراخوانی یک مهارت
بخش با عنوان “فراخوانی یک مهارت”مهارت‌ها زیر فضای نام خودشان فراخوانی می‌شوند، پس هرگز با دستورات اسلش داخلی
(/plan، /goal، /loop، /compact) برخورد نمی‌کنند:
/skill:<name>— مهارتی که در این فضای کاری نصب شده، یا به عامل پیوست شده است/skill:<repo>:<name>— مهارتی که از مخزنی که در این فضا چک‌اوت شده عرضه می‌شود
یک نام لخت غیرداخلی هم هنوز حل می‌شود، برای پیام‌هایی که پیش از وجود فضای نام
نوشته شده‌اند. چیزی که به مهارتی به نام plan می‌رسد /skill:plan است؛ /plan
همیشه دستور داخلی است.
مهارت‌های محدود به مخزن
بخش با عنوان “مهارت‌های محدود به مخزن”یک مخزن چک‌اوت‌شده می‌تواند مهارت‌های خودش را در .agents/skills/،
.agent/skills/، .claude/skills/، .opencode/skills/ یا skills/ عرضه کند.
آن‌ها از این صفحه نصب نمی‌شوند. یک عامل فقط مهارت‌های مخزنی را که هم‌اکنون در
آن کار می‌کند با خود دارد؛ با جابه‌جایی، آن‌ها عوض می‌شوند. ویرایشگر پیام این‌طور
محدود نشده است: /skill:<repo>:<name> به هر مخزنی در فضا می‌رسد.
مهارت‌های مخزن پیش از رسیدن فرانت‌مترشان به پرامپت، از همان اسکن بسته‌در‌برابر‌خطا
(pass / warn / quarantine) می‌گذرند. warn پذیرفته می‌شود؛ quarantine
نگه داشته می‌شود، بدون هیچ نادیده‌گرفتن از سوی اپراتور در آن مسیر.
مهارت‌های محدود به مخزن و دستورات اسلش را ببینید.