gh-issue-sync

Synchronize GitHub issues to local Markdown files for offline editing.

160|13|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/mitsuhiko/gh-issue-sync --skill gh-issue-sync-mitsuhiko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-issue-sync
Source: https://github.com/mitsuhiko/gh-issue-sync/tree/main/skill
Command: npx skills add https://github.com/mitsuhiko/gh-issue-sync --skill gh-issue-sync-mitsuhiko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the management of GitHub issues by allowing users to work with them locally as Markdown files, facilitating offline editing, batch updates, and integration with AI coding tools.

Core Features & Use Cases

  • Local Issue Management: Syncs GitHub issues to local Markdown files for offline editing and batch updates.
  • AI Integration: Enables coding agents to work with issues locally until ready for push.
  • New Issue Creation: Supports creating new issues locally with temporary IDs that are replaced with real issue numbers upon pushing.
  • Use Case: A developer can pull all open bugs, edit their descriptions and labels locally using their preferred editor, and then push all changes back to GitHub in one go.

Quick Start

Initialize issue sync in your project directory.

Frequently Asked Questions about gh-issue-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync GitHub issues to local Markdown files for offline editing?

You can sync GitHub issues to local Markdown files using a command-line interface that pulls issues for offline editing and batch updates. Changes are saved locally and pushed back to GitHub in one go.

Can I create new GitHub issues locally and push them in a batch?

Yes, you can create new issues locally with temporary IDs that are automatically replaced with real GitHub issue numbers upon pushing. This allows batch creation and editing offline before syncing.

Does this issue sync tool require the GitHub CLI for authentication?

Yes, the tool integrates directly with the GitHub CLI to handle authentication and execute operations like pulling, pushing, and commenting on issues.

What is the best way to manage GitHub issue states like closing and reopening offline?

The best way to manage issue states offline is by syncing them to local Markdown files. You can edit states locally and batch push updates to close, reopen, or comment on issues via the CLI.

Can coding agents work with GitHub issues locally before pushing changes?

Yes, AI integration allows coding agents to read and work with local Markdown issue files offline. Agents can process issue descriptions and labels locally until ready for a batch push to GitHub.