نام (NAME)

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

خلاصه دستور (SYNOPSIS)

gh skill preview <repository> [<skill>] [flags]

توضیحات (DESCRIPTION)

محتوای فایل SKILL.md یک مهارت را در ترمینال نمایش می‌دهد. این دستور بدون نیاز به نصب هرگونه موردی، فایل مهارت را از مخزن دریافت کرده و با استفاده از صفحه‌بندی‌کننده (pager) پیکربندی‌شده نشان می‌دهد.

ابتدا ساختار درختی فایل‌ها نمایش داده می‌شود و سپس محتوای رندرشده‌ی SKILL.md ارائه می‌گردد. در صورت اجرای تعاملی، اگر مهارت شامل فایل‌های جانبی دیگری باشد (مانند اسکریپت‌ها، ارجاعات و غیره)، یک ابزار انتخاب فایل (file picker) به شما امکان می‌دهد آن‌ها را به‌صورت جداگانه بررسی نمایید.

در صورت اجرا فقط با شناسه مخزن (آرگومان repository)، فهرست مهارت‌های موجود نمایش داده شده و برای انتخاب از شما درخواست می‌شود.

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

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

گزینه‌ها (OPTIONS)

--allow-hidden-dirs

شامل کردن مهارت‌های موجود در دایرکتوری‌های مخفی (مانند .claude/skills/، .agents/skills/)

نام‌های مستعار (ALIASES)

gh skill show, gh skills show

کدهای خروج (EXIT CODES)

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

1: خطا

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

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

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

مثال‌ها (EXAMPLES)

# پیش‌نمایش یک مهارت خاص
$ gh skill preview github/awesome-copilot documentation-writer
# پیش‌نمایش یک مهارت در نسخه‌ای مشخص
$ gh skill preview github/awesome-copilot documentation-writer@v1.2.0
# پیش‌نمایش یک مهارت در شناسه کامیت (commit SHA) مشخص
$ gh skill preview github/awesome-copilot documentation-writer@abc123def456
# پیش‌نمایش از یک مسیر تودرتوی غیراستاندارد (بهینه‌تر، نادیده گرفتن پیمایش کامل)
$ gh skill preview monalisa/skills-repo packages/agent-skills/code-review
# مرور و پیش‌نمایش به‌صورت تعاملی
$ gh skill preview github/awesome-copilot

همچنین ببینید (SEE ALSO)

gh-skill(1)