What problem does it solve? Replit's Git UI can fail with errors like PUSH_REJECTED or a stuck commit button, leaving your workspace out of sync with GitHub. This Skill establishes the actual Git state, preserves local work, and follows an explicit, safe integration path instead of blindly retrying rejected pushes or force-pushing. ## Core Features & Use Cases - Sync Diagnosis: Records repository root, branch, remotes, and ahead/behind counts against the verified default branch before making any changes. - Safe Recovery Paths: Applies a decision table for behind-only, local-only, diverged, and conflicted states, using fast-forward pulls, reviewed commits, and normal pushes while refusing force-push or history rewriting. - PR and Squash Merge Handoff: Pushes feature branches, creates or updates pull requests, and performs explicitly authorized squash merges with verification of head SHA, approvals, and required checks. - Use Case: Replit reports "the remote has commits that are not in the local repository." The Skill fetches origin, shows the divergence, fast-forwards or routes work through a feature branch PR, then verifies the remote contains the expected commit. ## Quick Start Use the okhp3-replit-github-sync skill to diagnose this Replit checkout, safely reconcile it with GitHub, and verify the branch is synchronized.
