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)