Agent skill

Merge Shepherd

by ivanarama in ivanarama/onebase

Безопасная обработка merge-очереди ivanarama/onebase: только PR с меткой ship, последовательное обновление ветки, ожидание CI и merge.

MITAuto-check passedDevelopment

Install Merge Shepherd

skills CLI
$ npx skills add ivanarama/onebase --skill merge-shepherd -a claude-code

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

GitHub CLI
$ gh skill install ivanarama/onebase merge-shepherd --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/ivanarama/onebase.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/merge-shepherd .claude/skills/merge-shepherd && 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
merge-shepherd
GitHub stars
115
Token cost
~426 tokens
SKILL.md length
158 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Безопасная обработка merge-очереди ivanarama/onebase: только PR с меткой ship, последовательное обновление ветки, ожидание CI и merge.

  • Works in 7 steps: Сначала прочитать короткий общий маршрут… → Следовать ей с обычным приоритетом… → До записи в GitHub проверить доступность… → …
  • Development work in your project
  • Calls gh

What it does

Merge Shepherd is an agent skill from ivanarama/onebase. Безопасная обработка merge-очереди ivanarama/onebase: только PR с меткой ship, последовательное обновление ветки, ожидание CI и merge. Использовать, когда пользователь явно просит обработать очередь слияния или вызывает $merge-shepherd.

Its SKILL.md is about 430 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. The repository describes itself as: Открытая бизнес-платформа со знакомым DSL для учётных задач, написанная на Go — open business platform with a familiar DSL, in Go. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/merge-shepherd”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Сначала прочитать короткий общий маршрут .claude/skills/merge-shepherd/SKILL.md и использовать pipelinectl из задачи.
  2. Следовать ей с обычным приоритетом инструкций Codex: слово headless не отменяет системные ограничения, безопасность или необходимость…
  3. До записи в GitHub проверить доступность gh, действующую аутентификацию и gh api user --jq .login. Писать разрешено только от ivanarama…
  4. Считать $merge-shepherd Codex-эквивалентом /merge-shepherd. Упоминания следующих этапов — только описание маршрута, не разрешение…
  5. Разрешать пути от корня репозитория. Создавать worktree только по уникальному проверенному абсолютному пути и удалять лишь worktree…
  6. На Windows переводить &&, sleep и REST-конвейеры в безопасные PowerShell-эквиваленты. Ожидать CI порциями не более 60 секунд и регулярно…
  7. Полную процедуру references/legacy-protocol.md читать только при action=fallback; не загружать её в обычном tool-пути.

What it can do on your machine

Read from SKILL.md and the folder at commit 62e2a97. 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

    Shell commands in SKILL.md call:

    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use gh, 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

Merge Shepherd loads about 426 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 158 words of instructions outside code blocks.

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

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 ivanarama/onebase at commit 62e2a97, republished under its MIT licence (© ivanarama). 158 words, ~426 tokens.

Download SKILL.mdSave it as .claude/skills/merge-shepherd/SKILL.md (or your agent's skills folder).
name
merge-shepherd
description
Безопасная обработка merge-очереди ivanarama/onebase: только PR с меткой ship, последовательное обновление ветки, ожидание CI и merge. Использовать, когда пользователь явно просит обработать очередь слияния или вызывает $merge-shepherd.

Codex-адаптер мерж-очереди

  1. Сначала прочитать короткий общий маршрут .claude/skills/merge-shepherd/SKILL.md и использовать pipelinectl из задачи.
  2. Следовать ей с обычным приоритетом инструкций Codex: слово headless не отменяет системные ограничения, безопасность или необходимость сообщить настоящий блокер.
  3. До записи в GitHub проверить доступность gh, действующую аутентификацию и gh api user --jq .login. Писать разрешено только от ivanarama; иначе остановиться без изменений. Перед каждым изменением перечитать состояние PR; параллельный планировщик не считается заблокированным автоматически.
  4. Считать $merge-shepherd Codex-эквивалентом /merge-shepherd. Упоминания следующих этапов — только описание маршрута, не разрешение запускать их автоматически.
  5. Разрешать пути от корня репозитория. Создавать worktree только по уникальному проверенному абсолютному пути и удалять лишь worktree текущего прогона; локальный main не трогать.
  6. На Windows переводить &&, sleep и REST-конвейеры в безопасные PowerShell-эквиваленты. Ожидать CI порциями не более 60 секунд и регулярно сообщать прогресс.
  7. Полную процедуру references/legacy-protocol.md читать только при action=fallback; не загружать её в обычном tool-пути.

Детерминированная механика обычного пути живёт в pipelinectl; сложные состояния остаются в fallback-процедуре.

© ivanarama, 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/merge-shepherd of ivanarama/onebase.

Open the folder on GitHubat commit 62e2a97

Compare with similar skills

Merge Shepherd 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.

Merge Shepherd compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Merge Shepherd this skillivanarama/onebase115—~426Automated safety check: PassMIT
Vercel Composition Patternssupabase/supabase111k58 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k4 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 58 repos~726 tokens
    DevelopmentAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed
  • 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
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-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

More from ivanarama/onebase

All 12 skills in this repo
  • Review Queue

    ivanarama/onebase

    Ревью открытых PR ivanarama/onebase перед мержем через детерминированный pipelinectl с безопасным fallback на полный протокол.

    115 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Merge Shepherd

    ivanarama/onebase

    Безопасное слияние PR ivanarama/onebase через детерминированный pipelinectl с fallback для base-sync, конфликтов и recovery.

    115 GitHub stars~856 tokensUpdated today
    Auto-check passed
  • Plan Approved

    ivanarama/onebase

    Подготовка технического плана для одобренной issue ivanarama/onebase с меткой plan-needed.

    115 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Discussions Watch

    ivanarama/onebase

    Разбор обсуждений (Discussions) ivanarama/onebase — треды, где внешний человек написал и остался без ответа.

    115 GitHub stars~7k tokensUpdated today
    Auto-check passed
  • Fix Approved

    ivanarama/onebase

    Реализация заявок ivanarama/onebase с меткой ready-fix (очевидные дефекты, автоход) или approved (решение человека) и доработка своих PR по замечаниям ревью — фикс в отдельном worktree, тесты, PR с…

    115 GitHub stars~13k tokensUpdated today
    Auto-check passed
  • Tail Issues

    ivanarama/onebase

    Заведение заявок по хвосту ревью ivanarama/onebase — находки, которые ревью пометило [заявка] и которые пережили мерж PR.

    115 GitHub stars~8.4k tokensUpdated today
    Auto-check passed

Categories

Questions about Merge Shepherd

What does Merge Shepherd do?

Безопасная обработка merge-очереди ivanarama/onebase: только PR с меткой ship, последовательное обновление ветки, ожидание CI и merge. Merge Shepherd is an agent skill from ivanarama/onebase. Безопасная обработка merge-очереди ivanarama/onebase: только PR с меткой ship, последовательное обновление ветки, ожидание CI и merge.

When should I use Merge Shepherd?

Merge Shepherd fits situations like: development work in your project.

How do I install Merge Shepherd in Claude Code?

Run `npx skills add ivanarama/onebase --skill merge-shepherd -a claude-code`. Or copy the skill folder (.agents/skills/merge-shepherd in ivanarama/onebase) into .claude/skills/merge-shepherd in your project. Claude Code loads it when a task matches its description.

How do I install Merge Shepherd in Codex?

Run `npx skills add ivanarama/onebase --skill merge-shepherd -a codex`. Or copy the skill folder (.agents/skills/merge-shepherd in ivanarama/onebase) into .agents/skills/merge-shepherd in your project. Codex loads it when a task matches its description.

Can I use Merge Shepherd 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 ivanarama/onebase --skill merge-shepherd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/merge-shepherd, .gemini/skills/merge-shepherd, .github/skills/merge-shepherd and .opencode/skills/merge-shepherd in your project.

What does Merge Shepherd need to run?

Going by SKILL.md and its folder, Merge Shepherd needs the command-line tools its instructions call (gh).

Does Merge Shepherd access the network?

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

Is Merge Shepherd 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 Merge Shepherd use?

Merge Shepherd 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 Merge Shepherd use?

About 426 tokens (SKILL.md is roughly 1.7k 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 Merge Shepherd?

Skills that share tags, products or a category with Merge Shepherd: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Merge Shepherd?

ivanarama (a GitHub user) maintains it in ivanarama/onebase, which has 115 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 10, 2026.

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