gitlab:create-mr - Create a new merge request in a GitLab project
Synopsis
/create-mr [arguments]
Description
Create a new merge request in a GitLab project
Implementation
Create a new merge request in a GitLab project with source and target branches.
Usage
/create-mr
This command helps you create a merge request with all necessary details.
What This Command Does
Asks for the project ID or path
Prompts for source branch name
Requests target branch name
Asks for MR title
Requests MR description (optional)
Creates the merge request using the GitLab MCP create_merge_request tool
Returns the MR number and URL
Prerequisites
GitLab MCP server must be installed and configured
GitLab version 18.5 or later
You must have Developer or higher role in the project
Both source and target branches must exist
OAuth authentication must be completed
Example Interaction
User: /create-mr
Claude: I'll help you create a merge request. What's the project ID or path?
User: 456
Claude: What's the source branch name?
User: feature/user-authentication
Claude: What's the target branch name?
User: main
Claude: What should the merge request title be?
User: Add JWT-based user authentication
Claude: Please provide a description (optional, press Enter to skip):
User: This MR implements JWT-based authentication for the API:
- User login and registration endpoints
- Token generation and validation middleware
- Password hashing with bcrypt
- Unit tests for auth flows
Closes #42
Claude: Creating merge request in project 456...
✓ Merge request created successfully!
!15 - Add JWT-based user authentication
https://gitlab.com/your-org/project/-/merge_requests/15
Status: Open
Source: feature/user-authentication
Target: main
Tips
Link related issues using Closes #123 or Fixes #123 in the description
Use conventional commit prefixes in titles: feat:, fix:, refactor:
Include a testing checklist in the description
Add reviewers after creation if needed
Set appropriate labels for categorization
Consider creating a draft MR for work-in-progress
Related Commands
/view-mr: View merge request details and diffs
/review-mr: Get a comprehensive review of a merge request
/create-issue: Create an issue that this MR will resolve
1---2name: create-mr3description: Create a new merge request in a GitLab project4---56# Create GitLab Merge Request
78## Name
910gitlab:create-mr - Create a new merge request in a GitLab project
1112## Synopsis
1314```
15/create-mr [arguments]
16```
1718## Description
1920Create a new merge request in a GitLab project
2122## Implementation
2324Create a new merge request in a GitLab project with source and target branches.
2526## Usage
2728```
29/create-mr
30```
3132This command helps you create a merge request with all necessary details.
3334## What This Command Does
35361. Asks for the project ID or path
372. Prompts for source branch name
383. Requests target branch name
394. Asks for MR title
405. Requests MR description (optional)
416. Creates the merge request using the GitLab MCP `create_merge_request` tool
427. Returns the MR number and URL
4344## Prerequisites
4546- GitLab MCP server must be installed and configured
47- GitLab version 18.5 or later
48- You must have Developer or higher role in the project
49- Both source and target branches must exist
50- OAuth authentication must be completed
5152## Example Interaction
5354```
55User: /create-mr
5657Claude: I'll help you create a merge request. What's the project ID or path?
5859User: 456
6061Claude: What's the source branch name?
6263User: feature/user-authentication
6465Claude: What's the target branch name?
6667User: main
6869Claude: What should the merge request title be?
7071User: Add JWT-based user authentication
7273Claude: Please provide a description (optional, press Enter to skip):
7475User: This MR implements JWT-based authentication for the API:
76- User login and registration endpoints
77- Token generation and validation middleware
78- Password hashing with bcrypt
79- Unit tests for auth flows
8081Closes #42
8283Claude: Creating merge request in project 456...
8485✓ Merge request created successfully!
86 !15 - Add JWT-based user authentication
87 https://gitlab.com/your-org/project/-/merge_requests/15
8889 Status: Open
90 Source: feature/user-authentication
91 Target: main
92```
9394## Tips
9596- Link related issues using `Closes #123` or `Fixes #123` in the description
97- Use conventional commit prefixes in titles: `feat:`, `fix:`, `refactor:`
98- Include a testing checklist in the description
99- Add reviewers after creation if needed
100- Set appropriate labels for categorization
101- Consider creating a draft MR for work-in-progress
102103## Related Commands
104105- `/view-mr`: View merge request details and diffs
106- `/review-mr`: Get a comprehensive review of a merge request
107- `/create-issue`: Create an issue that this MR will resolve
Run npx skillmds add thebushidocollective/create-mr in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Create a new merge request in a GitLab project It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
thebushidocollective (@thebushidocollective) published this skill. Their other Agent Skills are listed on their SkillMD profile.
thebushidocollective