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