Text of cli.github.com › manual › gh_skill_preview as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout.

Open the live page

GitHub CLI | Take GitHub to the command line

CLI manual gh skill preview gh skill preview <repository> [<skill>] [flags] 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 skills show, gh skill show Examples # 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