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)