github-sync
CommunityKeep GitHub issues perfectly aligned with your project.
Authorakaszubski
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Manually synchronizing GitHub issues with project documentation (like PROJECT.md or STATUS.md) is a tedious, error-prone task that leads to stale issues and misaligned priorities. This Skill automates bi-directional synchronization, ensuring your GitHub issues always reflect the true state and focus of your project.
Core Features & Use Cases
- Auto-Create/Close Issues: Automatically creates GitHub issues from
PROJECT.mdand closes them when corresponding code/tests are implemented. - Path Rename Detection: Detects project renames and automatically updates file paths referenced in GitHub issue bodies.
- Sprint Progress Tracking: Updates
STATUS.mdwith real-time issue counts and recent activity, providing a clear overview of sprint progress. - Use Case: After a major refactor renames several files, this Skill automatically updates all GitHub issues referencing the old paths, preventing broken links and ensuring developers can quickly find relevant code.
Quick Start
Run a full bi-directional sync
This will auto-create/close issues, update PROJECT.md,
track sprint progress, detect renames, and sync labels.
python .claude/skills/github-sync/sync_v2.py
To only create missing issues:
python .claude/skills/github-sync/sync_v2.py --auto-create
Dependency Matrix
Required Modules
PyGithubpyyaml
Components
scripts
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: github-sync Download link: https://github.com/akaszubski/realign/archive/main.zip#github-sync Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.