🔄 GitHub Sync Pro

Professional Git + GitHub synchronization skill for AI coding agents (Claude Code / Codex / OpenClaw).

One command to rule them all. Auto-detect your setup, scan for secrets, stage changes interactively, push safely — all with zero config.

---

✨ What It Does

Capability	Description
🔍 Self-diagnostics	Checks git, gh CLI, proxy, auth, repo state — before anything touches your remote
🛡️ Secret scanning	Detects 12 credential patterns (GitHub tokens, API keys, AWS keys, private keys, passwords) — blocks commit if found
📋 Interactive staging	Review changes file-by-file, flag sensitive configs, choose what to commit
🌐 Proxy intelligence	Auto-detects proxy from env vars, tests connectivity — works even behind the Great Firewall
📝 README generator	Auto-detects project type (Python/Node.js/PHP/Go/Full-stack) and generates tailored README
🌿 Branch-aware	Detects current branch, prevents force-push accidents
🔀 PR workflow	Create pull requests instead of direct push
🚀 Release management	Tag + changelog + GitHub Release in one command
⚡ Dry-run mode	Preview everything before it happens

---

📦 Installation

# Clone into your Claude Code skills directory
cd ~/.claude/skills
git clone https://github.com/Tissue-for-charlie/github-sync-pro.git github-sync-pro

Windows (PowerShell):

cd $env:USERPROFILE\.claude\skills
git clone https://github.com/Tissue-for-charlie/github-sync-pro.git github-sync-pro

Restart Claude Code — the skill auto-registers. Type /github-sync-pro to verify.

If the clone fails with proxy errors, see proxy-troubleshooting.md.

---

🚀 Quick Start

# In any git repo, just run:
/github-sync-pro

# It will:
# 1. Show a health report
# 2. Scan all changed files for secrets
# 3. Let you review and select what to commit
# 4. Push to GitHub

---

📖 Sub-Commands

Command	What it does
/github-sync-pro	Full sync: preflight → scan → stage → commit → push
/github-sync-pro doctor	Run self-diagnostics only
/github-sync-pro scan	Secret scan only
/github-sync-pro push	Quick push (skip interactive staging)
/github-sync-pro pr	Create a pull request
/github-sync-pro readme	Generate README only
/github-sync-pro release	Full release: tag + changelog + GitHub Release
/github-sync-pro release --dry-run	Preview release
/github-sync-pro dry-run	Preview full sync

---

🛡️ What It Scans For

• ghp_* — GitHub Personal Access Token (classic)
• github_pat_* — GitHub fine-grained token
• sk-* — OpenAI / Claude API Key
• AIza* — Google AI API Key
• AKIA* — AWS Access Key ID
• Private key blocks (RSA, DSA, EC, OpenSSH)
• Plaintext password assignments
• Database connection strings with credentials
• Unredacted .env files

Detection = hard block. No commit proceeds with secrets in tracked files.

---

🧪 Tests

cd github-sync-pro
python3 tests/test_preflight.py

5 integration tests covering secret scanning and project type detection.

---

📁 Project Structure

github-sync-pro/
├── SKILL.md                        Skill entry point + command routing
├── LICENSE                         MIT
├── README.md                       You are here
├── scripts/
│   ├── preflight.sh                Self-diagnostics (macOS/Linux)
│   ├── preflight.ps1               Self-diagnostics (Windows)
│   ├── secret_scan.py              Pre-commit credential scanner
│   ├── gen_readme.py               Project-type-aware README generator
│   ├── interactive_commit.py       File-by-file staging wizard
│   └── release.sh                  Tag + changelog + GitHub Release
├── references/
│   ├── proxy-troubleshooting.md    Proxy diagnosis playbook
│   ├── gh-cli-cheatsheet.md        GitHub CLI quick reference
│   └── git-workflows.md            Git branching & collaboration patterns
└── tests/
    └── test_preflight.py           Integration tests

---

🌍 Cross-Platform

Platform	Preflight	Shell scripts	PowerShell
Windows	preflight.ps1	Git Bash supported	✅
macOS	preflight.sh	✅	—
Linux	preflight.sh	✅	—

---

🔧 Requirements

• git 2.30+
• gh CLI 2.0+ (for PR, release, and auth features)
• Python 3.10+ (for secret_scan, gen_readme, interactive_commit)
• curl (for proxy connectivity tests)

No Python dependencies beyond stdlib.

---

🤝 Contributing

Issues and PRs welcome. Run the test suite before submitting:

python3 tests/test_preflight.py

---

Built for AI coding agents. Works for humans too.