GitLab merge request operations. ALWAYS use this skill when user wants to: (1) list merge requests, (2) view MR details, (3) create new MRs, (4) approve/merge MRs, (5) checkout MR branches, (6) add notes/comments, (7) rebase MRs.
npx claudepluginhub grandcamel/gitlab-assistant-skills --plugin gitlab-assistant-skillsThis skill is limited to using the following tools:
Merge request operations for GitLab using the `glab` CLI.
Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Merge request operations for GitLab using the glab CLI.
| Operation | Command | Risk |
|---|---|---|
| List MRs | glab mr list | - |
| View MR | glab mr view <id> | - |
| Create MR | glab mr create | ⚠️ |
| Checkout MR | glab mr checkout <id> | - |
| Approve MR | glab mr approve <id> | ⚠️ |
| Merge MR | glab mr merge <id> | ⚠️⚠️ |
| Update MR | glab mr update <id> | ⚠️ |
| Close MR | glab mr close <id> | ⚠️ |
| Reopen MR | glab mr reopen <id> | ⚠️ |
| Delete MR | glab mr delete <id> | ⚠️⚠️ |
| Rebase MR | glab mr rebase <id> | ⚠️ |
Risk Legend: - Safe | ⚠️ Caution | ⚠️⚠️ Warning | ⚠️⚠️⚠️ Danger
ALWAYS use when:
NEVER use when:
glab mr list [options]
Options:
| Flag | Description |
|---|---|
--assignee=@me | Filter by assignee (use @me for yourself) |
--reviewer=@me | Filter by reviewer |
--author=<username> | Filter by author |
--label=<labels> | Filter by comma-separated labels |
--state=<state> | Filter by state: opened, closed, merged, all |
--source-branch=<branch> | Filter by source branch |
--target-branch=<branch> | Filter by target branch |
-P, --per-page=<n> | Number of items per page |
Examples:
# List MRs assigned to you
glab mr list --assignee=@me
# List review requests for you
glab mr list --reviewer=@me
# List open MRs with specific label
glab mr list --state=opened --label=bug
# List MRs targeting main branch
glab mr list --target-branch=main
glab mr view <id> [options]
Options:
| Flag | Description |
|---|---|
-w, --web | Open MR in browser |
-c, --comments | Show MR comments and notes |
-s, --system-logs | Show system activities/logs |
Examples:
# View MR details in terminal
glab mr view 123
# Open MR in browser
glab mr view 123 --web
# View MR with comments
glab mr view 123 --comments
glab mr create [options]
Options:
| Flag | Description |
|---|---|
-t, --title=<title> | MR title |
-d, --description=<desc> | MR description |
-b, --target-branch=<branch> | Target branch (default: default branch) |
-f, --fill | Use commit messages for title/description |
--draft | Create as draft MR |
-a, --assignee=<users> | Comma-separated assignees |
-r, --reviewer=<users> | Comma-separated reviewers |
-l, --label=<labels> | Comma-separated labels |
-m, --milestone=<milestone> | Milestone title |
--squash-on-merge | Squash commits on merge |
--remove-source-branch | Remove source branch on merge |
-w, --web | Open created MR in browser |
-y, --yes | Skip confirmation prompts |
Examples:
# Create MR with title and description
glab mr create -t "Add new feature" -d "This MR adds..."
# Create MR from commit messages
glab mr create --fill
# Create draft MR
glab mr create --draft -t "WIP: New feature"
# Create MR with reviewers and labels
glab mr create -t "Fix bug" -r "reviewer1,reviewer2" -l "bug,urgent"
# Create MR and open in browser
glab mr create -t "Feature" --web
glab mr checkout <id> [options]
Shortcut: glab co <id>
Options:
| Flag | Description |
|---|---|
-b, --branch=<name> | Local branch name |
-t, --track | Set up tracking for the remote branch |
Examples:
# Checkout MR branch
glab mr checkout 123
# Checkout with custom local branch name
glab mr checkout 123 -b my-local-branch
# Shortcut
glab co 123
# Approve MR
glab mr approve <id>
# Revoke approval
glab mr revoke <id>
# View approvers
glab mr approvers <id>
# Merge MR
glab mr merge <id> [options]
# Close MR
glab mr close <id>
# Reopen closed MR
glab mr reopen <id>
Merge Options:
| Flag | Description |
|---|---|
-s, --squash | Squash commits |
-d, --remove-source-branch | Delete source branch after merge |
--when-pipeline-succeeds | Merge when pipeline succeeds |
-m, --message=<msg> | Custom merge commit message |
-y, --yes | Skip confirmation |
Examples:
# Merge with squash
glab mr merge 123 --squash
# Merge and delete source branch
glab mr merge 123 --remove-source-branch
# Auto-merge when pipeline succeeds
glab mr merge 123 --when-pipeline-succeeds
glab mr update <id> [options]
Options:
| Flag | Description |
|---|---|
-t, --title=<title> | Update title |
-d, --description=<desc> | Update description |
-a, --assignee=<users> | Update assignees |
-r, --reviewer=<users> | Update reviewers |
-l, --label=<labels> | Update labels |
--unlabel=<labels> | Remove labels |
--draft | Mark as draft |
--ready | Mark as ready (remove draft status) |
--lock-discussion | Lock discussion |
--unlock-discussion | Unlock discussion |
Examples:
# Update title
glab mr update 123 -t "New title"
# Add reviewers
glab mr update 123 -r "user1,user2"
# Mark as ready (remove draft)
glab mr update 123 --ready
# Add and remove labels
glab mr update 123 -l "approved" --unlabel "needs-review"
glab mr note <id> -m "<message>"
Examples:
# Add comment
glab mr note 123 -m "LGTM!"
# Add closing note
glab mr note 123 -m "Closing because !456 supersedes this"
glab mr rebase <id>
glab mr diff <id> [options]
Options:
| Flag | Description |
|---|---|
--color=<when> | When to show color: always, never, auto |
# Subscribe to MR notifications
glab mr subscribe <id>
# Unsubscribe
glab mr unsubscribe <id>
glab mr todo <id>
# 1. List MRs assigned for review
glab mr list --reviewer=@me
# 2. View MR details
glab mr view 123
# 3. Checkout to test locally
glab mr checkout 123
# 4. Run tests, review code...
# 5. Approve if good
glab mr approve 123
# 6. Add comment
glab mr note 123 -m "Reviewed and approved. Great work!"
# 1. Create branch and make changes
git checkout -b feature/my-feature
# 2. Commit changes
git add . && git commit -m "Add new feature"
# 3. Push branch
git push -u origin feature/my-feature
# 4. Create MR
glab mr create -t "Add new feature" -d "Description..." --draft
# 5. Mark ready when done
glab mr update <id> --ready
# Create MR from current branch with commit info
glab mr create --fill --yes
| Issue | Cause | Solution |
|---|---|---|
| Authentication failed | Invalid/expired token | Run glab auth login |
| MR not found | Invalid ID or no access | Verify ID with glab mr list |
| Permission denied | Insufficient rights | Check project permissions |
| Cannot merge | Conflicts or pipeline failed | Resolve conflicts, wait for pipeline |
| Branch not found | Source branch deleted | Check if branch exists |