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

.SH "نام (NAME)"
gh-skill-list \- فهرست کردن مهارت‌های نصب‌شده (پیش‌نمایش)


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


.SH "توضیحات (DESCRIPTION)"
فهرست کردن مهارت‌های ایجنت (agent skills) نصب‌شده در تمام دایرکتوری‌های شناخته‌شده‌ی میزبان ایجنت.

.PP
به‌طور پیش‌فرض، تمام میزبان‌های ایجنتِ پشتیبانی‌شده را در هر دو محدوده پروژه (project scope) و محدوده کاربر (user scope) پویش می‌کند. از \fB\-\-agent\fR برای پویش یک میزبان، از \fB\-\-scope\fR برای پویش فقط در محدوده پروژه یا کاربر، یا از \fB\-\-dir\fR برای پویش یک دایرکتوری سفارشی مهارت‌ها استفاده کنید.

.PP
مهارت‌های سطح پروژه نسبت به ریشه مخزن گیت فعلی شناسایی می‌شوند. مهارت‌های سطح کاربر نسبت به پوشه خانگی شما شناسایی می‌شوند.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-agent\fR \fB<string>\fR
فیلتر کردن بر اساس ایجنت هدف: {github-copilot|claude-code|cursor|codex|gemini-cli|antigravity|antigravity-cli|antigravity2.0|adal|amp|augment|bob|cline|codebuddy|command-code|continue|cortex|crush|deepagents|devin|droid|firebender|goose|grok|iflow-cli|junie|kilo|kimi-cli|kiro-cli|kode|mcpjam|mistral-vibe|mux|neovate|openclaw|opencode|openhands|pi|pochi|qoder|qwen-code|replit|roo|trae|trae-cn|universal|warp|zencoder}

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

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

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

.TP
\fB\-\-scope\fR \fB<string>\fR
فیلتر کردن بر اساس محدوده نصب: {project|user}

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


.SH "نام‌های مستعار (ALIASES)"
gh skill ls, gh skills ls


.SH "فیلدهای JSON (JSON FIELDS)"
\fBagentHosts\fR, \fBpath\fR, \fBpinned\fR, \fBscope\fR, \fBskillName\fR, \fBsourceURL\fR, \fBversion\fR


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# فهرست کردن تمامی مهارت‌های نصب‌شده
$ gh skill list

# فهرست کردن مهارت‌های نصب‌شده برای GitHub Copilot
$ gh skill list --agent github-copilot

# فهرست کردن مهارت‌های سطح کاربر
$ gh skill list --scope user

# نمایش مهارت‌ها در قالب JSON
$ gh skill list --json skillName,sourceURL,scope,version,pinned,path

.EE


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