GH-SKILL-LIST(1)

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

SYNOPSIS
gh skill list [flags]

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

--agent <string>
    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|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}

--dir <string>
    Scan a custom directory for installed skills

-q, --jq <expression>
    Filter JSON output using a jq expression

--json <fields>
    Output JSON with the specified fields

--scope <string>
    Filter by installation scope: {project|user}

-t, --template <string>
    Format JSON output using a Go template; see "gh help formatting"

ALIASES
gh skill ls, gh skills ls

JSON FIELDS
agentHosts, path, pinned, scope, skillName, sourceURL, version

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
    # 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
gh-skill(1)