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.

The skill argument can be a name, a namespaced name (author/skill), or an exact path within the repository (skills/author/skill, packages/agent-skills/code-review, or any .../SKILL.md path). Namespaced names with one slash are matched by name. Use a SKILL.md suffix to force a one-directory path outside the standard conventions.

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
    # Preview from a non-standard nested path (efficient, skips full discovery)
    $ gh skill preview monalisa/skills-repo packages/agent-skills/code-review
    # Browse and preview interactively
    $ gh skill preview github/awesome-copilot

SEE ALSO
gh-skill(1)