gh-issue-sync: a Claude Code skill by Armin Ronacher
For developers who want to triage and edit GitHub issues as local Markdown files. Skip it if your team tracks work in Jira, Linear or a tool other than GitHub Issues.
- Score
- 54of 100
- Rank
- #235of 239
- Installs
- 27.3Kon skills.sh
- Security
- Mixed 4 scanners
- Updated
- 2026
- Context
- ~39tokens always
Install
npx skills add https://github.com/mitsuhiko/gh-issue-sync --skill gh-issue-sync
Run it in your terminal. View the source
Using the Claude app rather than Claude Code? You can add a skill there too. How to add it in the app
What does gh-issue-sync do?
gh-issue-sync is a skill that teaches Claude to work with GitHub issues through the gh-issue-sync command, which mirrors them as Markdown files in .issues/open/ and .issues/closed/. Each file has frontmatter for title, labels, assignees, milestone and state, with the issue number taken from the filename. Claude runs pull to fetch issues, edits files, checks status or diff, then push (with --dry-run first if wanted). New issues get a temporary T ID that becomes the real number on push, and references in other issues update to match. A .comment.md file beside an issue posts as a comment and is deleted afterwards.
When should you use gh-issue-sync?
Use it when
- You want to bulk edit labels or milestones on many issues
- You prefer writing new issues in your editor
- You want Claude to triage open issues in a repo
Skip it when
- Your issues live outside GitHub
- You don't want issue files inside your repo
What it needs and what it can touch
You need
- The gh-issue-sync command-line tool
- A git repository hosted on GitHub
What it can do
- Runs shell commands (gh-issue-sync)
- Reads and edits Markdown files under .issues/
- Sends changes, new issues and comments to GitHub on push
From reading its instructions, not from running it.
Why it scores 54
Strongest on quality (100 of 100), weakest on upkeep (40).
Is gh-issue-sync safe to install?
At least one scanner raised a medium warning. Read the results below. Scanners often miss what other scanners catch, and a skill can change after a scan. Read its source before you install it.
| Scanner | Result | Date |
|---|---|---|
| Gen Agent Trust Hub | Passed | Sep 15, 2026 |
| Socket | Passed | Sep 15, 2026 |
| Snyk | Medium risk | Sep 15, 2026 |
| Runlayer | Medium risk | Feb 23, 2026 |
Details
- Installs
- 27,298
- Repository stars
- 169
- Last repository change
- Tokens always loaded
- about 39
- Tokens when used
- about 436
- License
- Apache-2.0
- Data confidence
- High
Did it do the job for you?
Alternatives to gh-issue-sync
All skills for this job-
Get orca-linearorca-linear
For Orca users who want Claude to update, search and close out Linear tickets from the terminal.
-
Get gws-gmailgws-gmail
For gws CLI users who want Claude to read, triage, send and reply to Gmail from the terminal.
-
Get gws-gmail-send
gws-gmail-send
For people using the Google Workspace CLI who want Claude to send or draft Gmail messages.
gh-issue-sync