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



NAME
       gh-skill-search - Search for skills across GitHub (preview)



SYNOPSIS
       gh skill search <query> [flags]



DESCRIPTION
       Search across all public GitHub repositories for skills matching a
       keyword.


       Uses the GitHub Code Search API to find SKILL.md files whose name or
       description matches the query term.


       Results are ranked by relevance: skills whose name contains the query
       term appear first.


       Use --owner to scope results to a specific GitHub user or organization.


       In interactive mode, you can select skills from the results to install
       directly.



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


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


       -L, --limit <int> (default 15)
              Maximum number of results per page


       --owner <string>
              Filter results to a specific GitHub user or organization


       --page <int> (default 1)
              Page number of results to fetch


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



JSON FIELDS
       description, namespace, path, repo, skillName, stars



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
       # Search for skills related to terraform
       $ gh skill search terraform

       # Search for skills from a specific owner
       $ gh skill search terraform --owner hashicorp

       # View the second page of results
       $ gh skill search terraform --page 2

       # Limit results to 5
       $ gh skill search terraform --limit 5




SEE ALSO
       gh-skill(1)

                                   Apr 2026                 GH-SKILL-SEARCH(1)