AIKraft/AI/Войти
AIKraft/Skills/gh

gh

Шаблон для вызова GitHub CLI (gh) из агентов: структурированный вывод, пагинация, поиск и fallback через gh api. Полезно при автоматизации работы с репозиториями.

GIGitHub official Разработка ★ 46.5k

Что делает навык

Навык обеспечивает структурированное взаимодействие с GitHub CLI (gh) для автоматизации работы с репозиториями, включая пагинацию, поиск и парсинг JSON. Он позволяет агентам получать детализированные данные об issue, PR и обсуждениях, а также читать файлы без клонирования репозитория.

Когда применять

  • Получение структурированных данных об issue или PR с использованием флагов --json и --jq для фильтрации полей.
  • Поиск задач или кода по кросс-репозиторным критериям с использованием gh search и специфичных квалификаторов.
  • Чтение содержимого файлов или списков директорий в репозитории без необходимости его клонирования.
  • Управление иерархией issue, включая создание подзадач и установление связей blocked-by/blocking.
  • Загрузка изображений и видео в issue или PR с использованием флага --attach.

Как работает

  1. Использовать флаг --json для получения структурированного вывода и --jq для фильтрации полей, избегая парсинга текстового вывода.
  2. Применять флаг -L (или --limit) для ограничения количества результатов в списках, так как по умолчанию лимит составляет 30 записей.
  3. Для получения точного общего количества записей использовать gh api graphql, так как стандартные команды list не возвращают totalCount.
  4. Указывать репозиторий через флаг -R, если текущая рабочая директория не связана с нужным git-репозиторием.
  5. Использовать gh search для кросс-репозиторного поиска с отдельными токенами для каждого квалификатора.
  6. Применять gh repo read-file или read-dir для чтения содержимого репозитория по API без клонирования.

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

Найди все открытые pull-реквесты в репозиторе cli/cli, созданные пользователем monalisa, и верни их номера и заголовки в формате JSON.
Прочитай содержимое файла README.md из ветки main репозитора owner/repo и выведи его на экран.
Создай новую задачу в текущем репозитории с заголовком 'Fix bug' и телом 'Critical issue', добавив к ней изображение из файла ./screenshot.png.

Что понадобится

  • Установленный GitHub CLI (gh) и настроенная аутентификация (gh auth status).
  • Доступ к интернету для взаимодействия с GitHub API.
  • Окружение, где gh корректно определяет git-репозиторий из текущей директории или явно указан через -R.

Описание составлено по SKILL.md навыка, сверено 08.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «gh» из репозитория: # https://github.com/cli/cli
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r gh/ ~/.claude/skills/gh/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.