What happens when no argument is provided?

It performs push and fetch of issue refs to/from the configured remote.

What tools are required for platform syncs?

GitHub requires gh and jq; GitLab requires glab and jq; Gitea requires jq only.

sync

npx machina-cli add skill remenoscodes/claude-git-native-issue/sync --openclaw

Files (1)

SKILL.md

1.9 KB

git-native-issue — Sync

Synchronize issues with a remote or an external platform.

Arguments

$ARGUMENTS determines the sync direction and target:

Argument	Action
(empty)	Push and fetch issue refs to/from configured remote
`push`	Push issue refs: `git push origin 'refs/issues/*'`
`pull`	Fetch issue refs: `git fetch origin 'refs/issues/:refs/issues/'`
`merge`	Merge divergent issues from remote: `git issue merge origin`
`github:<owner>/<repo>`	Two-way sync with GitHub: `git issue sync github:<owner>/<repo> --state all`
`gitlab:<group>/<project>`	Two-way sync with GitLab: `git issue sync gitlab:<group>/<project> --state all`
`gitea:<owner>/<repo>`	Two-way sync with Gitea: `git issue sync gitea:<owner>/<repo> --state all`

Steps

Verify prerequisites: git repo, git-issue installed, remote configured (git config --get issue.remote).
For platform syncs, verify required CLI tools:
- GitHub: gh CLI + jq
- GitLab: glab CLI + jq
- Gitea/Forgejo: jq only
Execute the sync command.
Report results: number of issues synced, any conflicts detected.

For empty argument (default sync): run both push and pull in sequence:

git push origin 'refs/issues/*'
git fetch origin 'refs/issues/*:refs/issues/*'

Examples

/claude-git-native-issue:sync                              → push + pull issue refs
/claude-git-native-issue:sync push                         → push only
/claude-git-native-issue:sync github:remenoscodes/match-os → full GitHub sync
/claude-git-native-issue:sync merge                        → merge divergent remote issues

Source

git clone https://github.com/remenoscodes/claude-git-native-issue/blob/main/skills/sync/SKILL.mdView on GitHub

Overview

This skill synchronizes git-native-issues with a configured remote and external platforms like GitHub, GitLab, or Gitea. It supports push, pull, merge, and two-way platform syncs, enabling consistent issue refs across repositories and teams.

How This Skill Works

The sync direction is determined by ARGUMENTS. Depending on the argument, it runs commands such as git push, git fetch, git issue merge, or git issue sync with a platform. For platform syncs, it requires platform CLIs (gh, glab) and jq; after execution, it reports the number of issues synced and any conflicts detected.

When to Use It

Push and fetch issue refs to/from the configured remote (empty argument).
Push issue refs to the remote (argument: push).
Fetch/pull issue refs from the remote (argument: pull).
Merge divergent issues from the remote (argument: merge).
Two-way sync with a platform: GitHub, GitLab, or Gitea (args: github:owner/repo, gitlab:group/project, gitea:owner/repo).

Quick Start

Step 1: Verify prerequisites: git repo, git-issue installed, and remote configured.
Step 2: For platform syncs, ensure required CLI tools (gh, glab, jq) are installed.
Step 3: Run the desired sync command and review the results.

Best Practices

Verify prerequisites: a git repository, git-issue installed, and a configured remote (git config --get issue.remote).
For platform syncs, verify required CLI tools: GitHub → gh + jq, GitLab → glab + jq, Gitea/Forgejo → jq only.
Execute the chosen sync command and review the results.
Report the results: note the number of issues synced and any conflicts detected.
For the default behavior (empty argument), run push and then pull in sequence using the exact commands provided.

Example Use Cases

/claude-git-native-issue:sync → push + pull issue refs
/claude-git-native-issue:sync push → push only
/claude-git-native-issue:sync github:remenoscodes/match-os → full GitHub sync
/claude-git-native-issue:sync merge → merge divergent remote issues
/claude-git-native-issue:sync gitlab:demo-group/demo-project → full GitLab two-way sync

Frequently Asked Questions

Add this skill to your agents