github-oauth-nango-integration
Use when implementing GitHub OAuth + GitHub App authentication with Nango - provides two-connection pattern for user login and repo access with webhook handling
npx skills add AgentWorkforce/relay --skill github-oauth-nango-integration --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# GitHub OAuth + Nango Integration ## Overview Implements dual-connection OAuth pattern: one for user identity (`github` integration), another for repository access (`github-app-oauth` integration). This separation enables secure login while maintaining granular repo permissions through GitHub App installations. ## When to Use - Setting up GitHub OAuth login via Nango - Implementing GitHub App installation webhooks - Reconciling OAuth users with GitHub App installations - Building apps that need both user auth and repo access - Handling Nango sync webhooks for GitHub data ## Why Two Connections? GitHub has **two different authentication mechanisms** that serve different purposes: ### GitHub OAuth App (`github` integration) - **What it is**: Traditional OAuth for user identity - **What it gives you**: User profile (name, email, avatar, GitHub ID) - **What it DOESN'T give you**: Access to repositories - **Use for**: Login, "Sign in with GitHub" ### GitHub App (`github-app-oauth` integration) - **What it is**: Installable app with granular repo permissions - **What it gives you**: Access to specific repos the user installed it on - **What it DOESN'T give you**: User identity (it knows
- Overview
- When to Use
- Why Two Connections?
- GitHub OAuth App (github integration)
- GitHub App (github-app-oauth integration)
- The Reconciliation Problem
- Quick Reference
- Implementation
- 1. Database Schema
- 2. Constants
- 3. Login Flow Routes
- 4. App OAuth Flow Routes
- 5. Auth Webhook Handler
- 6. Webhook Route with Signature Verification
Required Configure in Nango Dashboard
What does the github-oauth-nango-integration skill do?
Use when implementing GitHub OAuth + GitHub App authentication with Nango - provides two-connection pattern for user login and repo access with webhook handling
How do I install it?
Run `npx skills add AgentWorkforce/relay --skill github-oauth-nango-integration --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From AgentWorkforce/relay, a repository with 793 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.