github-auth

npx skills add HezaoHezao/poirot --skill github-auth --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# GitHub Authentication Setup Sets up authentication so the agent can work with GitHub repositories, PRs, issues, and CI. ## Detection Flow When a user asks to work with GitHub, run this check first: ```bash git --version gh --version 2>/dev/null || echo "gh not installed" gh auth status 2>/dev/null || echo "gh not authenticated" git config --global credential.helper 2>/dev/null || echo "no git credential helper" ``` **Decision tree:** 1. If `gh auth status` shows authenticated → use `gh` for everything 2. If `gh` installed but not authenticated → use "gh auth" method 3. If `gh` not installed → use "git-only" method ## Method 1: Git-Only (No gh) ### HTTPS with Personal Access Token (Recommended) **Step 1: Create a token** at https://github.com/settings/tokens (classic) or https://github.com/settings/personal-access-tokens (fine-grained). Scope: `repo`, `workflow`, `read:org`. **Step 2: Configure git credential helper:** ```bash # Store credentials (plaintext, dev machine only) git config --global credential.helper store # Or use a credential cache (timed, more secure) git config --global credential.helper 'cache --timeout=3600' ``` **Step 3: First push triggers prompt:** ```bash #

git --version
gh --version 2>/dev/null || echo "gh not installed"
gh auth status 2>/dev/null || echo "gh not authenticated"
git config --global credential.helper 2>/dev/null || echo "no git credential helper"
Store credentials (plaintext, dev machine only)
git config --global credential.helper store
Or use a credential cache (timed, more secure)
git config --global credential.helper 'cache --timeout=3600'
git push origin main
export GITHUB_TOKEN="ghp_xxxxxxxxxxxx"