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

.SH "نام (NAME)"
gh-skill-install \- نصب مهارت‌های ایجنت از یک مخزن گیت‌هاب (پیش‌نمایش)


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


.SH "توضیحات (DESCRIPTION)"
نصب مهارت‌های ایجنت (agent skills) از یک مخزن گیت‌هاب یا یک دایرکتوری محلی در محیط محلی شما. مهارت‌ها در دایرکتوری ویژه‌ی میزبان (host-specific) در سطح پروژه (project scope، درون مخزن فعلی گیت) یا سطح کاربر (user scope، در دایرکتوری خانگی شما و در دسترس در همه‌جا) قرار می‌گیرند.

.PP
طیف گسترده‌ای از ایجنت‌های کدنویسی هوش مصنوعی پشتیبانی می‌شوند، از جمله GitHub Copilot، Claude Code، Cursor، Codex، Gemini CLI، Antigravity، Amp، Devin، Goose، Grok، Junie، OpenCode و بسیاری موارد دیگر.

.PP
مقادیر پشتیبانی‌شده برای \fB\-\-agent\fR:
.IP \(bu 2
GitHub Copilot (github-copilot)
.IP \(bu 2
Claude Code (claude-code)
.IP \(bu 2
Cursor (cursor)
.IP \(bu 2
Codex (codex)
.IP \(bu 2
Gemini CLI (gemini-cli)
.IP \(bu 2
Antigravity (antigravity)
.IP \(bu 2
Antigravity CLI (antigravity-cli)
.IP \(bu 2
Antigravity 2.0 (antigravity2.0)
.IP \(bu 2
AdaL (adal)
.IP \(bu 2
Amp (amp)
.IP \(bu 2
Augment (augment)
.IP \(bu 2
IBM Bob (bob)
.IP \(bu 2
Cline (cline)
.IP \(bu 2
CodeBuddy (codebuddy)
.IP \(bu 2
Command Code (command-code)
.IP \(bu 2
Continue (continue)
.IP \(bu 2
Cortex Code (cortex)
.IP \(bu 2
Crush (crush)
.IP \(bu 2
Deep Agents (deepagents)
.IP \(bu 2
Devin (devin)
.IP \(bu 2
Droid (droid)
.IP \(bu 2
Firebender (firebender)
.IP \(bu 2
Goose (goose)
.IP \(bu 2
Grok (grok)
.IP \(bu 2
iFlow CLI (iflow-cli)
.IP \(bu 2
Junie (junie)
.IP \(bu 2
Kilo Code (kilo)
.IP \(bu 2
Kimi Code CLI (kimi-cli)
.IP \(bu 2
Kiro CLI (kiro-cli)
.IP \(bu 2
Kode (kode)
.IP \(bu 2
MCPJam (mcpjam)
.IP \(bu 2
Mistral Vibe (mistral-vibe)
.IP \(bu 2
Mux (mux)
.IP \(bu 2
Neovate (neovate)
.IP \(bu 2
OpenClaw (openclaw)
.IP \(bu 2
OpenCode (opencode)
.IP \(bu 2
OpenHands (openhands)
.IP \(bu 2
Pi (pi)
.IP \(bu 2
Pochi (pochi)
.IP \(bu 2
Qoder (qoder)
.IP \(bu 2
Qwen Code (qwen-code)
.IP \(bu 2
Replit (replit)
.IP \(bu 2
Roo Code (roo)
.IP \(bu 2
Trae (trae)
.IP \(bu 2
Trae CN (trae-cn)
.IP \(bu 2
Universal (universal)
.IP \(bu 2
Warp (warp)
.IP \(bu 2
Zencoder (zencoder)

.PP
از \fB\-\-agent\fR و \fB\-\-scope\fR برای کنترل محل قرارگیری، یا از \fB\-\-dir\fR برای یک دایرکتوری سفارشی استفاده کنید. محدوده پیش‌فرض \fBproject\fR و ایجنت پیش‌فرض \fBgithub-copilot\fR است (هنگام اجرای غیرتعاملی).

.PP
در سطح پروژه، چندین ایجنت (شامل GitHub Copilot، Cursor، Codex، Gemini CLI، Antigravity، Amp، Cline، OpenCode و Warp) دایرکتوری \fB\&.agents/skills\fR را به اشتراک می‌گذارند. اگر چند میزبان انتخاب کنید که به مقصد یکسانی منتهی شوند، هر مهارت فقط یک‌بار در آنجا نصب می‌شود.

.PP
اولین آرگومان، یک مخزن گیت‌هاب در قالب \fBOWNER/REPO\fR است. برای نصب از یک دایرکتوری محلی به جای مخزن، از \fB\-\-from-local\fR استفاده کنید. مهارت‌های محلی با همان قراردادهای مخازن ریموت به صورت خودکار شناسایی می‌شوند و فایل‌ها کپی می‌شوند (نه لینک نمادین یا symlink) و متادیتای ردیابی مسیر محلی به frontmatter اضافه می‌گردد.

.PP
مهارت‌ها به صورت خودکار با استفاده از قرارداد \fBskills/*/SKILL.md\fR تعریف‌شده در مشخصات Agent Skills شناسایی می‌شوند، حتی زمانی که دایرکتوری \fBskills/\fR در زیر یک پیشوند تودرتو باشد (مانند \fBterraform/code-generation/skills/...\fR). برای اطلاعات بیشتر در مورد مشخصات فنی، به این آدرس مراجعه کنید: https://agentskills.io/specification

.PP
آرگومان مهارت می‌تواند یک نام، یک نام دارای فضای‌نام (\fBauthor/skill\fR) یا یک مسیر دقیق در مخزن (\fBskills/author/skill\fR، \fBpackages/agent-skills/code-review\fR یا هر مسیر دیگر به فرمت \fB\&.../SKILL.md\fR) باشد. نام‌های دارای فضای‌نام که تنها یک اسلش دارند بر اساس نام تطبیق داده می‌شوند. برای اجبار به استفاده از مسیر تک‌پوشه‌ای خارج از قراردادهای استاندارد، از پسوند \fBSKILL.md\fR استفاده کنید.

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

.PP
هنگامی که نام یک مهارت بدون نسخه ارائه شود، این ابزار نسخه را به این ترتیب مشخص می‌کند:
.IP "  1." 5
جدیدترین نسخه برچسب‌خورده (tagged release) در مخزن
.IP "  2." 5
کامیت رأس (HEAD) در شاخه پیش‌فرض

.PP
برای تثبیت به یک نسخه خاص، یا عبارت \fB@VERSION\fR را به انتهای نام مهارت اضافه کنید یا از فلگ \fB\-\-pin\fR استفاده نمایید. این نسخه در قالب یک برچسب (tag) گیت یا شناسه کامیت (commit SHA) حل و واکشی می‌شود.

.PP
مهارت‌های نصب‌شده دارای متادیتای ردیابی منبع هستند که در frontmatter آن‌ها درج شده است. این متادیتا مخزن مبدا را مشخص کرده و به \fBgh skill update\fR اجازه می‌دهد تغییرات را شناسایی کند.

.PP
در صورت اجرای تعاملی، دستور هرگونه آرگومان مفقود را از کاربر درخواست می‌کند.

.PP
از \fB\-\-all\fR برای نصب تمام مهارت‌های شناسایی‌شده از مخزن بدون نیاز به تأیید تعاملی انتخاب مهارت استفاده کنید. در حالت اجرای غیرتعاملی، ارائه \fBrepository\fR الزامی است؛ بدون ذکر نام مهارت یا گزینه \fB\-\-all\fR، مهارت‌های منطبق فهرست می‌شوند (هنگام استفاده از پایپ، به صورت مقادیر تفکیک‌شده با تب) تا بتوانید پیش از اجرای مجدد با یک مهارت خاص، آن‌ها را با ابزارهایی مانند \fBgrep\fR مرور یا فیلتر کنید.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-agent\fR \fB<string>\fR
ایجنت هدف (مقادیر پشتیبانی‌شده را در بالا ببینید)

.TP
\fB\-\-all\fR
نصب همه مهارت‌ها بدون درخواست تعاملی برای انتخاب مهارت

.TP
\fB\-\-allow-hidden-dirs\fR
شامل کردن مهارت‌های موجود در دایرکتوری‌های مخفی (مانند \fI.claude/skills/\fR، \fI.agents/skills/\fR)

.TP
\fB\-\-dir\fR \fB<string>\fR
نصب در یک دایرکتوری سفارشی (تنظیمات \-\-agent و \-\-scope را لغو می‌کند)

.TP
\fB\-f\fR, \fB\-\-force\fR
بازنویسی مهارت‌های موجود بدون درخواست تأیید

.TP
\fB\-\-from-local\fR
تلقی کردن آرگومان به عنوان مسیر یک دایرکتوری محلی به جای مخزن

.TP
\fB\-\-pin\fR \fB<string>\fR
تثبیت بر روی یک برچسب (tag) یا شناسه کامیت (commit SHA) خاص در گیت

.TP
\fB\-\-scope\fR \fB<string> (پیش‌فرض "project")\fR
محدوده نصب: {project|user}

.TP
\fB\-\-upstream\fR
نصب از منبع بالادست (upstream) هنگام تشخیص یک مهارت بازنشرشده


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


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# حالت تعاملی: انتخاب مخزن، مهارت و ایجنت
$ gh skill install

# انتخاب تعاملی یک مهارت از مخزن
$ gh skill install github/awesome-copilot

# فهرست کردن مهارت‌های موجود به صورت غیرتعاملی (مثلاً برای ارسال با پایپ به grep)
$ gh skill install github/awesome-copilot | grep review

# نصب یک مهارت خاص
$ gh skill install github/awesome-copilot git-commit

# نصب تمام مهارت‌های موجود در یک مخزن
$ gh skill install github/awesome-copilot --all

# نصب یک نسخه خاص
$ gh skill install github/awesome-copilot git-commit@v1.2.0

# نصب از یک مخزن بزرگ دارای فضای‌نام از طریق مسیر (بهینه، بدون پیمایش کامل)
$ gh skill install github/awesome-copilot skills/monalisa/code-review

# نصب از یک مسیر تودرتوی غیراستاندارد (بهینه، بدون پیمایش کامل)
$ gh skill install monalisa/skills-repo packages/agent-skills/code-review

# نصب از یک دایرکتوری محلی
$ gh skill install ./my-skills-repo --from-local

# نصب یک مهارت محلی خاص
$ gh skill install ./my-skills-repo git-commit --from-local

# نصب برای Claude Code در سطح کاربر
$ gh skill install github/awesome-copilot git-commit --agent claude-code --scope user

# تثبیت بر روی یک ارجاع (ref) خاص در گیت
$ gh skill install github/awesome-copilot git-commit --pin v2.0.0

# نصب مهارت‌ها از دایرکتوری‌های مخفی (مانند .claude/skills/)
$ gh skill install owner/repo --allow-hidden-dirs

.EE


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