github-authenticator

Authenticate GitHub CLI credentials and troubleshoot authentication failures via gh commands.

15|1|Updated Sep 13, 2025
One-click install
npx skills add https://github.com/EdanStarfire/claudecode_webui --skill github-authenticator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-authenticator
Source: https://github.com/EdanStarfire/claudecode_webui/tree/main/.claude/skills/github-authenticator
Command: npx skills add https://github.com/EdanStarfire/claudecode_webui --skill github-authenticator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh.

What problem does it solve?

This Skill quickly diagnoses and resolves GitHub CLI authentication issues, ensuring seamless interaction with GitHub repositories and services, so you can get back to your development workflow without interruption.

Core Features & Use Cases

  • Status Check: Instantly verify if you're logged in to GitHub CLI, your username, and the scopes of your authentication token.
  • Login/Refresh: Guide through the gh auth login process for first-time setup or refresh expired tokens to restore access.
  • Account Switching: Easily log out of one GitHub account and into another, useful for managing personal and work repositories.
  • Use Case: If a gh command fails with a "Bad credentials" error, use this Skill to check your authentication status, then guide you through refreshing your token or logging in again, getting you back to work quickly.

Quick Start

Check your current GitHub CLI authentication status and, if not logged in, guide through the login process to set up your credentials.

Frequently Asked Questions about github-authenticator

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

FAQPage Schema
How do I fix GitHub CLI authentication errors?

GitHub CLI authentication errors typically stem from expired tokens, incorrect credentials, or missing scopes. Run `gh auth status` to check your current login and token scopes, then use `gh auth refresh` to renew your token or `gh auth login` to re-authenticate with valid credentials.

How do I check if I'm logged into GitHub CLI?

Verify your GitHub CLI authentication status by running `gh auth status`. This command displays your logged-in username, host, and the scopes granted to your authentication token, confirming whether you're authenticated and what permissions you have.

How do I switch between GitHub accounts in the CLI?

Switch GitHub accounts by logging out of your current account with `gh auth logout`, then log in to another account using `gh auth login`. This process guides you through interactive authentication for the new account, useful for managing personal and work repositories separately.

When should I refresh my GitHub CLI authentication token?

Refresh your GitHub CLI token when `gh` commands fail with authentication errors, when your token expires, or after a long period of inactivity. Use `gh auth refresh` to renew your current credentials without fully re-logging in, restoring access to GitHub services.

What scopes do I need for GitHub CLI authentication?

Required scopes for GitHub CLI depend on your use case but typically include repository access and workflow permissions. Run `gh auth status` to view your current token's scopes, then `gh auth login` to request additional scopes if needed for your GitHub operations.

Why does my gh command fail with 'Bad credentials'?

A 'Bad credentials' error in GitHub CLI indicates an invalid, expired, or insufficiently scoped authentication token. Use `gh auth status` to diagnose the issue, then either refresh your token with `gh auth refresh` or log in again with `gh auth login` to restore valid credentials.