---
name: "gh-skill-preview"
section: "1"
platform: "linux"
package: "github-cli"
version: "2.102.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gh-skill-preview"
---

# gh-skill-preview(1)

Preview a skill from a GitHub repository (preview)

## 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)](/gh-skill/1.md)**