gh-skill-preview - Man Page
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