gh-skill-search - Man Page

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)

Referenced By

gh-skill(1).

May 2026 GitHub CLI manual