Gh Cli

gh-cli

GitHub CLI (gh) をエージェントが使うためのスキル。gh 2.90.0 系の help と 公式マニュアル を元にしている。

help 全文の複製はしない。個々のフラグの完全な一覧が必要なら gh --help を実行するのが常に最新で正確。 このスキルは「エージェントが踏みやすい罠」と「頻出レシピ」に絞る。

大原則

1. 対話プロンプトを発生させない

gh は引数が足りないと対話プロンプトや $EDITOR を開き、エージェントはそこでハングする。

• 必須情報（title / body / tag 等）は必ずフラグで渡す。gh pr create を裸で実行しない
• -e/--editor フラグは使わない（エディタが開く）
• -w/--web フラグは使わない（ブラウザが開く）
• 破壊的操作の確認プロンプトは --yes 等の明示フラグで抑止する
• 保険として GH_PROMPT_DISABLED=1 を設定すると、対話プロンプトが必要な場面で

ハングせずエラー終了になる

複数行の body はインライン文字列より --body-file が安全（クォート事故を防ぐ）:

gh pr create --title "feat: add X" --body-file - ` を使う。

- 利用可能なフィールド名は `--json` を値なしで実行するとエラーメッセージに一覧が出る
- 絞り込みは `--jq` を併用（jq 本体のインストール不要で gh に内蔵）

```bash
gh pr list --json number,title,author --jq '.[] | "\(.number)\t\(.title)"'

3. リポジトリ指定

カレントディレクトリが対象リポジトリの checkout でない場合は -R owner/repo フラグか環境変数 GH_REPO=owner/repo を指定する。 checkout 内なら省略してよい。

4. 認証と exit code

• 認証状態の確認: gh auth status。CI 等では GH_TOKEN 環境変数が最優先で使われる
• exit code: 0 成功 / 1 失敗 / 2 キャンセル / 4 認証が必要
• gh run watch --exit-status や gh pr checks のように、対象の失敗を

exit code に反映させるフラグを持つコマンドがある（各リファレンス参照）

タスク別リファレンス

該当する作業を始める前に対応するファイルを読むこと。

| やりたいこと | リファレンス | | ---------------------------------------------------------- | ---------------------------------------------------------------- | | PR の作成・確認・レビュー・マージ・CI チェック | [references/pr.md](references/pr.md) | | issue の作成・検索・更新・ブランチ連携 | [references/issue.md](references/issue.md) | | リリースの作成・アセット管理・ダウンロード | [references/release.md](references/release.md) | | GitHub Actions の実行確認・失敗調査・再実行・workflow 起動 | [references/actions.md](references/actions.md) | | REST/GraphQL API 呼び出し、--json/--jq/--template の詳細 | [references/api-and-json.md](references/api-and-json.md) | | リポジトリの作成・clone・fork・設定変更 | [references/repo.md](references/repo.md) | | リポジトリ・issue・PR・コード・コミットの横断検索 | [references/search.md](references/search.md) | | agent skill の検索・インストール・更新・公開 (gh skill) | [references/skill-management.md](references/skill-management.md) |

頻出ワンライナー

# 現在のブランチの PR を確認
gh pr view --json number,title,state,url

# CI が全部通るまで待ち、失敗したら非ゼロで終了
gh pr checks --watch --fail-fast

# 直近の workflow run の失敗ログだけ見る
gh run list --limit 1 --json databaseId --jq '.[0].databaseId' | xargs -I{} gh run view {} --log-failed

# リリースを notes 自動生成で作成
gh release create v1.2.3 --generate-notes

# REST API を呼んで必要なフィールドだけ抽出
gh api repos/{owner}/{repo}/releases --jq '.[].tag_name'

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: oubakiou
• Source: oubakiou/skills
• License: MIT

Install and usage instructions live in the source repository linked above.