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



NAME
       gh-skill-preview - Preview a skill from a GitHub repository (preview)



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



DESCRIPTION
       Render a skill's SKILL.md content in the terminal. This fetches the
       skill file from the repository and displays it using the configured
       pager, without installing anything.


       A file tree is shown first, followed by the rendered SKILL.md content.
       When running interactively and the skill contains additional files
       (scripts, references, etc.), a file picker lets you browse them
       individually.


       When run with only a repository argument, lists available skills and
       prompts for selection.


       To preview a specific version of the skill, append @VERSION to the
       skill name. The version is resolved as a git tag, branch, or commit
       SHA.



ALIASES
       gh skill show, gh skills show



EXIT CODES
       0: Successful execution


       1: Error


       2: Command canceled


       4: Authentication required


       NOTE: Specific commands may have additional exit codes. Refer to the
       command's help for more information.



EXAMPLE
       # Preview a specific skill
       $ gh skill preview github/awesome-copilot documentation-writer

       # Preview a skill at a specific version
       $ gh skill preview github/awesome-copilot documentation-writer@v1.2.0

       # Preview a skill at a specific commit SHA
       $ gh skill preview github/awesome-copilot documentation-writer@abc123def456

       # Browse and preview interactively
       $ gh skill preview github/awesome-copilot




SEE ALSO
       gh-skill(1)

                                   Apr 2026                GH-SKILL-PREVIEW(1)