Agent skill

Shogun Readme Sync

by yohey-w in yohey-w/multi-agent-shogun

README.md(英語)とREADMEja.md(日本語)の同期を確認・実行するスキル。README変更時に両言語版を必ず同時更新するために使用。「README更新」「README同期」「readme sync」で起動。

MITAuto-check passedDevelopment

Install Shogun Readme Sync

skills CLI
$ npx skills add yohey-w/multi-agent-shogun --skill shogun-readme-sync -a claude-code

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

GitHub CLI
$ gh skill install yohey-w/multi-agent-shogun shogun-readme-sync --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/yohey-w/multi-agent-shogun.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/shogun-readme-sync .claude/skills/shogun-readme-sync && 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
shogun-readme-sync
GitHub stars
1.4k
Token cost
~528 tokens
SKILL.md length
126 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

README.md(英語)とREADMEja.md(日本語)の同期を確認・実行するスキル。README変更時に両言語版を必ず同時更新するために使用。「README更新」「README同期」「readme sync」で起動。

  • Works in 4 steps: 差分検出 → 差分レポート → 同期実行 → …
  • Tasks that involve Technical documentation
  • SKILL.md covers Overview, When to Use, Instructions and Guidelines
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Shogun Readme Sync is an agent skill from yohey-w/multi-agent-shogun. README.md(英語)とREADMEja.md(日本語)の同期を確認・実行するスキル。README変更時に両言語版を必ず同時更新するために使用。「README更新」「README同期」「readme sync」で起動。

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

It sits in Development, covering Technical documentation. It works with tmux. The repository describes itself as: Samurai-inspired multi-agent system for Claude Code. Orchestrate parallel AI tasks via tmux with shogun → karo → ashigaru hierarchy. The licence is MIT.

When your agent uses it

  • Tasks that involve Technical documentation

Example prompts

  • “/shogun-readme-sync”

Workflow steps

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

  1. 差分検出
  2. 差分レポート
  3. 同期実行
  4. 整合性最終チェック

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

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

  • Network

    No URLs in SKILL.md.

    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

Shogun Readme Sync loads about 528 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 126 words of instructions outside code blocks.

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

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 yohey-w/multi-agent-shogun at commit aff8dc8, republished under its MIT licence (© yohey-w). 126 words, ~528 tokens.

Download SKILL.mdSave it as .claude/skills/shogun-readme-sync/SKILL.md (or your agent's skills folder).
name
shogun-readme-sync
description
README.md(英語)とREADME_ja.md(日本語)の同期を確認・実行するスキル。README変更時に両言語版を必ず同時更新するために使用。「README更新」「README同期」「readme sync」で起動。

/shogun-readme-sync - README日英同期

Overview

README.md(英語)とREADME_ja.md(日本語)の差分を検出し、不足セクションの追加・番号ズレの修正を行う。

README変更時のワークフロー:

  1. 差分検出(どちらが新しいか自動判定)
  2. 不足セクションのリストアップ
  3. 翻訳・追記の実行
  4. セクション番号の整合性チェック

When to Use

  • READMEを編集した後(機能追加、セクション追加、構成変更)
  • 「README更新」「README同期」「readme sync」と言われた時
  • 新機能をREADMEに書いた後に「日本語版も」と言われた時
  • PR作成前のREADME整合性チェック

Instructions

Step 1: 差分検出

両ファイルを読み込み、以下の観点で差分を検出する:

bash
# 両ファイルを読む
Read README.md
Read README_ja.md

チェック項目:

項目確認方法
セクション数### ヘッダーの数が一致するか
セクション番号番号付きセクション(### ... 1., ### ... 2.等)の連番が正しいか
ファイル構成File Structure / ファイル構成セクション内のファイル一覧が一致するか
バージョンセクションWhat's New / 新機能 セクションが両方に存在するか
折りたたみ内容<details> ブロックの有無が一致するか
Step 2: 差分レポート

検出した差分を報告する:

README同期チェック結果:

EN → JA で不足:
- セクション「Agent Status Check」が日本語版にない
- ファイル構成に lib/agent_status.sh が未掲載
- v3.3.2セクションがない

JA → EN で不足:
- (なし)

セクション番号ズレ:
- JA: スクリーンショットが5番だがENでは6番
Step 3: 同期実行

差分を修正する。翻訳のルール:

ENJA
Agent Status Checkエージェント稼働確認
Screenshot Integrationスクリーンショット連携
Context Managementコンテキスト管理
Phone Notificationsスマホ通知
Pane Border Task Displayペインボーダータスク表示
Shout Modeシャウトモード(戦国エコー)
Event-Driven Communicationイベント駆動通信
Parallel Execution並列実行
Non-Blocking Workflowノンブロッキングワークフロー
Cross-Session Memoryセッション間記憶
Bottom-Up Skill Discoveryボトムアップスキル発見

翻訳方針:

  • 技術用語はそのまま(tmux, YAML, CLI, MCP, inotifywait等)
  • コードブロック内のコマンドは翻訳しない
  • 出力例は日本語版に合わせる(「稼働中」「待機中」等)
  • 絵文字はENと同じものを使う
Step 4: 整合性最終チェック

修正後、以下を確認:

  1. 両ファイルのセクション数が一致
  2. 番号付きセクションの連番が正しい
  3. ファイル構成セクションのエントリが一致
  4. バージョンセクションが両方に存在

Guidelines

  • ENが正: 新機能は基本的にENに先に書かれる。JA側を追従させる
  • JA独自表現は維持: 日本語版の「戦国エコー」等の独自表現はそのまま残す
  • 一方通行にしない: ENにしかない変更もJAにしかない変更も両方検出する
  • セクション番号は自動繰り上げ: 中間にセクションを挿入した場合、後続の番号を全て繰り上げる
  • コードブロック内は触らない: bash/yaml/markdownのコードブロック内テキストは翻訳対象外

© yohey-w, 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 skills/shogun-readme-sync of yohey-w/multi-agent-shogun.

Open the folder on GitHubat commit aff8dc8

Compare with similar skills

Shogun Readme Sync 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.

Shogun Readme Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shogun Readme Sync this skillyohey-w/multi-agent-shogun1.4k—~528Automated safety check: PassMIT
Feature Development WorkflowQwenLM/qwen-code28k—~1.2kAutomated safety check: PassApache-2.0
Diagram Designcathrynlavery/diagram-design48k1 repos~7.6kAutomated safety check: PassMIT
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
Doc SyncJetBrains/ideavim10k2 repos~2.6kAutomated safety check: PassMIT
Mailspring App ScreenshotsFoundry376/Mailspring18k—~1.5kAutomated safety check: PassGPL-3.0

Similar skills

  • Phased workflow for non-trivial qwen-code features: investigate, design doc, E2E test plan, baseline dry-run, implement, verify, self-audit, review and iterate.

    28k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Diagram Design

    cathrynlavery/diagram-design

    Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.

    48k GitHub starsUsed in 1 repo~7.6k tokens
    DevelopmentAuto-check passed
  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • Doc Sync

    JetBrains/ideavim

    Official

    Keeps IdeaVim documentation in sync with code changes. An agent skill from JetBrains/ideavim.

    10k GitHub starsUsed in 2 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Mailspring App Screenshots

    Foundry376/Mailspring

    Captures screenshots of the running Mailspring dev app for docs, PRs or visual checks by launching it with a debugging port, driving the UI and clipping to an element.

    18k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Draw.io Diagram Studio

    Agents365-ai/drawio-skill

    Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.

    10k GitHub stars~2.4k tokensUpdated 7 days ago
    DevelopmentAuto-check: notes

More from yohey-w/multi-agent-shogun

All 8 skills in this repo
  • Shogun Screenshot

    yohey-w/multi-agent-shogun

    スクリーンショットの取得・加工を行う。ローカルスクショから最新画像を取得、 PlaywrightでWebページをキャプチャ、画像のトリミング・リサイズ、機微情報を黒塗りマスキング。

    1.4k GitHub stars~901 tokensUpdated 2 mo ago
    Auto-check: notes
  • Shogun Bloom Config

    yohey-w/multi-agent-shogun

    Interactive wizard: guided questions with multiple-choice options about subscriptions, then outputs a ready-to-paste capabilitytiers YAML + fixed agent model assignments.

    1.4k GitHub stars~3.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Shogun Model List

    yohey-w/multi-agent-shogun

    All AI CLI tools × available models × required subscriptions × Bloom max capability.

    1.4k GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Skill Creator

    yohey-w/multi-agent-shogun

    Claude Codeスキル(SKILL.md)の設計・作成・バリデーション・レビュー. An agent skill from yohey-w/multi-agent-shogun.

    1.4k GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Shogun Model Switch

    yohey-w/multi-agent-shogun

    エージェントのCLI/モデルをライブ切替するスキル。settings.yaml更新→/exit→新CLI起動→ pane metadata更新を一発で実行。Thinking有無も制御。

    1.4k GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Inbox Write

    yohey-w/multi-agent-shogun

    別エージェントのinboxにメッセージを送信する。agent-to-agent通信の唯一の手段. An agent skill from yohey-w/multi-agent-shogun.

    1.4k GitHub stars~186 tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about Shogun Readme Sync

What does Shogun Readme Sync do?

README.md(英語)とREADMEja.md(日本語)の同期を確認・実行するスキル。README変更時に両言語版を必ず同時更新するために使用。「README更新」「README同期」「readme sync」で起動。. Shogun Readme Sync is an agent skill from yohey-w/multi-agent-shogun.

When should I use Shogun Readme Sync?

Shogun Readme Sync fits situations like: tasks that involve Technical documentation.

How do I install Shogun Readme Sync in Claude Code?

Run `npx skills add yohey-w/multi-agent-shogun --skill shogun-readme-sync -a claude-code`. Or copy the skill folder (skills/shogun-readme-sync in yohey-w/multi-agent-shogun) into .claude/skills/shogun-readme-sync in your project. Claude Code loads it when a task matches its description.

How do I install Shogun Readme Sync in Codex?

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

Can I use Shogun Readme Sync 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 yohey-w/multi-agent-shogun --skill shogun-readme-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shogun-readme-sync, .gemini/skills/shogun-readme-sync, .github/skills/shogun-readme-sync and .opencode/skills/shogun-readme-sync in your project.

What does Shogun Readme Sync need to run?

SKILL.md names no scripts, command-line tools or credentials: Shogun Readme Sync is instructions for the agent only.

Does Shogun Readme Sync access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Shogun Readme Sync 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 Shogun Readme Sync use?

Shogun Readme Sync 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 Shogun Readme Sync use?

About 528 tokens (SKILL.md is roughly 2.1k 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 Shogun Readme Sync?

Skills that share tags, products or a category with Shogun Readme Sync: Feature Development Workflow (QwenLM/qwen-code, 28k stars), Diagram Design (cathrynlavery/diagram-design, 48k stars), Simple English (moeru-ai/airi, 50k stars) and Doc Sync (JetBrains/ideavim, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shogun Readme Sync?

yohey-w (a GitHub user) maintains it in yohey-w/multi-agent-shogun, which has 1,425 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on August 6, 2026.

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