---
name: "gh-skill"
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"
---

# gh-skill(1)

Install and manage agent skills (preview)

## NAME

gh-skill - Install and manage agent skills (preview)

## SYNOPSIS

**gh skill \<command\> \[flags\]**

## DESCRIPTION

Install and manage agent skills from GitHub repositories.

Working with agent skills in the GitHub CLI is in preview and subject to change without notice.

## AVAILABLE COMMANDS

- **[gh-skill-install(1)](/gh-skill-install/1.md)**

  Install agent skills from a GitHub repository (preview)

- **[gh-skill-list(1)](/gh-skill-list/1.md)**

  List installed skills (preview)

- **[gh-skill-preview(1)](/gh-skill-preview/1.md)**

  Preview a skill from a GitHub repository (preview)

- **[gh-skill-publish(1)](/gh-skill-publish/1.md)**

  Validate and publish skills to a GitHub repository (preview)

- **[gh-skill-search(1)](/gh-skill-search/1.md)**

  Search for skills across GitHub (preview)

- **[gh-skill-update(1)](/gh-skill-update/1.md)**

  Update installed skills to their latest versions (preview)

## ALIASES

gh skills

## 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
$ gh skill search terraform
# Install a skill
$ gh skill install github/awesome-copilot documentation-writer
# List installed skills
$ gh skill list
# Preview a skill before installing
$ gh skill preview github/awesome-copilot documentation-writer
# Update all installed skills
$ gh skill update --all
# Validate skills for publishing
$ gh skill publish --dry-run
```

## SEE ALSO

**[gh(1)](/gh/1.md)**