GH-SKILL-LIST(1)

💅 GH-SKILL-LIST(1) — the GitHub CLI manual, bestie edition ✨

okay so this is gh-skill-list, straight out of the GitHub CLI manual, and I'm gonna walk you through it like we're texting at 1am 🫶

---

🌸 NAME 🌸

gh-skill-list — list your installed skills, and yes it's still in preview (she's in her soft-launch era 🎀)

---

🦋 SYNOPSIS 🦋

gh skill list [flags]

---

✨ DESCRIPTION ✨

Okay so picture this: you've got agent skills scattered all over your machine, and this command is the friend who goes "bestie, let me just find them all for you." 💖 It lists your installed agent skills across all the known agent host directories.

By default? It scans all supported agent hosts in both project and user scope. Like, she's thorough. Obsessed.

But you can narrow it down, iykyk:

• use --agent to scan just one host
• use --scope to scan only project scope or only user scope
• use --dir to scan a custom skills directory of your choosing

And where do these scopes even live, you ask? 🌈

• Project-scope skills get discovered relative to the current git repository root 📁
• User-scope skills get discovered relative to your home directory 🏠

no cap, that's the whole map.

---

👑 OPTIONS 👑

• --agent <string> — filter by target agent. the full lineup (and yes, every single one, don't @ me): {github-copilot|claude-code|cursor|codex|gemini-cli|antigravity|antigravity-cli|antigravity2.0|adal|amp|augment|bob|cline|codebuddy|command-code|continue|cortex|crush|deepagents|devin|droid|firebender|goose|grok|iflow-cli|junie|kilo|kimi-cli|kiro-cli|kode|mcpjam|mistral-vibe|mux|neovate|openclaw|opencode|openhands|pi|pochi|qoder|qwen-code|replit|roo|trae|trae-cn|universal|warp|zencoder} 🎯
• --dir <string> — scan a custom directory for installed skills. your rules, your folder 🗂️
• -q, --jq <expression> — filter that JSON output using a jq expression, the way nature intended 💅
• --json <fields> — output JSON with the fields you specify. picky and I respect it ✨
• --scope <string> — filter by installation scope: {project|user} 🔍
• -t, --template <string> — format JSON output using a Go template; see gh help formatting for the deets 🎀

---

🌟 ALIASES 🌟

she answers to all her names, fr fr:

• gh skill ls
• gh skills ls

---

🧚 JSON FIELDS 🧚

the whole menu for --json, no substitutions:

• agentHosts
• path
• pinned
• scope
• skillName
• sourceURL
• version

---

💀 EXIT CODES 💀

so she'll tell you exactly how it went:

• 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. (iykyk — always check the help, bestie 🫶)

---

🔥 EXAMPLE 🔥

here's the vibe check in practice, copy-paste ready:

# List all installed skills
$ gh skill list

# List skills installed for GitHub Copilot
$ gh skill list --agent github-copilot

# List user-scope skills
$ gh skill list --scope user

# List skills as JSON
$ gh skill list --json skillName,sourceURL,scope,version,pinned,path

the last one? she ate. 💅

---

💜 SEE ALSO 💜

• gh-skill(1) — go read the parent page, she's iconic too 👑

---

and that's the page, bestie! ✨ brought to you by GitHub CLI v2.102.0, dated Oct 2026 — mwah, love u, go list some skills 🍓💖🦋