gh-issue-sync

🥈Silver

Sync GitHub issues to local Markdown files for offline editing, batch updates, and integration with coding workflows. Benefits developers and operations teams by enabling offline work and streamlining issue management.

13690Updated Today

Intermediate30min to implementautomation

Quick InstallView Source

git clone https://github.com/mitsuhiko/gh-issue-sync.git

Works with:

Claude

Overview

About This Skill

How to Use

["Install GitHub CLI (gh) and authenticate with 'gh auth login'","Run the sync command with your repository and directory parameters","Review the summary report to verify changes","Edit the Markdown files offline as needed","Push changes back to GitHub using 'gh issue create' or manual PRs","Tip: Use 'gh issue list --label [LABEL]' to preview issues before syncing"]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/mitsuhiko/gh-issue-sync

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Sync GitHub issues for repository [REPO_NAME] to local Markdown files in directory [LOCAL_DIR]. Include issues labeled [LABEL_FILTER] and exclude those with status [EXCLUDE_STATUS]. Generate a summary report of changes made during the sync. Use GitHub CLI (gh) for the operation.

Example Output

Sync completed for repository 'acme-web-app' in directory './issues-backup'. Processed 42 issues (23 updated, 19 new, 0 skipped). Issues excluded due to 'closed' status: 5. Labels processed: 'bug', 'enhancement', 'critical'. 

**Summary Report:**
- Total issues synced: 42
- New Markdown files created: 19
- Existing files updated: 23
- Issues excluded: 5 (all 'closed' status)
- Largest issue: #124 (245 lines) - 'Login timeout on mobile devices'
- Most commented: #89 (14 comments) - 'Dark mode implementation'

**Files Modified:**
- ./issues-backup/bug/issue-124-login-timeout.md
- ./issues-backup/enhancement/issue-89-dark-mode.md
- ./issues-backup/critical/issue-203-api-rate-limiting.md

All Markdown files include frontmatter with GitHub metadata (title, number, labels, assignees, created_at, updated_at) and are formatted for easy editing. The sync took 47 seconds to complete.