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

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


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


.SH "توضیحات (DESCRIPTION)"
جستجو در تمام مخازن عمومی گیت‌هاب برای یافتن مهارت‌های منطبق با یک کلمه کلیدی.

.PP
از GitHub Code Search API برای یافتن فایل‌های
\fBSKILL.md\fR
که نام یا توضیحات آن‌ها با عبارت جستجو همخوانی دارد، استفاده می‌کند.

.PP
نتایج بر اساس میزان ارتباط رتبه‌بندی می‌شوند: مهارت‌هایی که نام آن‌ها شامل عبارت جستجو باشد، در ابتدا نمایش داده می‌شوند.

.PP
از
.B \-\-owner
برای محدود کردن دامنه نتایج به یک کاربر یا سازمان خاص در گیت‌هاب استفاده کنید.

.PP
در حالت تعاملی، می‌توانید مهارت‌ها را مستقیماً از میان نتایج برای نصب انتخاب نمایید.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-q\fR, \fB--jq\fR \fB<expression>\fR
فیلتر کردن خروجی JSON با استفاده از عبارت jq

.TP
\fB--json\fR \fB<fields>\fR
تولید خروجی JSON با فیلدهای مشخص‌شده

.TP
\fB-L\fR, \fB--limit\fR \fB<int> (default 15)\fR
حداکثر تعداد نتایج در هر صفحه

.TP
\fB--owner\fR \fB<string>\fR
فیلتر کردن نتایج به یک کاربر یا سازمان خاص در گیت‌هاب

.TP
\fB--page\fR \fB<int> (default 1)\fR
شماره صفحه نتایج برای واکشی

.TP
\fB-t\fR, \fB--template\fR \fB<string>\fR
قالب‌بندی خروجی JSON با استفاده از الگوی Go؛ به "gh help formatting" مراجعه کنید


.SH "فیلدهای JSON (JSON FIELDS)"
\fBdescription\fR, \fBnamespace\fR, \fBpath\fR, \fBrepo\fR, \fBskillName\fR, \fBstars\fR


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# جستجو برای مهارت‌های مرتبط با terraform
$ gh skill search terraform

# جستجو برای مهارت‌های متعلق به یک مالک خاص
$ gh skill search terraform --owner hashicorp

# مشاهده صفحه دوم نتایج
$ gh skill search terraform --page 2

# محدود کردن نتایج به ۵ مورد
$ gh skill search terraform --limit 5
.EE


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