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

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

gh skill install <repository> [<skill[@version]>] [flags]

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

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

مقادیر پشتیبانی‌شده برای --agent:

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

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

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

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

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

آرگومان مهارت می‌تواند یک نام، یک نام دارای فضای‌نام (author/skill) یا یک مسیر دقیق در مخزن (skills/author/skill، packages/agent-skills/code-review یا هر مسیر دیگر به فرمت .../SKILL.md) باشد. نام‌های دارای فضای‌نام که تنها یک اسلش دارند بر اساس نام تطبیق داده می‌شوند. برای اجبار به استفاده از مسیر تک‌پوشه‌ای خارج از قراردادهای استاندارد، از پسوند SKILL.md استفاده کنید.

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

هنگامی که نام یک مهارت بدون نسخه ارائه شود، این ابزار نسخه را به این ترتیب مشخص می‌کند:

1.
جدیدترین نسخه برچسب‌خورده (tagged release) در مخزن
2.
کامیت رأس (HEAD) در شاخه پیش‌فرض

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

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

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

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

ایجنت هدف (مقادیر پشتیبانی‌شده را در بالا ببینید)
نصب همه مهارت‌ها بدون درخواست تعاملی برای انتخاب مهارت
شامل کردن مهارت‌های موجود در دایرکتوری‌های مخفی (مانند .claude/skills/، .agents/skills/)
نصب در یک دایرکتوری سفارشی (تنظیمات --agent و --scope را لغو می‌کند)
بازنویسی مهارت‌های موجود بدون درخواست تأیید
تلقی کردن آرگومان به عنوان مسیر یک دایرکتوری محلی به جای مخزن
تثبیت بر روی یک برچسب (tag) یا شناسه کامیت (commit SHA) خاص در گیت
محدوده نصب: {project|user}
نصب از منبع بالادست (upstream) هنگام تشخیص یک مهارت بازنشرشده

gh skill add, gh skills add

0: اجرای موفقیت‌آمیز

1: خطا

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

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

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

# حالت تعاملی: انتخاب مخزن، مهارت و ایجنت
$ 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

gh-skill(1)

Sep 2026