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

# [NAME](#NAME)

gh-skill-list - List installed skills (preview)

# [SYNOPSIS](#SYNOPSIS)

**gh skill list \[flags]**

# [DESCRIPTION](#DESCRIPTION)

List installed agent skills across known agent host directories.

By default, scans all supported agent hosts in both project and user scope. Use **--agent** to scan one host, **--scope** to scan only project or user scope, or **--dir** to scan a custom skills directory.

Project-scope skills are discovered relative to the current git repository root. User-scope skills are discovered relative to your home directory.

# [OPTIONS](#OPTIONS)

[**--agent** **<string>**](#agent)

Filter by target agent: {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>**](#dir)

Scan a custom directory for installed skills

[**-q**, **--jq** **<expression>**](#q)

Filter JSON output using a jq expression

[**--json** **<fields>**](#json)

Output JSON with the specified fields

[**--scope** **<string>**](#scope)

Filter by installation scope: {project|user}

[**-t**, **--template** **<string>**](#t)

Format JSON output using a Go template; see "gh help formatting"

# [ALIASES](#ALIASES)

gh skill ls, gh skills ls

# [JSON FIELDS](#JSON_FIELDS)

**agentHosts**, **path**, **pinned**, **scope**, **skillName**, **sourceURL**, **version**

# [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)

```
# 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
```

# [SEE ALSO](#SEE_ALSO)

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

Oct 2026

---

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