---
name: "gh-skill-search"
section: "1"
platform: "linux"
package: "github-cli"
version: "2.102.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gh-skill-search"
---

# gh-skill-search(1)

Search for skills across GitHub (preview)

## 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)](/gh-skill/1.md)**