.nh
.TH "GH-SKILL-SEARCH" "1" "Apr 2026" "" "GitHub CLI manual"

.SH NAME
gh-skill-search - Search for skills across GitHub (preview)


.SH SYNOPSIS
\fBgh skill search <query> [flags]\fR


.SH DESCRIPTION
Search across all public GitHub repositories for skills matching a keyword.

.PP
Uses the GitHub Code Search API to find \fBSKILL.md\fR files whose name or
description matches the query term.

.PP
Results are ranked by relevance: skills whose name contains the query
term appear first.

.PP
Use \fB--owner\fR to scope results to a specific GitHub user or organization.

.PP
In interactive mode, you can select skills from the results to install directly.


.SH OPTIONS
.TP
\fB-q\fR, \fB--jq\fR \fB<expression>\fR
Filter JSON output using a jq expression

.TP
\fB--json\fR \fB<fields>\fR
Output JSON with the specified fields

.TP
\fB-L\fR, \fB--limit\fR \fB<int> (default 15)\fR
Maximum number of results per page

.TP
\fB--owner\fR \fB<string>\fR
Filter results to a specific GitHub user or organization

.TP
\fB--page\fR \fB<int> (default 1)\fR
Page number of results to fetch

.TP
\fB-t\fR, \fB--template\fR \fB<string>\fR
Format JSON output using a Go template; see "gh help formatting"


.SH JSON FIELDS
\fBdescription\fR, \fBnamespace\fR, \fBpath\fR, \fBrepo\fR, \fBskillName\fR, \fBstars\fR


.SH EXIT CODES
0: Successful execution

.PP
1: Error

.PP
2: Command canceled

.PP
4: Authentication required

.PP
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.


.SH EXAMPLE
.EX
# 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

.EE


.SH SEE ALSO
\fBgh-skill(1)\fR