GH-SKILL-PREVIEW(1)

💅 gh-skill-preview — bestie's guide to peeking at skills 👀✨

okay so real talk, this is a page from the GitHub CLI manual (that's the gh thing you already have installed, mwah) and it covers gh-skill-preview, which is preview — yes, still in preview, so be nice to it 🎀

---

🌸 NAME 🌸

gh-skill-preview — preview a skill from a GitHub repository. it's literally in preview mode, iykyk ✨

---

🦋 SYNOPSIS 🦋

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

that's it, that's the whole mood 💅

---

💖 DESCRIPTION 💖

so what this does is render a skill's SKILL.md content right in your terminal. it fetches the skill file from the repository and shows it to you using whatever pager you've got configured — and ngl, the best part: it does this without installing anything. zero commitment, no cap 🫶

first you get a file tree, then the rendered SKILL.md content. the way that works is: when you're running interactively and the skill has extra files hanging around (scripts, references, etc.), a file picker pops up so you can browse them one by one. iconic behaviour honestly 🌈

if you run it with only a repository argument? it lists the available skills and prompts you to pick one. cute and helpful 💜

now the <skill> argument — she's flexible, okay. it can be any of these:

• a plain name
• a namespaced name, like author/skill
• an exact path within the repository, like skills/author/skill, packages/agent-skills/code-review, or any .../SKILL.md path

namespaced names with one slash get matched by name. and if you want to force a one-directory path that lives outside the standard conventions, just slap a SKILL.md suffix on it 🎯

oh and! to preview a specific version of a skill, append @VERSION to the skill name. the version gets resolved as a git tag, branch, or commit SHA. time travel, lowkey 🕰️✨

---

✨ OPTIONS ✨

• --allow-hidden-dirs — include skills that live in hidden directories (e.g. .claude/skills/, .agents/skills/). yes, the sneaky dotfolders get invited to the party too 🙈

---

👑 ALIASES 👑

these are the same command wearing a different outfit:

• gh skill show
• gh skills show

slay, versatile 💅

---

🔥 EXIT CODES 🔥

• 0 — successful execution (we love a happy ending 🥳)
• 1 — error (it's giving oops 😭)
• 2 — command canceled (you backed out, no judgement 💀)
• 4 — authentication required (log in bestie 🔐)

NOTE: specific commands may have additional exit codes. refer to the command's help for more information. don't come for me, that's just what it says 📋

---

🎀 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

that last one — just repo, no skill — is the "let me browse" vibe and honestly it ate 🍓

---

🧚 SEE ALSO 🧚

• gh-skill(1) — go read the main one, bestie, it's the parent 🫶

---

and that's the whole page!! brought to you by GitHub CLI v2.102.0, dated Oct 2026 — go forth and preview responsibly, ily, bye 💖✨🌸