| name | GitHub Sync |
| description | Keep local plan and GitHub project artifacts perfectly aligned with milestones, issues, labels, and statuses. |
GitHub Sync Skill
Purpose
Keep local plan and GitHub project artifacts perfectly aligned (milestones, issues, labels, statuses, dependencies).
Use when
- Creating/updating plan
- Changing issue status
- Completing milestones
Naming Rules
- Milestone:
M<id> — <description>
- Issue:
[M<milestone_id>] I<issue_id> — <task>
Required Metadata
- Priority label:
P-critical|P-high|P-medium|P-low
- Type label:
feat|fix|refactor|chore|test
- Status label:
in-progress|review|blocked
- Milestone link
- Dependency note:
depends on #<issue_number>
- Parent/child note:
part of #<issue_number>
Procedure
- On plan create/update, create/update corresponding GitHub milestones/issues.
- On local issue status change, sync GitHub status + labels immediately.
- Close milestone when all linked issues are done.
- Ensure no orphan issues (every issue belongs to a milestone).
Done Criteria
- Local plan == GitHub state (titles, labels, status, dependencies).
Anti-patterns
- Local-only tracking
- Orphan issues
- Stale labels/status