connect-github

Connect GitHub organizations to SubImage for repository and dependency discovery.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/subimagesec/skills --skill connect-github
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: connect-github
Source: https://github.com/subimagesec/skills/tree/main/plugins/subimage-setup/skills/connect-github
Command: npx skills add https://github.com/subimagesec/skills --skill connect-github

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you connect one or more GitHub organizations to SubImage so the platform can inventory repositories, collaborators, branch protection, teams, memberships, workflows, and dependency metadata without manual setup errors.

Core Features & Use Cases

  • GitHub App onboarding: Preferred path for GitHub.com and GitHub Enterprise Cloud, with installation guidance and permission requirements.
  • PAT fallback for Enterprise Server: Supports self-hosted GitHub Enterprise Server when the App cannot be used, including the correct GraphQL endpoint and token scope guidance.
  • Operational verification and troubleshooting: Covers repository selection, sync validation, Terraform-managed repo allowlists, and common configuration pitfalls.

Quick Start

Ask the assistant to connect your GitHub organization to SubImage using the GitHub App when available, or a personal access token if you are on GitHub Enterprise Server.

Frequently Asked Questions about connect-github

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

FAQPage Schema
How do I connect a GitHub organization using a personal access token?

To connect a GitHub organization using a personal access token, configure the PAT fallback with the correct token scopes and provide the GitHub GraphQL endpoint, specifically required for GitHub Enterprise Server onboarding when the App cannot be used.

Does GitHub Enterprise Server onboarding require a different authentication path than GitHub.com?

GitHub Enterprise Server onboarding uses a personal access token fallback with the correct GraphQL endpoint, whereas GitHub.com and GitHub Enterprise Cloud prefer GitHub App installation for connecting organizations safely.

What GitHub metadata is discovered when I connect my organization to SubImage?

Connecting your organization discovers repository, branch protection, collaborator, team, membership, workflow, and dependency metadata without manual setup errors.

Why does my GitHub App installation fail to sync repositories correctly?

GitHub App installation sync failures often stem from incorrect permission requirements, invalid organization slugs, or Terraform-managed repo allowlist misconfigurations that require operational verification and troubleshooting.

Can I use Terraform to manage repository allowlists during GitHub onboarding?

You can manage repository allowlists with Terraform during GitHub onboarding, but you must validate sync configurations and address common pitfalls to ensure the App or PAT correctly inventories the selected repositories.