> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Навык: GitHub

> Описание работы навыка для взаимодействия с GitHub через CLI: задачи, возможности и технические ограничения.

# Навык: GitHub

`github` — это специализированный навык для работы с платформой GitHub через интерфейс командной строки `gh` CLI.

Он незаменим в случаях, когда задача требует взаимодействия не с локальными файлами, а с удаленным состоянием репозитория: управлением задачами (issues), запросами на слияние (pull requests), мониторингом автоматизаций (рабочий процесс runs) и запросами к GitHub API.

***

## Сценарии использования

Навык наиболее эффективен в следующих ситуациях:

* просмотр и анализ открытых задач (issues);
* проверка текущего статуса и комментариев в Pull Requests (PR);
* мониторинг состояния сборок и проверок CI (CI checks);
* получение специфических данных через GitHub API;
* сбор структурированной информации о состоянии репозитория.

***

## Рекомендации по запросам

Для достижения наиболее точного результата рекомендуется указывать в запросе:

* название репозитория (`владелец/репозиторий`);
* номер конкретного PR или задачи (issue);
* четкое описание того, какую информацию требуется получить.

**Примеры эффективных запросов:**

* «Покажи текущий статус PR #55 в репозитории owner/repo».
* «Какие задачи (issues) сейчас открыты в проекте owner/repo?».
* «Проверь результаты последних запусков автоматизаций (рабочий процесс runs) в owner/repo».

***

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

Навык `github` помогает Велесу:

* использовать команды `gh` CLI более последовательно и безошибочно;
* автоматически учитывать флаг `--repo`, если работа ведется вне локальной git-директории;
* выбирать наиболее подходящие подкоманды для работы с PR, запусками или API.

***

## Технические требования

* Для полноценной работы навыка в системе должен быть установлен GitHub CLI (`gh`).
* Требуется корректная авторизация через `gh auth login`.
* Указание явного пути к репозиторию значительно повышает надежность выполнения команд.

***

## Сравнение с локальным Git

Этот навык дает преимущество перед обычными git-командами, когда вам необходимы:

* **Удаленное состояние**: информация, которой нет в локальной копии кода.
* **Интеграция CI/CD**: данные о проверках и деплоях.
* **Метаданные**: описания задач, комментарии к PR и специфические поля GitHub.

Если ваша задача ограничивается только локальными изменениями кода, использование этого навыка может быть избыточным.

***

## Связанные страницы

* [Навыки Велеса: технический справочник](/skills/reference_ru)
* [Инструменты Велеса: технический справочник](/dive-deeper/tools_reference_ru)