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

github-cli — скилл для Claude Code: что делает и как установить

Скилл github-cli обучает ИИ-агента шаблонам работы с утилитой gh: создание PR, разбор задач, запуск экшенов и запросы к GraphQL API прямо в терминале.

MIT 128 установок ★ 29 обновлён 2026-08-17

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

Что делает github-cli

Скилл передаёт агенту готовые сценарии вызова консольного клиента gh. Вместо ручных манипуляций в браузере модель задействует команды для оформления pull request, запуска или перезапуска упавших workflow в GitHub Actions, проверки подписей артефактов и публикации релизов с автогенерацией заметок.

Внутри заложены правила структурированного вывода: парсинг данных через флаги --json и --jq, разграничение секретов по окружениям и выборка через gh api graphql вместо серии тяжеловесных запросов REST API. Шаблоны чистого Git (коммиты и ветвление) сюда не входят: разработчик вынес их в отдельный скилл.

Без предварительной авторизации через gh auth login или токен в переменных GITHUB_TOKEN и GH_TOKEN команды упадут. Недостающие права вызывают тихие сбои, поэтому для работы с проектами и репозиториями агенту понадобятся обновлённые скоупы через gh auth refresh -s.

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

  • оформить pull request с автоматическим заполнением из коммитов
  • перезапустить упавший шаг в GitHub Actions по ID запуска
  • проверить статус проверок CI и настроить автоматическое слияние
  • выгрузить данные из GitHub через GraphQL без браузера

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

  • Создай драфт PR для текущей ветки и заполни описание из коммитов
  • Посмотри упавшие проверки в последнем CI запуске и перезапусти их
  • Опубликуй релиз v1.2.0 со сгенерированным списком изменений

Как установить github-cli

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill github-cli -a claude-code

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

~/.claude/skills/github-cli/SKILL.md

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

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

Вопросы о github-cli

Как установить github-cli в Claude Code?

Выполните в терминале команду npx skills add oakoss/agent-skills --skill github-cli -a claude-code. Файл настроек сохранится по пути ~/.claude/skills/github-cli/SKILL.md.

Что делает скилл github-cli?

Он предоставляет агенту справочник команд и готовых сценариев для утилиты gh: от рецензирования PR и разбора задач до работы с Actions, релизами и GraphQL API.

Что нужно подготовить перед запуском команд через gh?

В системе должна быть настроена авторизация: активная сессия gh auth login либо заданная переменная GITHUB_TOKEN. При нехватке прав для проектов или репозиториев нужно расширить скоупы командой gh auth refresh -s scope.

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

SKILL.md · MIT
---
name: github-cli
description: 'GitHub CLI workflows for repositories, issues, pull requests, actions, releases, projects, and API calls. Use when creating PRs, reviewing code, triaging issues, triggering workflows, publishing releases, managing projects, verifying attestations, or querying the GitHub API. Use for gh cli, github automation, code review, release management.'
license: MIT
metadata:
  author: oakoss
  version: '1.0'
user-invocable: false
---

# GitHub CLI Skill

Provides patterns for the `gh` CLI to interact with GitHub repositories, services, and APIs directly from the terminal. Covers authentication, repository management, issues, pull requests, actions, releases, projects, search, and the REST/GraphQL API. Git workflow patterns (branching, commits, CI/CD) are handled by a separate skill.

## Quick Reference

| Area          | Key Commands                                                          |
| ------------- | --------------------------------------------------------------------- |
| Auth          | `gh auth status`, `gh auth login`, `gh auth token`                    |
| Repos         | `gh repo clone`, `gh repo create`, `gh repo fork`, `gh repo sync`     |
| Browse        | `gh browse`, `gh browse --settings`, `gh browse file.ts:42`           |
| Issues        | `gh issue list`, `gh issue create`, `gh issue edit`, `gh issue close` |
| Pull Requests | `gh pr create`, `gh pr review`, `gh pr merge`, `gh pr checkout`       |
| Actions       | `gh run list`, `gh run view`, `gh workflow run`, `gh cache list`      |
| Releases      | `gh release create`, `gh release list`, `gh release verify`           |
| Projects      | `gh project list`, `gh project create`, `gh project item-add`         |
| Search        | `gh search repos`, `gh search issues`, `gh search code`               |
| API           | `gh api repos/{owner}/{repo}`, `gh api graphql`                       |
| Security      | `gh attestation verify`, `gh ruleset list`, `gh secret set`           |
| Status        | `gh status`, `gh pr checks`, `gh pr status`                           |
| Codespaces    | `gh codespace create`, `gh codespace ssh`, `gh codespace code`        |

## Common Workflows

| Workflow             | Commands                                                                                      |
| -------------------- | --------------------------------------------------------------------------------------------- |
| Quick PR             | `git push -u origin feat` then `gh pr create --fill`                                          |
| Draft PR             | `gh pr create --draft --fill` then `gh pr ready` when done                                    |
| Review and merge     | `gh pr checkout 45` then `gh pr review --approve` then `gh pr merge --squash --delete-branch` |
| Auto-merge PR        | `gh pr merge --auto --squash` (waits for required checks to pass)                             |
| Check CI             | `gh pr checks` then `gh run watch`                                                            |
| Rerun failed CI      | `gh run rerun <run-id> --failed`                                                              |
| Create release       | `gh release create v1.0.0 --generate-notes`                                                   |
| Search code          | `gh search code "handleAuth" --repo owner/repo`                                               |
| Add issue to project | `gh project item-add 1 --owner @me --url <issue-url>`                                         |
| Verify artifact      | `gh attestation verify artifact.tar.gz --owner owner`                                         |
| Trigger workflow     | `gh workflow run deploy.yml -f environment=production`                                        |
| Revert merged PR     | `gh pr revert 45`                                                                             |
| Sync fork            | `gh repo sync` to update fork from upstream                                                   |

## Output Formatting

Most `gh` list and view commands support structured output for scripting and automation.

| Flag         | Purpose                           |
| ------------ | --------------------------------- |
| `--json`     | Output specified fields as JSON   |
| `--jq`       | Filter JSON with jq expressions   |
| `-t`         | Format JSON with Go templates     |
| `--web`      | Open the resource in a browser    |
| `--comments` | Include comments (issues and PRs) |

## Scoping: Repo, Env, Org

Secrets and variables can be scoped to different levels.

| Scope        | Flag Example                                |
| ------------ | ------------------------------------------- |
| Repository   | `gh secret set KEY` (default)               |
| Environment  | `gh secret set KEY --env production`        |
| Organization | `gh secret set KEY --org name --visibility` |

Project commands always require `--owner @me` or `--owner org-name`.

## Authentication Prerequisites

The `gh` CLI requires authentication before most commands work. Run `gh auth status` to verify the current session. Missing scopes cause silent failures -- use `gh auth refresh -s scope` to add scopes without re-authenticating. For CI environments, set the `GITHUB_TOKEN` or `GH_TOKEN` environment variable instead of interactive login.

## Common Mistakes

| Mistake                                                         | Correct Pattern                                                          |
| --------------------------------------------------------------- | ------------------------------------------------------------------------ |
| Running `gh pr create` without pushing the branch first         | Push with `git push -u origin branch` before creating a PR               |
| Using `gh pr merge` without checking CI status                  | Run `gh pr checks` first or use `gh pr merge --auto` to wait for checks  |
| Forgetting `--fill` when creating PRs from well-written commits | Use `gh pr create --fill` to auto-populate title and body from commits   |
| Using REST API when GraphQL is more efficient for nested data   | Use `gh api graphql` for queries needing related objects in one call     |
| Not authenticating with correct scopes                          | Run `gh auth status` to verify scopes, `gh auth refresh -s scope` to add |
| Using `gh project` commands without specifying `--owner`        | Always pass `--owner @me` or `--owner org-name` for project commands     |
| Manually downloading CI artifacts                               | Use `gh run download <run-id>` to download artifacts programmatically    |
| Not using `--json` for scripting                                | Add `--json field1,field2` and `--jq` for machine-readable output        |
| Merging without `--delete-branch`                               | Use `gh pr merge --squash --delete-branch` to clean up after merge       |
| Running `gh api` POST without `-f` fields                       | Use `-f key=value` for string fields, `-F` for typed fields              |

## Delegation

- **Search across repositories for code patterns or issues**: Use `Explore` agent with `gh search code` and `gh search issues`
- **Automate multi-step release workflows**: Use `Task` agent to coordinate branch creation, PR merge, and release publishing
- **Plan repository structure and access controls**: Use `Plan` agent to design team permissions, branch protection, and workflow architecture

## References

- [Repos & Auth](references/repos-auth.md) -- Authentication, repository management, configuration, extensions, aliases
- [Issues](references/issues.md) -- Issue CRUD, labels, assignments, pinning, transferring, development branches
- [Pull Requests](references/pull-requests.md) -- PR creation, review, merge, checkout, checks, diff, auto-merge
- [Actions](references/actions.md) -- Workflow runs, manual triggers, secrets, variables, caches, artifact downloads
- [Releases & Search](references/releases-search.md) -- Releases, attestation verification, search, gists, SSH/GPG keys
- [Projects & API](references/projects-api.md) -- Projects v2 management, REST API, GraphQL API, rulesets, status

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Git и GitHub» →
043-planning-github-issues Juan Antonio Breña Moral Скилл 043-planning-github-issues помогает настроить GitHub CLI и выстроить трассировку задач по документам в репозитории без загрузки текста issue в контекст модели. CX Codex +1 312установок gh prathamdby Скилл gh помогает агенту читать состояние PR, обсуждения и CI, отвечать в тредах и выполнять сложные команды GitHub. CX Codex +1 420установок github Ben Barclay (benbarclay), Hermes Agent Скилл github управляет задачами, пулл-реквестами, ревью и репозиториями через консольную утилиту gh. Помогает вести полный цикл от создания issue до слияния проверенного PR. CX Codex +1 245установок github-repo-health-wasp-drone Legion Code Inc. Субагент github-repo-health-wasp-drone проводит аудит гигиены репозитория на GitHub по восьми направлениям. Поможет выявить слабые места в правилах веток, CI и шаблонах без изменения файлов. CX Codex ★ 96звёзд репо github-workflow-automation sickn33 Скилл github-workflow-automation для Claude Code с шаблонами GitHub: ИИ-ревью пул-реквестов, triage ишью, GitHub Actions и git-операции. Запускается на каждом PR и обработанном ишью. CX Codex +1 1 500установок fix-ci cursor Скилл fix-ci для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — находит упавшие проверки PR, читает логи и применяет минимально нужный фикс. CX Codex +1 2 600установок

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

Весь набор →
knowledge-base-manager Скилл knowledge-base-manager для Claude Code помогает выбрать архитектуру базы знаний и выстроить её поддержку. Охватывает отбор контента, контроль качества и версионирование. CX Codex +1 131установок secure-ai Скилл secure-ai для защиты LLM-слоя приложения: инъекции в промпт, проверка вывода модели, zero-trust для агентов с инструментами. CX Codex +1 130установок python-uv Скилл python-uv обучает ИИ-агента вести Python-проекты через uv: от uv init и управления зависимостями до рабочих пространств и сборки пакетов. Помогает отказаться от связки pip и poetry. CX Codex +1 129установок rust Скилл подсказывает паттерны Rust для ownership, async-кода, веб-сервисов, CLI и тестов. Пригодится при разработке и ревью Rust-проектов. CX Codex +1 128установок resend Помогает агенту настроить отправку писем через Resend API, шаблоны React Email, верификацию доменов и вебхуки Svix. CX Codex +1 127установок tanstack-pacer Даёт агенту карту TanStack Pacer: дебаунс, троттлинг, лимиты, очереди и React-хуки. Ограничивает частоту срабатывания обработчиков и запросов. CX Codex +1 126установок tanstack-devtools Скилл tanstack-devtools учит агента настраивать отладку кэша Query, дерева Router и полей Form в React-приложениях с библиотеками TanStack. CX Codex +1 125установок seo-optimizer Скилл seo-optimizer про SEO-архитектуру: JSON-LD, сигналы E-E-A-T, кластеры тем и аудит контента на 30 пунктов. Ставится в Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 125установок

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

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