GH-SKILL-UPDATE(1)             GitHub CLI manual            GH-SKILL-UPDATE(1)



نام (NAME)
       gh-skill-update - به‌روزرسانی مهارت‌های نصب‌شده به آخرین نسخه (پیش‌نمایش)



خلاصه دستور (SYNOPSIS)
       gh skill update [<skill>...] [flags]



توضیحات (DESCRIPTION)
       بررسی مهارت‌های نصب‌شده برای به‌روزرسانی‌های موجود از طریق مقایسه هش درختی
       محلی (local tree SHA برگرفته از فرانت‌متر SKILL.md) با مخزن دوردست
       (remote repository).


       به‌طور خودکار تمامی پوشه‌های شناخته‌شده‌ی میزبان ایجنت (از جمله Copilot،
       Claude، Cursor، Gemini، Antigravity، Grok و دیگران) را در هر دو محدوده
       پروژه و کاربر پویش می‌کند.


       بدون آرگومان، تمام مهارت‌های نصب‌شده بررسی می‌شوند. با مشخص کردن نام
       مهارت‌ها، تنها همان مهارت‌های خاص بررسی خواهند شد.


       مهارت‌های تثبیت‌شده (نصب‌شده با --pin) همراه با یک اعلان نادیده گرفته
       می‌شوند. از --unpin برای پاک کردن نسخه تثبیت‌شده و گنجاندن آن مهارت‌ها در
       به‌روزرسانی استفاده کنید.


       در حالت تعاملی، برای مهارت‌های فاقد متادیتای گیت‌هاب (مانند مهارت‌هایی که
       به صورت دستی یا توسط ابزاری دیگر نصب شده‌اند) مخزن منبع آن‌ها پرسیده
       می‌شود. با گزینه --all یا در حالت غیرتعاملی، این مهارت‌ها همراه با یک
       اعلان نادیده گرفته می‌شوند. این به‌روزرسانی مهارت را همراه با متادیتای
       تزریق‌شده مجدداً دانلود می‌کند تا به‌روزرسانی‌های آینده به صورت خودکار انجام
       شوند.


       با گزینه --force، مهارت‌ها حتی اگر نسخه دوردست با هش محلی یکسان باشد
       دوباره دانلود می‌شوند. این کار فایل‌های مهارتی که به صورت محلی تغییر
       یافته‌اند را با محتوای اصلی بازنویسی می‌کند، اما فایل‌های اضافی که به صورت
       محلی افزوده شده‌اند را حذف نمی‌کند.


       در حالت تعاملی، نشان می‌دهد کدام مهارت‌ها به‌روزرسانی دارند و پیش از ادامه
       کار درخواست تایید می‌کند. با --all، بدون درخواست تایید به‌روزرسانی انجام
       می‌شود. با --dry-run، به‌روزرسانی‌های موجود را بدون دستکاری هیچ فایلی
       گزارش می‌دهد.



گزینه‌ها (OPTIONS)
       --all  به‌روزرسانی تمام مهارت‌ها بدون درخواست تایید


       --dir <string>
              پویش یک پوشه سفارشی برای یافتن مهارت‌های نصب‌شده


       --dry-run
              گزارش به‌روزرسانی‌های موجود بدون دستکاری فایل‌ها


       --force
              دانلود مجدد حتی در صورت به‌روز بودن


       --unpin
              پاک کردن نسخه تثبیت‌شده و گنجاندن مهارت‌های پین‌شده در به‌روزرسانی



کدهای خروج (EXIT CODES)
       0: اجرای موفقیت‌آمیز


       1: خطا


       2: دستور لغو شد


       4: نیاز به احراز هویت است


       نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای
       اطلاعات بیشتر به راهنمای همان دستور مراجعه فرمایید.



مثال‌ها (EXAMPLES)
       # بررسی و به‌روزرسانی تمام مهارت‌ها به صورت تعاملی
       $ gh skill update

       # به‌روزرسانی مهارت‌های خاص
       $ gh skill update mcp-cli git-commit

       # به‌روزرسانی همه بدون درخواست تایید
       $ gh skill update --all

       # دانلود مجدد تمام مهارت‌ها (بازیابی فایل‌های تغییر‌یافته محلی)
       $ gh skill update --force --all

       # بررسی به‌روزرسانی‌ها بدون اعمال تغییرات (فقط‌خواندنی)
       $ gh skill update --dry-run

       # خارج کردن مهارت‌ها از حالت تثبیت و به‌روزرسانی آن‌ها به آخرین نسخه
       $ gh skill update --unpin




همچنین ببینید (SEE ALSO)
       gh-skill(1)

                                   Sep 2026                 GH-SKILL-UPDATE(1)