Skills Guide

Installation et configuration du GitHub CLI (gh)

VérifiéPrudence

Installe et configure GitHub CLI (gh) avec vérification SHA256 et authentification par GITHUB_TOKEN pour agents IA. Gère les environnements proxy avec -R et l'accès à l'API GitHub.

Spar Skills Guide Bot
DevOpsIntermédiaire
27003/09/2026
Claude Code
#github-cli#agent-environment#proxy-support#issue-management#project-automation

Recommandé pour

Claude CodeDéveloppeur backendIngénieur DevOpsAutomatisation Git

Notre avis

Ce skill installe et configure GitHub CLI (gh) pour des agents qui travaillent avec des remotes Git derrière un proxy local, puis documente l’usage obligatoire de -R et fournit des scripts pour gérer issues, labels, jalons et projets GitHub.

Points forts

  • Script d’installation multiplateforme avec vérification SHA256 et détection de l’architecture.
  • Gère les environnements proxy en imposant -R owner/repo sur chaque commande gh.
  • Authentification via GITHUB_TOKEN avec repli anonyme en cas d’échec 401/403.
  • Scripts Python prêts à l’emploi pour labels, milestones, issues et Projects V2.

Limites

  • Suppose que uv est disponible et que les scripts se trouvent dans .claude/skills/gh/scripts.
  • Ne concerne que GitHub, pas les autres forges Git.
  • Les opérations authentifiées dépendent de la présence de GITHUB_TOKEN ; le mode anonyme a des limites d’API.
Quand l'utiliser

À utiliser lorsque gh n’est pas installé, que les remotes pointent vers un proxy local ou qu’il faut automatiser des opérations GitHub comme les issues, PR, labels, jalons ou projets.

Quand l'éviter

À éviter si gh est déjà installé et authentifié avec des remotes github.com directs, ou si vous travaillez avec une forge autre que GitHub.

Analyse de sécurité

Prudence
Score qualité90/100

The skill instructs installation of the official GitHub CLI via a script that downloads, verifies, and installs a binary, and it uses the GITHUB_TOKEN for API operations. These are powerful but legitimate actions with no evidence of exfiltration, destruction, or obfuscation. The reliance on a separate script not shown in the skill file warrants caution but not rejection.

Points d'attention
  • •Downloads and installs a binary from the internet (GitHub CLI official release) with SHA256 verification.
  • •Uses GITHUB_TOKEN for authenticated GitHub API operations.
  • •The actual setup script content is not included in this file, so the described safety checks cannot be fully audited.

Exemples

Install gh in a proxy environment
gh is missing in this environment and `git remote -v` shows only 127.0.0.1. Install GitHub CLI with the setup script, then run `gh auth status` using GITHUB_TOKEN.
Create milestone and list issues
Using the gh skill, create a `v1.0` milestone due 2026-03-31 and list all P1 issues in owner/repo.
Initialize labels and projects
Initialize the label taxonomy and GitHub Projects V2 board for owner/repo with the github_project_setup.py script.

name: gh description: "Install and configure the GitHub CLI (gh) for AI agent environments where gh may not be pre-installed and git remotes use local proxies instead of github.com. Use when gh command not found, shutil.which returns None, need GitHub API access for issues or PRs or releases or workflow runs, or repository operations fail with 'failed to determine base repo' error. Provides auto-install script with SHA256 verification, GITHUB_TOKEN auth with anonymous fallback, and the required -R flag pattern for proxy environments. Covers project management via GitHub Projects V2, milestones via REST API, issue lifecycle templates, and label taxonomy management."

GitHub CLI (gh) — Setup and Usage

Purpose

Ensures the GitHub CLI (gh) is available and provides correct usage patterns for AI agents operating in environments where gh may not be pre-installed and where git remotes point to local proxies instead of github.com.

When to Use

  • gh command not found or shutil.which("gh") returns None
  • Need to interact with GitHub API (issues, PRs, releases, workflows)
  • Repository remote does not point to github.com (proxy environments)
  • Need authenticated GitHub operations with GITHUB_TOKEN
  • Managing GitHub Issues, Projects V2, Milestones, or Labels

Installation

If gh is not installed, run the setup script:

uv run .claude/skills/gh/scripts/setup_gh.py

The script:

  1. Checks if gh is already installed via shutil.which
  2. Detects platform (Linux, macOS, Windows) and architecture
  3. Fetches the latest release from https://github.com/cli/cli/releases/latest
  4. Downloads the correct archive with SHA256 verification from checksums file
  5. Extracts and installs the binary to a writable PATH directory
  6. Uses GITHUB_TOKEN for authenticated requests; falls back to anonymous if auth fails (401/403)

CLI options:

--force          Reinstall even if already at latest version
--dry-run        Show what would happen without installing
--bin-dir        Override install directory (default: auto-detect from PATH)
--detect-only    Detect owner/repo, refresh .dh/config.yaml and gh-examples.md, print examples to stdout. No network calls.

Authentication

GITHUB_TOKEN environment variable provides automatic authentication. No manual gh auth login needed.

# Verify authentication
gh auth status

If GITHUB_TOKEN is set, gh authenticates automatically for all API calls.

Repository Detection

<repo_detection>

Git remote points to a local proxy (127.0.0.1), NOT github.com. Every gh command fails without explicit repo specification:

failed to determine base repo: none of the git remotes configured for this
repository point to a known GitHub host.

RULE: Pass -R (or --repo) on EVERY gh command:

gh <command> -R <owner/repo>

This applies to ALL gh subcommands: pr, issue, run, api, release, project, etc.

</repo_detection>

Common Commands

!uv run --script .claude/skills/gh/scripts/setup_gh.py --detect-only 2>/dev/null

Automation — Python Script

For multi-step operations (label setup, milestone creation, project init, issue import), use:

# Full project setup
uv run .claude/skills/gh/scripts/github_project_setup.py setup

# Labels only
uv run .claude/skills/gh/scripts/github_project_setup.py labels

# Milestone management
uv run .claude/skills/gh/scripts/github_project_setup.py milestone list
uv run .claude/skills/gh/scripts/github_project_setup.py milestone create --title "v1.0" --due 2026-03-31

# Issue management
uv run .claude/skills/gh/scripts/github_project_setup.py issue list --priority p1
uv run .claude/skills/gh/scripts/github_project_setup.py issue create --title "feat: X" --priority-label priority:p1

The script delegates all GitHub operations to the authenticated gh CLI — no separate API tokens or Python HTTP clients needed.

Reference Files

  • labels.md — Label taxonomy (priority, type, status), color codes, bulk setup
  • milestones.md — Milestone CRUD via REST API, naming conventions
  • projects-v2.md — GitHub Projects V2 commands, custom fields, GraphQL queries
  • issue-stories.md — Issue as story format, body template, lifecycle, backlog item field mapping

Sources

Skills similaires

Architecte Docker Compose

DevOps

Concoit des configurations Docker Compose optimisees.

Claude CodeCopilotadvanced
430
156
1,914
Admin

Rapport de Post-Mortem

DevOps

Rédige des rapports post-mortem d'incidents structurés et blameless.

Claude CodeCursorWindsurf+2beginnerSûr
141
43
797
Admin

Créateur de Runbooks

DevOps

Crée des runbooks opérationnels clairs pour les procédures DevOps courantes.

claudeCursorWindsurfintermediate
108
32
705
Admin