# Gitlab Create Mr

> Create a GitLab Merge Request for the current story branch. Use when the user says 'create an MR', 'open a merge request', or 'ready for review' in a GitLab project.

- Skill: `gabrielmoreira/gitlab-create-mr` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/gitlab-create-mr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/gitlab-create-mr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/gitlab-create-mr

---


# GitLab — Create Merge Request

## Goal

Create a well-structured GitLab Merge Request that links to the issue, summarises the story, lists verified acceptance criteria, and assigns the correct reviewer.

---

## Prerequisite Check

Check `integrations.gitlab` in `_superml/config.yml`. If missing: "Run `gitlab-connect` first."

Check current branch:
```bash
git branch --show-current
```

Ensure it's a feature branch (not `main` or `develop`).

---

## Step 1: Load Story Context

Extract from current branch name or ask:
- GitLab issue number: `{issue_id}` (if tracked)
- Story S-ID: `{S-ID}`

Load story file from `{implementation_artifacts}/stories/S-{id}-*.md`.

---

## Step 2: Pre-MR Checks

```bash
git status
git log origin/{default_branch}..HEAD --oneline
```

Warn if there are uncommitted changes or no commits ahead of default branch.

---

## Step 3: Build MR Description

```markdown
## Summary
{story_title}

Closes #{issue_id}

## What changed
{brief_description}

## Acceptance Criteria Verified
- [x] AC-1: {description}
- [x] AC-2: {description}

## Test Notes
{testing_approach}

## Screenshots / Evidence
{if_applicable}
```

---

## Step 4: Create Merge Request

```bash
glab mr create \
  --title "{story_title}" \
  --description "{mr_description}" \
  --source-branch "{feature_branch}" \
  --target-branch "{default_branch}" \
  --assignee "{your_username}" \
  --no-editor
```

Or via API:
```bash
glab api -X POST "projects/:fullpath/merge_requests" \
  -F "source_branch={feature_branch}" \
  -F "target_branch={default_branch}" \
  -F "title={story_title}" \
  -F "description={mr_description}" \
  -F "remove_source_branch=true"
```

---

## Step 5: Update Story File

```yaml
gitlab_mr_id: {mr_id}
gitlab_mr_url: "{mr_url}"
```

---

## Done

> ✅ MR created: {mr_url}
>
> Assign reviewers and set the ready-for-review label before requesting review.