github-cli-health-check

Verify GitHub CLI installation, authentication, repository access, and API rate limits.

8|1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/MSApps-Mobile/claude-plugins --skill github-cli-health-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-cli-health-check
Source: https://github.com/MSApps-Mobile/claude-plugins/tree/main/plugins/github-cli-health-check/skills/github-cli-health-check
Command: npx skills add https://github.com/MSApps-Mobile/claude-plugins --skill github-cli-health-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill verifies that the GitHub CLI is installed and operational, confirms authentication and token scopes, checks repository access, and reports API rate limit status so users or automation can detect and remediate GitHub access problems quickly.

Core Features & Use Cases

  • Installation check: Detects the gh binary and reports version and path on macOS.
  • Authentication and scopes: Runs an auth status check to identify the authenticated account and token scopes and detects expired or missing credentials.
  • Repo access and rate limits: Lists recent repositories as a quick access test and parses the API rate_limit response to flag low remaining calls.
  • Resilience and remediation: Orchestrates retries, an auto-fix loop (including alternate gh path discovery and brew installation), and a Chrome-based fallback for environments without Desktop Commander.
  • Use case: Schedule automated health checks before deployments or run ad-hoc diagnostics when a developer reports GitHub failures.

Quick Start

Run a GitHub CLI health check and save the resulting markdown report to the workspace.

Frequently Asked Questions about github-cli-health-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my GitHub CLI authentication status and token scopes on macOS?

To check GitHub CLI authentication status, run an auth status check that identifies the authenticated account, verifies token scopes, and detects expired or missing credentials on macOS.

What is a GitHub CLI health check and what does it verify?

A GitHub CLI health check verifies the gh binary installation, confirms authentication and token scopes, tests repository access, and reports API rate limit status to detect access problems quickly.

How do I monitor GitHub API rate limits to prevent deployment failures?

You can monitor GitHub API rate limits by parsing the API rate_limit response, which flags low remaining calls to help prevent deployment failures caused by exhausted API quotas.

Does this GitHub CLI health check work if Desktop Commander is unavailable?

If Desktop Commander is unavailable, the health check uses a Chrome-based fallback to execute diagnostics, alongside retry logic and alternate gh path discovery for environment resilience.

Why does my GitHub CLI stop working during automated checks?

GitHub CLI checks may fail due to expired credentials, missing gh binary, or exhausted API rate limits, triggering retry and auto-fix logic that attempts alternate path discovery or brew installation.

Can I schedule automated GitHub CLI diagnostics before deployments?

You can schedule automated GitHub CLI health checks before deployments to verify installation, authentication, repository access, and API rate limits, generating a markdown report for remediation.