# Git Workflowmerge

> Merge git branches with auto-generated Conventional Commits messages. Use when merging branches, finishing feature work, or creating merge commits. Use when this capability is needed.

- Skill: `tomevault-io/git-workflowmerge` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/git-workflowmerge`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/git-workflowmerge/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/git-workflowmerge

---


# Git Merge

Merge branches with auto-generated Conventional Commits messages.

## Usage

```
$merge                              # Merge current branch into develop/main
$merge feature/auth                 # Merge specific source branch
$merge develop main                 # Merge develop into main
$merge -i "#123" -s auth-flow       # With issue and spec references
$merge --yes                        # Skip confirmation
$merge --all                        # Merge across all sub-repos
```

## Options

| Flag | Description |
|------|-------------|
| `-i, --issue <id>` | Issue ID for commit message |
| `-s, --spec <name>` | Spec name for commit message |
| `--all` | Merge across all git repos in subdirectories |
| `-y, --yes` | Skip confirmation prompt |

## Process

1. Detect source and target branches
2. Dispatch the merge agent using the prompt template in `merge.md` (in this skill directory)
3. Generate Conventional Commits message from commit history
4. Execute merge via git plumbing (checkout-free, worktree-safe)

## Agent Dispatch

Use the companion `merge.md` in this directory as the agent prompt. Provide it with:
- Source and target branches
- Issue and spec references (if any)
- Flags (--all, --yes)
- The current working directory

---
> Source: [shdennlin/agent-plugins](https://github.com/shdennlin/agent-plugins) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->