github-cli-health-check

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.