Скиллы GitHub CLI
GitHub CLI skills (gh, gh-skill)
Официальные скиллы GitHub CLI: как агенту правильно вызывать gh и как управлять скиллами командой gh skill
Установка
gh skill install cli/cli gh --scope userОбновление после релиза gh: gh skill update gh.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл gh описывает, как агенту работать с GitHub CLI без типичных ошибок: брать структурированный вывод через --json и --jq, помнить про лимиты списков и пагинацию, указывать репозиторий явно и переходить на gh api, когда обычной команды не хватает. Он объясняет поведение gh вне терминала, чтобы агент не добавлял лишние флаги. Второй скилл gh-skill учит агента искать, просматривать, ставить, обновлять и публиковать скиллы встроенной командой gh skill. Сам GitHub CLI дает агенту доступ к issues, pull requests, релизам и Actions.
Для кого. Для разработчиков, чьи агенты работают с GitHub через командную строку.
Подходит, если
- Агент разбирает issues и pull requests через gh и путается в выводе
- Нужно, чтобы агент получал полные списки, а не молча обрезанные
- Нужно ставить и обновлять скиллы из GitHub-репозиториев командой gh skill
Не подходит, если
- Код хранится не на GitHub, а в GitLab или Gitflic
- Агент уже подключен к GitHub через MCP-сервер и gh не используется
Пример запроса к агенту
Найди через gh все открытые pull requests с меткой bug, где нет ревью, и выведи таблицейОграничения
Нужен установленный GitHub CLI с авторизацией gh auth login; команда gh skill есть только в свежих версиях. Скилл описывает приемы работы, права доступа определяются токеном пользователя.
Как отключить. Удалите папку скилла gh из каталога скиллов пользователя.
Проверка безопасности
- Агент выполняет команды gh от имени пользователя и может менять issues, pull requests и релизы
Коротко о README
GitHub CLI это официальная утилита GitHub для работы с репозиториями, issues, pull requests и Actions из терминала. В README есть раздел об агентских скиллах: скилл для управления gh ставится и обновляется встроенной командой gh skill. Остальные скиллы в папке .github/skills служат разработчикам самого CLI. Лицензия MIT.
SKILL.md
--- name: gh description: Patterns for invoking the GitHub CLI (gh) from agents. Covers structured output, pagination, repo targeting, search vs list, gh api fallback. --- # Reference ## Interactivity policy `gh` already does the right thing in non-TTY contexts: it skips the pager, strips ANSI color, and errors out fast with a helpful message instead of prompting (e.g. `must provide --title and --body when not running interactively`). You don't need to defensively set `GH_PAGER` or pass `--no-pager` (no such flag exists). ## Parsing JSON Human output from `gh` is column-formatted. If you want structured data: - Add `--json field1,field2,...` for structured output. - Run a command with `--json` and **no field list** to print the full set of available fields, then pick what you need. - Use `--jq '<expr>'` for filtering without piping through a separate `jq`. - Use `--template '<go-template>'` (alongside `--json`) when you want shaped text output. Note that `--template`/`-T` collides with a body-template flag on a few commands (e.g. `gh pr create -T`, `gh issue create -T`); always check `--help` before assuming which one you're hitting. ## Pagination and silent truncation List commands cap results. - `gh issue list`, `gh pr list`, `gh search ...`: pass `-L N` (`--limit N`). The default is usually 30.
Частые вопросы
Где взять команду gh skill?
Она встроена в GitHub CLI, достаточно обновить gh до актуальной версии.
Зачем обновлять скилл?
Скилл привязан к возможностям gh, поэтому авторы советуют обновлять его после каждого релиза CLI.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything