メニュー
Diagnose ghtkn problems and known limitations. Use when ghtkn or the gh wrapper misbehaves, a token is expired (401), the device flow code isn't shown, or hitting Packages API / cross-user repo limits.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Choose and configure where ghtkn stores access tokens (keyring, text, agent). Use when the OS keyring is unavailable (containers, microVMs), or when setting up the ghtkn agent backend.
Configure ghtkn via config file, environment variables, and CLI args. Use for configuration priority, disabling browser open, the GitHub account picker, enterprise GitHub App sharing, or GHTKN_GITHUB_TOKEN.
Understand how ghtkn works internally and how its tokens compare to alternatives. Use to explain the token workflow, compare with GitHub CLI OAuth / fine-grained PAT / installation tokens, or discuss API rate limits.
Configure ghtkn as a Git credential helper and switch GitHub Apps by repository owner. Use when setting up git authentication via ghtkn, handling fork repos, or troubleshooting the credential helper on macOS.
Install the ghtkn CLI and verify downloaded release assets. Use when installing ghtkn via Homebrew, Scoop, aqua, go install, or GitHub Releases, or verifying assets with gh / slsa-verifier / Cosign.
Configure and switch between multiple GitHub Apps in ghtkn. Use when setting up per-organization apps, selecting an app by argument or GHTKN_APP, or switching apps per directory with direnv.
| name | ghtkn-troubleshooting |
| description | Diagnose ghtkn problems and known limitations. Use when ghtkn or the gh wrapper misbehaves, a token is expired (401), the device flow code isn't shown, or hitting Packages API / cross-user repo limits. |
Common checks when ghtkn doesn't work:
ghtkn info [<app name>] to check env vars and version; upgrade if not latest.ghtkn get -f json [<app name>] to inspect the token and expiration.env GH_TOKEN=$(ghtkn get) gh auth status and confirm the token prefix is ghu_.ghtkn auth.command -v gh, that no other token is set, and add debug logging.Known limitations: the Packages API requires a classic PAT, and writing other users' repositories needs a GitHub App installed there.
If this overview is enough, you don't need to read further.
For details, read reference.md in this skill directory.