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.

OPTIONS

--allow-hidden-dirs
    Include skills in hidden directories (e.g. .claude/skills/, .agents/skills/)

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)