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



نام (NAME)
       gh-skill-publish - اعتبارسنجی و انتشار مهارت‌ها در یک مخزن گیت‌هاب
       (پیش‌نمایش)



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



توضیحات (DESCRIPTION)
       اعتبارسنجی مهارت‌های یک مخزن محلی بر اساس مشخصات مهارت‌های ایجنت (Agent
       Skills specification) و انتشار آن‌ها با ایجاد یک انتشار (release) در
       گیت‌هاب.


       مهارت‌ها با همان قواعد دستوری مشابه دستور install شناسایی می‌شوند:

       • skills/*/SKILL.md

       • skills/{scope}/*/SKILL.md

       • */SKILL.md (در سطح ریشه)

       • plugins/{scope}/skills/*/SKILL.md


       بررسی‌های اعتبارسنجی شامل موارد زیر است:

       • نام‌های مهارت‌ها با قوانین دقیق نام‌گذاری agentskills.io مطابقت داشته
         باشند

       • نام هر مهارت با نام دایرکتوری آن همخوانی داشته باشد

       • فیلدهای الزامی بخش فرانت‌متر (name و description) وجود داشته باشند

       • فیلد allowed-tools یک رشته باشد و نه یک آرایه

       • متادیتای نصب (metadata.github-*) در صورت وجود حذف شود


       پس از موفقیت در اعتبارسنجی، فرآیند انتشار شما را به‌صورت تعاملی در مراحل
       زیر هدایت می‌کند:

       • افزودن موضوع (topic) به نام agent-skills به مخزن

       • انتخاب برچسب نسخه (توصیه می‌شود از نگارش معنادار یا semver استفاده
         شود)

       • ایجاد یک ریلیز در گیت‌هاب همراه با یادداشت‌های انتشار به‌طور خودکار
         تولیدشده


       از --dry-run برای اعتبارسنجی بدون انتشار استفاده کنید.  از --tag برای
       انتشار غیرتعاملی با یک برچسب خاص استفاده نمایید.  از --fix برای حذف
       خودکار متادیتای نصب از فایل‌های کامیت‌شده بدون انتشار استفاده کنید.
       تغییرات را بررسی و کامیت کرده، سپس دستور publish را دوباره اجرا
       فرمایید.



گزینه‌ها (OPTIONS)
       --dry-run
              اعتبارسنجی بدون انتشار


       --fix  رفع خودکار مشکلات در صورت امکان بدون انتشار (مانند حذف متادیتای
              نصب)


       --tag <string>
              برچسب نسخه برای انتشار (مانند v1.0.0)



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


       1: خطا


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


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


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



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

       # انتشار با یک برچسب مشخص (غیرتعاملی)
       $ gh skill publish --tag v1.0.0

       # فقط اعتبارسنجی (بدون انتشار)
       $ gh skill publish --dry-run

       # حذف متادیتای نصب بدون انتشار
       $ gh skill publish --fix




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

                                   Sep 2026                GH-SKILL-PUBLISH(1)