.nh
.TH "GH-SKILL-PUBLISH" "1" "Sep 2026" "" "GitHub CLI manual"

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


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh skill publish [<directory>] [flags]\fR


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

.PP
مهارت‌ها با همان قواعد دستوری مشابه دستور install شناسایی می‌شوند:
.IP \(bu 2
\fBskills/*/SKILL.md\fR
.IP \(bu 2
\fBskills/{scope}/*/SKILL.md\fR
.IP \(bu 2
\fB*/SKILL.md\fR (در سطح ریشه)
.IP \(bu 2
\fBplugins/{scope}/skills/*/SKILL.md\fR

.PP
بررسی‌های اعتبارسنجی شامل موارد زیر است:
.IP \(bu 2
نام‌های مهارت‌ها با قوانین دقیق نام‌گذاری agentskills.io مطابقت داشته باشند
.IP \(bu 2
نام هر مهارت با نام دایرکتوری آن همخوانی داشته باشد
.IP \(bu 2
فیلدهای الزامی بخش فرانت‌متر (name و description) وجود داشته باشند
.IP \(bu 2
فیلد allowed-tools یک رشته باشد و نه یک آرایه
.IP \(bu 2
متادیتای نصب (\fBmetadata.github-*\fR) در صورت وجود حذف شود

.PP
پس از موفقیت در اعتبارسنجی، فرآیند انتشار شما را به‌صورت تعاملی در مراحل زیر هدایت می‌کند:
.IP \(bu 2
افزودن موضوع (topic) به نام \fBagent-skills\fR به مخزن
.IP \(bu 2
انتخاب برچسب نسخه (توصیه می‌شود از نگارش معنادار یا semver استفاده شود)
.IP \(bu 2
ایجاد یک ریلیز در گیت‌هاب همراه با یادداشت‌های انتشار به‌طور خودکار تولیدشده

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


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-dry-run\fR
اعتبارسنجی بدون انتشار

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

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


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

.PP
1: خطا

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

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

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


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

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

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

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

.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBgh-skill(1)\fR