.nh
.TH "GH-SKILL-LIST" "1" "Jun 2026" "" "GitHub CLI manual"

.SH NAME
gh-skill-list - List installed skills (preview)


.SH SYNOPSIS
\fBgh skill list [flags]\fR


.SH DESCRIPTION
List installed agent skills across known agent host directories.

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

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


.SH OPTIONS
.TP
\fB--agent\fR \fB<string>\fR
Filter by target agent: {github-copilot|claude-code|cursor|codex|gemini-cli|antigravity|adal|amp|augment|bob|cline|codebuddy|command-code|continue|cortex|crush|deepagents|droid|firebender|goose|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|windsurf|zencoder}

.TP
\fB--dir\fR \fB<string>\fR
Scan a custom directory for installed skills

.TP
\fB-q\fR, \fB--jq\fR \fB<expression>\fR
Filter JSON output using a jq expression

.TP
\fB--json\fR \fB<fields>\fR
Output JSON with the specified fields

.TP
\fB--scope\fR \fB<string>\fR
Filter by installation scope: {project|user}

.TP
\fB-t\fR, \fB--template\fR \fB<string>\fR
Format JSON output using a Go template; see "gh help formatting"


.SH ALIASES
gh skill ls, gh skills ls


.SH JSON FIELDS
\fBagentHosts\fR, \fBpath\fR, \fBpinned\fR, \fBscope\fR, \fBskillName\fR, \fBsourceURL\fR, \fBversion\fR


.SH EXIT CODES
0: Successful execution

.PP
1: Error

.PP
2: Command canceled

.PP
4: Authentication required

.PP
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.


.SH EXAMPLE
.EX
# 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

.EE


.SH SEE ALSO
\fBgh-skill(1)\fR