# Github Sync Error Handling

> Sub-skill of github-sync: Error Handling.

- Skill: `vamseeachanta/github-sync-error-handling` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/github-sync-error-handling`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/github-sync-error-handling/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/github-sync-error-handling

---


# Error Handling

## Error Handling


### Recovery Procedures


```bash
# Check sync status
gh api repos/:owner/:repo/git/refs/heads/sync/package-alignment || echo "Branch not found"

# Rollback failed sync
git fetch origin
git checkout main
git branch -D sync/package-alignment
git push origin --delete sync/package-alignment

# Retry with fresh branch
gh api repos/:owner/:repo/git/refs \
  -f ref='refs/heads/sync/package-alignment-v2' \
  -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')
```

### Common Issues


| Issue | Cause | Solution |
|-------|-------|----------|
| Version conflict | Incompatible dependencies | Use highest_common strategy |
| Merge conflict | Divergent changes | Manual resolution with sync coordinator |
| Test failures | Breaking changes | Run integration tests before merge |