К основному содержанию
скилл CX Codex

gh-skill — скилл для Claude Code: управление навыками

Скилл gh-skill для Claude Code помогает искать, просматривать, устанавливать, обновлять и публиковать Agent Skills. Агент запускает его для управления набором навыков из GitHub-репозиториев.

MIT 164 установок ★ 47 132 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add cli/cli --skill gh-skill -a claude-code
Открыть на GitHub

Что делает gh-skill

gh-skill описывает работу с командой gh skill: она ищет навыки в GitHub, показывает содержимое перед установкой, устанавливает и обновляет их. Для установки можно выбрать хост через --agent, область project или user, а также закрепить версию с помощью --pin.

Команда публикует репозиторий как источник навыков: проверяет структуру SKILL.md, а затем может создать GitHub-релиз. Публикация добавляет тему agent-skills и отправляет незапушенные коммиты. В неинтерактивном режиме установка по умолчанию нацелена на github-copilot, поэтому для другого агента задают --agent.

Для локальной установки предусмотрен флаг --from-local; --pin с ним несовместим. Скилл также объясняет, как предварительно проверить публикацию через --dry-run и исправить метаданные установки через --fix.

Какие задачи решает

  • найти навык в GitHub по запросу
  • просмотреть содержимое навыка до установки
  • установить навык для выбранного агента и закрепить версию
  • обновить установленные навыки
  • проверить и опубликовать репозиторий с навыками

Примеры запросов агенту

  • Найди в GitHub скиллы для работы с тестами и покажи результаты в JSON.
  • Просмотри cli/cli и установи gh-skill для Claude Code с закреплённой версией.
  • Проверь репозиторий с навыками и подготовь публикацию с тегом v1.0.0.

Как установить gh-skill

1Через Skills CLI (Vercel)

npx skills add cli/cli --skill gh-skill -a claude-code

2Вручную: положить файлы

~/.claude/skills/gh-skill/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/gh-skill/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о gh-skill

Как установить gh-skill в Claude Code?

Выполни npx skills add cli/cli --skill gh-skill -a claude-code. Файл скилла устанавливается по пути ~/.claude/skills/gh-skill/SKILL.md.

Что делает gh-skill?

Он помогает агенту искать, просматривать, устанавливать и обновлять Agent Skills из GitHub, а также публиковать репозитории как источники навыков.

Как выбрать агента для установки навыка?

Укажи целевой хост флагом --agent, например --agent claude-code или --agent cursor. В неинтерактивном режиме без этого флага используется github-copilot.

Исходный текст

SKILL.md · MIT
---
name: gh-skill
description: Manage agent skills with gh skill. Use this skill to discover, preview, install, update, and publish Agent Skills so an agent can self-manage the skills available in its environment.
---

# Managing skills with `gh skill`

`gh skill` installs, previews, searches, updates, and publishes
[Agent Skills](https://agentskills.io). An agent can use it to keep its
own skill set in sync with one or more GitHub repositories.

The command is also aliased as `gh skills`. Prefer the canonical singular
`gh skill` in scripts and docs.

## Search

```bash
gh skill search <query>                                  # free-text search
gh skill search <query> --owner <org>                    # restrict to one owner
gh skill search <query> --limit 20 --page 2
gh skill search <query> --json skillName,repo,description
```

## Preview before installing

```bash
gh skill preview <owner>/<repo> <skill-name>
gh skill preview <owner>/<repo> <skill-name>@v1.2.0   # pin a version
```

## Install

```bash
gh skill install <owner>/<repo> <skill-name>
gh skill install <owner>/<repo> <skill-name>@v1.2.0
gh skill install <owner>/<repo> skills/<scope>/<skill-name>   # exact path, fastest
gh skill install ./local-skills-repo --from-local
```

`<owner>/<repo>` and `<skill-name>` are both required.

Useful flags:

- `--agent <id>` - target host (e.g. `github-copilot`, `claude-code`,
  `cursor`, `codex`, `gemini-cli`). Repeat for multiple. Default is
  `github-copilot` when non-interactive. You should know what agent you are,
  so set this appropriately to install for yourself.
- `--scope project|user` - `project` (default) writes inside the current
  git repo; `user` writes to the home directory and applies everywhere.
- `--pin <ref>` - pin to a tag, branch, or commit SHA. Mutually exclusive
  with `--from-local` and with inline `@version` syntax.
- `--allow-hidden-dirs` - also discover skills under dot-directories such
  as `.claude/skills/`. Don't use this unless you need to, it comes with risks.
- `--force` - overwrite an existing install.

## Update

```bash
gh skill update --all          # update every installed skill
gh skill update <skill>        # update one
gh skill update <skill> --force
gh skill update --unpin        # drop the pin and move to latest
```

## Publish

Publishing turns a repo into a discoverable skill source. Skills are
discovered with these conventions:

- `skills/<name>/SKILL.md`
- `skills/<scope>/<name>/SKILL.md`
- `<name>/SKILL.md` (root-level)
- `plugins/<scope>/skills/<name>/SKILL.md`

Each `SKILL.md` needs YAML frontmatter:

```yaml
---
name: my-skill                # must equal the directory name
description: One sentence...  # required, recommended <= 1024 chars
license: MIT                  # optional but recommended
---
```

### Validate, then publish

```bash
gh skill publish --dry-run                 # validate only, no release
gh skill publish --dry-run ./path/to/repo  # validate a specific dir
gh skill publish --fix                     # auto-strip install metadata
gh skill publish --tag v1.0.0              # non-interactive publish
gh skill publish                           # interactive publish flow
```

`--fix` and `--dry-run` are mutually exclusive. `--fix` only rewrites
install-injected `metadata.github-*` keys and does not publish; commit
the result and re-run `publish`.

The publish flow will:

1. Add the `agent-skills` topic to the repo (so search can find it).
2. Use `--tag` (or prompt for one in a TTY).
3. Auto-push any unpushed commits.
4. Create a GitHub release with auto-generated notes.

Always pass `--tag` so it doesn't fall through to the interactive flow.

## Self-management pattern for agents

A reasonable loop:

1. `gh skill search <topic> --json skillName,repo,namespace`
2. `gh skill preview <repo> <skill>` to inspect the `SKILL.md`.
3. `gh skill install <repo> <skill> --agent <host> --pin <ref>` for a
   reproducible install.
4. Periodically `gh skill update --all` to refresh.

© cli · MIT · cli/cli

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
github-cli oakoss Скилл github-cli обучает ИИ-агента шаблонам работы с утилитой gh: создание PR, разбор задач, запуск экшенов и запросы к GraphQL API прямо в терминале. CX Codex +1 128установок create-pull-request davila7 Слэш-команда create-pull-request для Claude Code создаёт pull request через GitHub CLI по шаблону проекта. Запускается, когда ветка готова к ревью и нужно оформить PR в черновик с заполненным описанием. CX Codex +1 411установок suggest-awesome-github-copilot-skills официальный github Скилл suggest-awesome-github-copilot-skills подбирает скиллы из awesome-copilot под кодовую базу и историю чата. Сверяет их с локальными скиллами и находит устаревшие версии. CX Codex +1 8 900установок groove-groovebook-publish andreadellacorte Скилл groove-groovebook-publish для Claude Code публикует рабочий инсайт в groovebook через pull request. Запускается после groove-work-compound, если наработкой стоит поделиться. CX Codex +1 507установок jackin-refresh-pr jackin-project Скилл jackin-refresh-pr сверяет заголовок и описание открытого PR с текущим диффом веточки. Он обновляет блок проверки и переписывает устаревший текст. CX Codex +1 469установок 043-planning-github-issues Juan Antonio Breña Moral Скилл 043-planning-github-issues помогает настроить GitHub CLI и выстроить трассировку задач по документам в репозитории без загрузки текста issue в контекст модели. CX Codex +1 312установок

Из того же набора2

Спонсоры проекта

Компании, которые помогают держать аналитику открытой