gh-skill-search(1)

gh-skill-search1

Search for skills across github (preview)

Usage

gh skill search <query> [flags]

Overview

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 status

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.

Examples

# 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

From github-cli 2.102.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.