Agent skill

Sync Issues

by minorun365 in minorun365/marp-agent

GitHubのissueとdocs/todo.mdを双方向同期する。新規issueをTODOに追加し、完了したTODOのissueをクローズする。

MITAuto-check passed

Install Sync Issues

skills CLI
$ npx skills add minorun365/marp-agent --skill sync-issues -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install minorun365/marp-agent sync-issues --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/minorun365/marp-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/sync-issues .claude/skills/sync-issues && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sync-issues
GitHub stars
124
Token cost
~443 tokens
SKILL.md length
85 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

GitHubのissueとdocs/todo.mdを双方向同期する。新規issueをTODOに追加し、完了したTODOのissueをクローズする。

  • Works in 5 steps: 現状を確認 → 差分を特定 → TODO.mdを更新 → …
  • SKILL.md covers 同期の方向, 手順, 新規issue追加時のテンプレート and 注意事項
  • Calls gh and git

What it does

Sync Issues is an agent skill from minorun365/marp-agent. GitHubのissueとdocs/todo.mdを双方向同期する。新規issueをTODOに追加し、完了したTODOのissueをクローズする。

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with GitHub. The licence is MIT.

Example prompts

  • “/sync-issues”

Requirements

  • Pre-approved tools (allowed-tools): Bash(gh issue list:*), Bash(gh issue view:*), Bash(gh issue close:*), Read

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 現状を確認
  2. 差分を特定
  3. TODO.mdを更新
  4. issueをクローズ
  5. 変更を確認

What it can do on your machine

Read from SKILL.md and the folder at commit ada8f9c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(gh issue list:*)
    • Bash(gh issue view:*)
    • Bash(gh issue close:*)
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sync Issues loads about 443 tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 85 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~21
When it runs · the whole SKILL.md, loaded when a task matches
~443

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from minorun365/marp-agent at commit ada8f9c, republished under its MIT licence (© minorun365). 85 words, ~443 tokens.

Download SKILL.mdSave it as .claude/skills/sync-issues/SKILL.md (or your agent's skills folder).
name
sync-issues
description
GitHubのissueとdocs/todo.mdを双方向同期する。新規issueをTODOに追加し、完了したTODOのissueをクローズする。
allowed-tools
Bash(gh issue list:*), Bash(gh issue view:*), Bash(gh issue close:*), Read
effort
low

GitHub Issue と TODO.md の同期

ユーザーが「issueを同期して」「TODOを更新して」と言った場合、このスキルに従って同期を実行する。

同期の方向

  1. GitHub → TODO.md: 新規issueをTODO.mdに追加
  2. TODO.md → GitHub: 完了状態(✅)のTODOに対応するissueをクローズ

手順

1. 現状を確認
bash
# オープンなissueを一覧
gh issue list --state open --limit 50

# 最近クローズされたissueを確認
gh issue list --state closed --limit 20
bash
# TODO.mdを読み込み
cat docs/todo.md
2. 差分を特定

以下を確認:

  • 追加が必要: オープンなissueでTODO.mdにないもの
  • クローズが必要: TODO.mdで「✅ 完了」かつ main・kag両方の実装列が完了(✅ or ➖) のもの
  • 削除が必要: TODO.mdにあるがissueがクローズ済みのもの

重要: kagブランチへの反映も含めて完了とみなす。main実装が完了していてもkag実装が「⬜」の場合はissueをクローズしない。

3. TODO.mdを更新

新規issueを追加する場合:

  • タスク管理表に行を追加(並び順: ①重要度 → ②工数小さい順)
  • 工数は「小」「中」「大」で見積もり
  • タスク詳細セクションにも概要・修正方法を追記

完了タスクを削除する場合:

  • タスク管理表から該当行を削除
  • タスク詳細セクションからも該当セクションを削除
4. issueをクローズ

TODO.mdで「✅ 完了」になっているissueをクローズ:

bash
gh issue close <issue番号> --comment "実装が完了しました 🎉"
5. 変更を確認
bash
git diff docs/todo.md

新規issue追加時のテンプレート

タスク管理表の行
markdown
| #XX | タスク名 | 工数 | ⬜ 未着手 | | ⬜ | ⬜ | ⬜ | ➖ |
タスク詳細セクション
markdown
### #XX タスク名

**概要**: issueの内容を簡潔に説明

**現状**: 現在の実装状況

**修正方法**: 具体的な修正手順

**工数**: 小(見積もり根拠)

---

注意事項

  • タスク管理表の並び順を維持する(①重要度 → ②工数小さい順)
  • ラベルはGitHubのissueに従う(勝手に「🔴 重要」をつけない)
    • gh issue view <番号> で labels を確認し、「重要」ラベルがある場合のみ「🔴 重要」を付与
  • kag列は基本的に「➖ 対象外」(mainのみ実装のタスクが多い)
  • issueの詳細が不明な場合は gh issue view <番号> で確認
  • issueクローズの条件: main実装だけでなく、kag実装も完了(✅ or ➖)していること
    • kag実装が「⬜」の場合はissueをクローズしない
    • 誤ってクローズした場合は gh issue reopen <番号> で再オープン

© minorun365, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/sync-issues of minorun365/marp-agent.

Open the folder on GitHubat commit ada8f9c

Compare with similar skills

Sync Issues next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sync Issues compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sync Issues this skillminorun365/marp-agent124—~443Automated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Diagnosing Superpowers Sessionsobra/superpowers297k3 repos~1.7kAutomated safety check: PassMIT
Greplooponyx-dot-app/onyx32k4 repos~3.3kAutomated safety check: PassMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Update V8 Versionopeninterpreter/openinterpreter69k2 repos~845Automated safety check: PassApache-2.0

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Investigates a session where Superpowers went wrong, reads the transcripts on disk and produces an evidence-cited report, optionally prepared as a bug report for the maintainers.

    297k GitHub starsUsed in 3 repos~1.7k tokens
    Agent WorkflowsAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Update V8 Version

    openinterpreter/openinterpreter

    Bumps the pinned v8 and rusty_v8 versions in Codex, validates the release-candidate path with the v8-canary check, and traces failures to upstream build changes.

    69k GitHub starsUsed in 2 repos~845 tokens
    DevOps & CloudAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes

More from minorun365/marp-agent

  • Sync To Kag

    minorun365/marp-agent

    一般公開版(marp-agent)の変更を、KAG社内版(marp-agent-kag)へマージで取り込む。公開版を本番へデプロイしたら必ず実行する。「kagにも反映して」「kag環境にも適用して」「同期して」で起動。

    124 GitHub stars~779 tokensUpdated 8 days ago
    Auto-check: notes
  • Commit Docs

    minorun365/marp-agent

    デプロイ不要な変更をコミット([skip-cd]付きでAmplifyデプロイをスキップ). An agent skill from minorun365/marp-agent.

    124 GitHub stars~360 tokensUpdated 8 days ago
    Auto-check passed

Works with

Questions about Sync Issues

What does Sync Issues do?

GitHubのissueとdocs/todo.mdを双方向同期する。新規issueをTODOに追加し、完了したTODOのissueをクローズする。. Sync Issues is an agent skill from minorun365/marp-agent.

How do I install Sync Issues in Claude Code?

Run `npx skills add minorun365/marp-agent --skill sync-issues -a claude-code`. Or copy the skill folder (.agents/skills/sync-issues in minorun365/marp-agent) into .claude/skills/sync-issues in your project. Claude Code loads it when a task matches its description.

How do I install Sync Issues in Codex?

Run `npx skills add minorun365/marp-agent --skill sync-issues -a codex`. Or copy the skill folder (.agents/skills/sync-issues in minorun365/marp-agent) into .agents/skills/sync-issues in your project. Codex loads it when a task matches its description.

Can I use Sync Issues in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add minorun365/marp-agent --skill sync-issues -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sync-issues, .gemini/skills/sync-issues, .github/skills/sync-issues and .opencode/skills/sync-issues in your project.

What does Sync Issues need to run?

Going by SKILL.md and its folder, Sync Issues needs the command-line tools its instructions call (gh and git). Its frontmatter pre-approves these tools: Bash(gh issue list:*), Bash(gh issue view:*), Bash(gh issue close:*), Read.

Does Sync Issues access the network?

SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Sync Issues safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sync Issues use?

Sync Issues is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sync Issues use?

About 443 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sync Issues?

Skills that share tags, products or a category with Sync Issues: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Diagnosing Superpowers Sessions (obra/superpowers, 297k stars), Greploop (onyx-dot-app/onyx, 32k stars) and GitHub Deep Research (bytedance/deer-flow, 84k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sync Issues?

minorun365 (a GitHub user) maintains it in minorun365/marp-agent, which has 124 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 1, 2026.

Source: minorun365/marp-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.