GH-SKILL-LIST(1)               GitHub CLI manual              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|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)

                                   Jun 2026                   GH-SKILL-LIST(1)