GH-SKILL-PREVIEW(1) GitHub CLI manual GH-SKILL-PREVIEW(1)

# [NAME](#NAME)

gh-skill-preview - Preview a skill from a GitHub repository (preview)

# [SYNOPSIS](#SYNOPSIS)

**gh skill preview <repository> \[<skill>] \[flags]**

# [DESCRIPTION](#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](#OPTIONS)

[**--allow-hidden-dirs**](#allow_hidden_dirs)

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

# [ALIASES](#ALIASES)

gh skill show, gh skills show

# [EXIT CODES](#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](#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](#SEE_ALSO)

[**gh-skill(1)**](/man/os/gh/gh-skill.1)

Oct 2026

---

Document: gh-skill-preview(1) from gh 2.103.2-r0 (Chainguard OS)
Source: https://github.com/cli/cli