mitsuhikomitsuhikoCommunityยท1 Agent Skills Included

gh-issue-sync

Sync GitHub issues to local Markdown files

Syncs GitHub issues to local Markdown files for offline editing, batch updates, and bulk refinement. Eliminates tedious one-by-one issue editing on the GitHub website by letting you change everything locally and push at once. Supports creating issues with temporary IDs, conflict detection, and search so coding agents and developers can triage work faster.
npx skills add mitsuhiko/gh-issue-sync --all -g -y
Available:

Instructs your AI agent to read and manage GitHub issues through the local synced Markdown files instead of the GitHub CLI, and to follow the project's commit and communication rules.

All Skills in This Repository (1)

Pure Emerald Level Indicators

Frequently Asked Questions

FAQPage Schema
How to install gh-issue-sync?โ–ผ

Run `npx skills add mitsuhiko/gh-issue-sync --all -g -y` in your terminal to install the skill globally for your agent.

How to edit GitHub issues offline?โ–ผ

Run `gh-issue-sync pull` to download issues as Markdown files into a local `.issues/` folder, edit them in any editor, then run `gh-issue-sync push` to sync changes back.

Can I create GitHub issues locally before publishing?โ–ผ

Yes. Create issues with temporary IDs like T1 using `gh-issue-sync new`, and they receive real issue numbers automatically when you push.

Does gh-issue-sync work with Claude Code and Codex?โ–ผ

Yes. Run `gh-issue-sync write-skill --agent claude` or `--agent codex` to install the skill file so your agent knows how to use the tool.

What happens if an issue changes both locally and on GitHub?โ–ผ

The tool uses three-way comparison to detect conflicts and skips conflicting issues with a warning, so no edits are silently lost.

Related Repositories in Software Engineering

View All in Software Engineeringโ†’