mr-open

Opens a draft merge request with ticket context, reviewer comments, and a one-screen description.

15|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/fprochazka/claude-code-plugins --skill mr-open-fprochazka
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mr-open
Source: https://github.com/fprochazka/claude-code-plugins/tree/main/plugins/sdlc/skills/mr-open
Command: npx skills add https://github.com/fprochazka/claude-code-plugins --skill mr-open-fprochazka

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Opening a merge request often scatters context: the reasoning ends up in the description, review guidance gets lost, and release steps are never written down. This Skill opens a draft MR for the current branch and places each piece of information where it belongs — the Why in the ticket, discussion topics in separate MR comment threads, and a short summary in the description. ## Core Features & Use Cases - Structured MR creation: Pushes the branch, opens a draft MR/PR via the host's CLI (GitLab, GitHub), and reuses an existing MR if one is already open for the branch. - Content placement rules: Writes the problem and approach into the ticket, posts reviewer guidelines, release procedure, and verification results as standalone MR discussion threads, and keeps the description under a 12-line cap with just the ticket link and summary. - Reviewer guidance with diagrams: Highlights load-bearing diff sections with file:line pointers and can include a validated mermaid diagram for flows crossing multiple components. - Use Case: After finishing a feature branch, run the command with a ticket ID to open a draft GitLab MR whose description links the ticket, whose comments guide the reviewer through the diff, and whose release thread documents migration ordering. ## Quick Start Open a draft MR for my current branch with ticket PROJ-123, putting the reasoning in the ticket and a reviewer guide in the MR comments.

Frequently Asked Questions about mr-open

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I open a draft merge request from the command line?▼

Push the branch, then open the MR as a draft targeting the repository's base branch using the host's CLI, such as glab for GitLab. If an MR already exists for the branch, reuse its URL instead of creating a duplicate.

What should go in a merge request description?▼

Keep the description to one screen, roughly 12 lines: the ticket link on its own line, three to six sentences describing what the change does, and a link to the release procedure comment if one exists. Reasoning belongs in the ticket, not the description.

Does this work with GitHub pull requests or only GitLab?▼

It supports any remote host by loading the skill covering that host's CLI, including GitHub and GitLab. On GitLab it additionally uses the glab-discussion skill to post standalone MR discussion threads.

Why should reviewer guidance go in MR comments instead of the description?▼

Each topic — reading guide, release procedure, verification results — becomes its own top-level discussion thread, so reviewers can respond to one without entangling the others. The description stays a fifteen-second summary that helps reviewers decide where to start.

When should a mermaid diagram be added to an MR comment?▼

Add one diagram when the change crosses three or more components, involves a state machine, an ordering-sensitive interaction, or a before/after structural change. GitLab renders at most 2000 characters of mermaid per page, so one diagram is the budget.