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)