Skip to content
cccskills
FreePublished on GitHub

merge-batch

Prepare a selected batch of pull requests, or proposed code changes, by reviewing overlaps, diagnosing conflicts, and preserving contributor credit. Check the exact version and required authorization before each merge, then report completed work and remaining holds.

OriginalShow the original description

Prepare and merge an owner-selected PR batch with contributor credit and exact-candidate admission. Use for a pasted PR list; combined focused validation is diagnostic, and every actual landing still requires its applicable checks and authorization.

See how to install

Good for

  • Prepare a selected batch of pull requests
  • Investigate conflicts between proposed changes
  • Check validation and authorization before merging
  • Track merge results and contributor credit

Files included (1)

  • SKILL.md5.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Merge batch: shared preparation, exact admission

Read ../_shared/base-green.md, ../_shared/validation-gate.md and ../_shared/merge-gates.md. Their current-candidate, authority, protected-surface and credit rules govern this workflow. Historical throughput, administrative merge and blanket rebaseline exceptions are superseded by that protocol.

Batching shares discovery and conflict diagnosis. It does not make a combined board's PASS evidence valid for different intermediate squash candidates.

1. Intake and authority

Resolve each selected PR's open/draft state, current head/base, target, contributor and write authority. Read the diff and current freeze state, and check active worktree ownership. Hold any item another session is working. A request to analyze or prepare a list is not authority to merge or close it.

Run scripts/quality/check-skill-contract.mjs against the actual installed skills root before admission. Missing or drifted modeled instructions mean HOLD; a template-only check does not verify the installation being used.

Show a 1–5 star table with rationale, overlaps and holds. Stars prioritize work; they do not waive required checks or protected-surface approval. Ask the owner before acting on low-star items or dispatching rework not already authorized. For a subsumed item, prove the current behavior and obtain the separate per-item closure decision; preserve the original PR when its work is being used.

Completion: selected scope, target, ownership and permitted actions are explicit.

2. Build the diagnostic board

Pin the approved live base and record the ordered PR heads. Use one owned branch and worktree under .claude/worktrees/, with active hooks and dependencies matching the candidate lockfile. Verify dependency identity instead of assuming a copy from the shared checkout is current. Do not install over shared hard links.

Board the selected refs and verify each is an ancestor of the combined head. Resolve overlaps without dropping sibling behavior or contributor attribution. Keep unrelated worktrees and the shared checkout untouched; never use git stash. Parallel preparation needs authorized delegation and disjoint write ownership.

Completion: the board has a recorded base, ordered heads, final SHA/tree and a scoped diff that contains every intended change and reconciliation.

3. Diagnose and repair

Run the applicable static profile and focused tests with their actual collectors. Keep stdout/stderr, exits, signals, versions and identities. These are PARTIAL evidence, not merge acceptance. Full workflow evidence can be supplied by the approved server queue; it need not be redundantly simulated for every local probe.

Compare a failed requirement on the exact pinned base under comparable runtime and installation before attributing it. Record resource/setup interruptions separately. Controlled repetitions may diagnose instability; a later PASS does not erase an earlier required FAIL. Preserve assertions, thresholds and baselines.

Apply every required conflict, i18n, documentation and code reconciliation to the candidate before its acceptance. Do not deliberately land a red tip and promise a follow-up after distributing the batch.

Completion: proven defects have scoped RED/GREEN evidence, and remaining failures or incomplete lanes have explicit dispositions without green-by-bypass.

4. Admit each actual landing

Use the shared merge gates for every selected PR/group. Resolve its current base, head, tested candidate and policy again. Require all applicable required lanes, including Gate / CI, Gate / Quality and requirements outside those aggregates. Draft skips, MERGEABLE, a green board, an old head and inherited failures are not acceptance. A changed identity returns the item to validation.

Use an approved server-enforced queue or reviewed identity-preserving protocol for each actual landing. gh pr merge --match-head-commit guards the head only; it does not atomically guard the base or replace missing required checks. If the tool cannot preserve the tested candidate or exclude a race, HOLD.

Merge only the owner-authorized item after protected-surface approval where applicable. Keep contributor fixes in their authorized branch; a locked fork needs the shared credit-preserving fallback, not a direct protected-branch push. Administrative bypass, trust approval and release/deploy authority are separate exceptional decisions, never inferred from a batch request or star rating.

Completion: the actual landed identity has current required evidence and the specific authority for that mutation, or the item remains prepared/HOLD.

5. Readback and handoff

Verify merged state, actual SHA/tree and contributor credit. Refresh and validate the resulting base before admitting the next landing. Report prepared, integrated and currently validated separately; a partially landed batch is not a full PASS.

Retain an ordered ledger of PRs, base/head/candidate/landing identities, checks, receipts, contributor attribution and holds in the owned private task artifacts. Close only separately authorized items and use the shared credit rules. Preserve evidence before safe teardown of worktrees created for this batch; never remove another session's work or leave the shared checkout on a different branch.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

cli-a2a

FreeSummary

Use the command line to send tasks to OmniRoute's A2A server, which supports communication between agents. Inspect execution history and logs, monitor or cancel tasks, and interactively test the JSON-RPC 2.0 communication protocol.

  • Check server status and available skills
  • Invoke a skill with JSON input
  • Inspect task history and logs
diegosouzapw/OmniRoute78.1KUpdated Oct 18, 2026

cli-backup-sync

FreeSummary

Back up and restore OmniRoute data from the command line. Manage incremental snapshots, scheduled backups, encryption, and cloud synchronization, with options to compare differences and preview data transfers or imports before applying them.

  • Create a backup before restoring data
  • Schedule recurring backups
  • Compare differences before cloud synchronization
diegosouzapw/OmniRoute78.1KUpdated Oct 18, 2026

cli-batches

FreeSummary

Submit groups of AI requests as batch jobs with the OmniRoute command line. Manage input files, monitor or cancel jobs, save results and errors, and incorporate batch processing into automated build and deployment workflows.

  • Submitting AI requests from a JSONL file
  • Monitoring batch jobs and waiting for completion
  • Saving batch results and error details
diegosouzapw/OmniRoute78.1KUpdated Oct 18, 2026

cli-chat

FreeSummary

Send prompts to LLMs from a terminal, display answers as they arrive, or hold an ongoing conversation. Use files or standard input for prompts, choose models, and set system instructions through OmniRoute.

  • Sending a prompt from a terminal
  • Using file contents as a prompt
  • Displaying and saving streaming responses
diegosouzapw/OmniRoute78.1KUpdated Oct 18, 2026

cli-compression

FreeSummary

Configure prompt compression, which shortens text sent to AI models, through the OmniRoute command line. Adjust RTK filters, Caveman rules, and combined compression modes, then preview the results using real prompts.

  • Preview compression results with real prompts
  • Adjust RTK filters and Caveman rules
  • Compare combined compression modes
diegosouzapw/OmniRoute78.1KUpdated Oct 18, 2026

cli-contexts

FreeSummary

Manage OmniRoute context settings from the command line, including token budgets and RTK filters for processing context. Switch saved server connections, import or export configurations, and inspect or expire conversation sessions.

  • Adjust context token budgets and filtering rules
  • Switch between saved server connections
  • Import or export connection settings as JSON
diegosouzapw/OmniRoute78.1KUpdated Oct 18, 2026

See all skills by diegosouzapw

Report a problem with this skill