# Gitlab

> GitLab

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

---

# GitLab

## Overview
GitLab REST API v4 — code hosting and DevOps platform (developer tools archetype).

## Workflows

### Explore a project's CI/CD status
1. `searchProjects(search)` → pick project → `projectId`
2. `getProject(projectId)` → confirm project details
3. `listProjectPipelines(projectId)` → pipeline statuses
4. `listProjectBranches(projectId)` → active branches

### Review project issues and merge requests
1. `searchProjects(search)` → `projectId`
2. `listProjectIssues(projectId, state)` → open/closed issues
3. `listProjectMergeRequests(projectId, state)` → open/merged MRs

### File an issue and discuss
1. `searchProjects(search)` → `projectId`
2. `createIssue(projectId, title, description)` → new issue → `iid`
3. `createComment(projectId, issueIid, body)` → add discussion → `noteId`
4. `closeIssue(projectId, issueIid)` → close when resolved
5. `deleteComment(projectId, issueIid, noteId)` → remove a comment

### Star / unstar a project
1. `searchProjects(search)` → `projectId`
2. `starProject(projectId)` → starred
3. `unstarProject(projectId)` → unstarred (reverse of starProject)

### Browse group projects
1. `searchGroups(search)` → pick group → `groupId`
2. `getGroup(groupId)` → group details
3. `listGroupProjects(groupId)` → projects in the group → `projectId`
4. `getProject(projectId)` → full project detail

### Read a file from a repository
1. `searchProjects(search)` → `projectId`
2. `listProjectBranches(projectId)` → pick branch → `ref`
3. `getProjectFile(projectId, filePath, ref)` → base64 content + metadata

## Operations

| Operation | Intent | Key Input | Key Output | Notes |
|-----------|--------|-----------|------------|-------|
| searchProjects | search projects | search, order_by | id, name, path_with_namespace, star_count | entry point |
| getProject | project detail | projectId ← searchProjects | name, description, star_count, forks_count, default_branch | |
| listProjectIssues | list issues | projectId ← searchProjects, state | iid, title, state, labels | paginated |
| listProjectMergeRequests | list MRs | projectId ← searchProjects, state | iid, title, state, source_branch, target_branch | paginated |
| listProjectPipelines | list pipelines | projectId ← searchProjects | id, status, ref, sha | paginated |
| listProjectBranches | list branches | projectId ← searchProjects, search | name, merged, protected, default | paginated |
| getProjectFile | file metadata + content | projectId ← searchProjects, filePath, ref ← listProjectBranches | file_name, size, content (base64) | |
| searchUsers | search users | search or username | id, username, name, state | entry point |
| starProject | star a project | projectId ← searchProjects | star_count | write, SAFE |
| unstarProject | unstar a project | projectId ← searchProjects | star_count | write, SAFE |
| searchGroups | search groups | search | id, name, path, visibility | entry point |
| getGroup | group detail | groupId ← searchGroups | name, description, visibility, full_path | |
| listGroupProjects | group's projects | groupId ← searchGroups | id, name, path_with_namespace, star_count | paginated |
| createIssue | create issue | projectId ← searchProjects, title, description | iid, title, state, web_url | write, CAUTION |
| closeIssue | close issue | projectId ← searchProjects, issueIid ← listProjectIssues | iid, title, state | write, CAUTION |
| createComment | comment on issue | projectId, issueIid ← listProjectIssues, body | id, body, author | write, CAUTION |
| deleteComment | delete comment | projectId, issueIid, noteId ← createComment | (no content) | write, CAUTION |

## Quick Start

```bash
# Search projects
openweb gitlab exec searchProjects '{"search": "kubernetes", "per_page": 5}'

# Get project detail
openweb gitlab exec getProject '{"projectId": 278964}'

# List open issues for a project
openweb gitlab exec listProjectIssues '{"projectId": 278964, "state": "opened", "per_page": 10}'

# List merge requests
openweb gitlab exec listProjectMergeRequests '{"projectId": 278964, "state": "merged", "per_page": 5}'

# List CI/CD pipelines
openweb gitlab exec listProjectPipelines '{"projectId": 278964, "per_page": 5}'

# Search users
openweb gitlab exec searchUsers '{"search": "gitlab-bot", "per_page": 5}'

# Get group detail and list their projects
openweb gitlab exec getGroup '{"groupId": 9970}'
openweb gitlab exec listGroupProjects '{"groupId": 9970, "per_page": 5}'

# Get a file from a repository (returns base64 content)
openweb gitlab exec getProjectFile '{"projectId": 278964, "filePath": "README.md", "ref": "master"}'

# Create an issue
openweb gitlab exec createIssue '{"projectId": 81206763, "title": "Bug report", "description": "Steps to reproduce..."}'

# Close an issue
openweb gitlab exec closeIssue '{"projectId": 81206763, "issueIid": 1}'

# Comment on an issue
openweb gitlab exec createComment '{"projectId": 81206763, "issueIid": 1, "body": "Confirmed on my end"}'

# Delete a comment
openweb gitlab exec deleteComment '{"projectId": 81206763, "issueIid": 1, "noteId": 12345}'
```