What problem does it solve?
Creating a dedicated GitHub App identity for an assistant is error-prone and involves multiple manual steps, including manifest form setup, OAuth-style credential exchange, installation selection, and token refresh for pushing commits and opening PRs.
Core Features & Use Cases
- Guided GitHub App creation (manifest flow): Opens a browser flow, submits a pre-filled manifest, and captures the credentials JSON automatically.
- Repository installation with controlled permissions: Helps you install the App on selected repositories with sensible default scopes for git operations and PR interactions.
- Vault storage and token helper automation: Stores the App credentials securely and provides a
bun-based token refresher (gh-app-token.mjs) for short-lived installation tokens (1 hour).
- Git configuration for bot-attributed commits: Sets
user.name and user.email so pushes and PR activity attribute to <app-slug>[bot] consistently.
- Optional logo upload instructions: Explains the limitation that the manifest flow can’t upload logos, so you complete it via the GitHub UI.
Quick Start
Tell the assistant: "Run the GitHub App setup skill for ORG_NAME with app name APP_NAME, then install it on my target repositories and prepare the workspace so pushes and PR comments use the app bot identity."