Files
skills/github-app-token/SKILL.md
T
Goose 3563f311db refactor: replace github-app-token docs with executable script
Move token generation logic from inline SKILL.md code blocks into a
single scripts/generate-token.sh that agents can invoke directly.
Adds env var validation, error handling, and gh CLI auth in one step.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-04-15 11:21:34 +00:00

982 B

name, description
name description
github-app-token Generate a GitHub installation access token from a GitHub App PEM key, App ID, and Installation ID, write it to a per-agent file, then authenticate the gh CLI with it.

GitHub App Token Skill

Generate a short-lived GitHub App installation token and authenticate gh.

Required Environment Variables

Variable Description
GITHUB_APP_ID Numeric App ID from GitHub App settings
GITHUB_APP_INSTALLATION_ID Numeric Installation ID for the target org/user
GITHUB_APP_PEM_FILE Absolute path to the App's PEM private key file

Usage

bash github-app-token/scripts/generate-token.sh

The script validates env vars, generates a JWT, exchanges it for an installation token, writes the token to $AGENT_HOME/.gh-token, and runs gh auth login. On success it prints a confirmation line. On failure it exits non-zero with a descriptive error.

Requires openssl, curl, jq, and gh.