Gitlab Skills
GitLab projects, MRs, and CI/CD operations
Rank
62
Safety
84
Downloads
2.6k
Updated
Oct 9, 2026
Version
0.1.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2.6K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 2.6K downloadsadoption · observed Oct 9, 2026
- Latest release
- 0.1.1release · observed Oct 8, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s178r18ph3sn297gb4d96zefvx88583r:gitlab-devops-skill- Install using `clawhub skill install s178r18ph3sn297gb4d96zefvx88583r:gitlab-devops-skill` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/weiguang1017/gitlab-devops-skill before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-gitlab-devops-skill/snapshot"
Documentation
CLAWHUB
27,713 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: gitlab-skills description: Manage GitLab projects from the command line — list/inspect projects, list and create issues, list/create/merge merge requests, and list or trigger CI/CD pipelines. Use whenever the user wants to work with a GitLab repo, file an issue, open or merge an MR, or kick off / check a pipeline on GitLab.com or a self-hosted GitLab. 中文触发场景:查 GitLab 项目、建 issue、开/合并 MR、查流水线、触发流水线、看流水线是否通过。 --- # GitLab 技能(命令行实操) 通过 GitLab REST API v4 操作项目,入口是单一自包含的 Python CLI:`scripts/gitlab_cli.py`。 兼容 GitLab.com SaaS 与私有化部署实例。License: MIT。 ## 何时使用 用户提出以下需求时调用本技能: - 查找或查看项目("列一下我的项目""看 group/app 的详情") - 列出或创建 issue - 列出、创建、合并 MR(合并请求) - 列出或触发 CI/CD 流水线("在 main 上跑一次流水线""流水线绿了吗") ## 环境配置(首次) 连接信息从环境变量读取,或放在配置文件 `~/.devops-skills/gitlab.json`。 **禁止把 token 直接写在命令行参数里。** ```bash export GITLAB_URL="https://gitlab.com" # 私有化部署填自己的地址 export GITLAB_TOKEN="<access-token>" # 需要 api 权限 ``` Token 创建位置:User Settings → Access Tokens(勾选 `api`)。 ## 运行方式 脚本依赖 `requests`。本机受管 Python 环境已安装(requests 2.34.2),**推荐直接用绝对路径调用**, 避免默认的 `python3` 缺少依赖而失败: ```bash PY=~/.workbuddy/binaries/python/envs/default/bin/python # 若报 Missing dependency,用同一个解释器装: # $PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/ ``` 项目参数可以是数字 ID,也可以是 `group/subgroup/project` 路径(脚本自动做 URL 编码)。 ```bash $PY scripts/gitlab_cli.py list-projects --search app $PY scripts/gitlab_cli.py get-project group/app $PY scripts/gitlab_cli.py list-issues group/app --state opened $PY scripts/gitlab_cli.py create-issue group/app --title "Bug" --description "..." $PY scripts/gitlab_cli.py list-mrs group/app --state opened $PY scripts/gitlab_cli.py create-mr group/app --source feat --target main --title "Add feature" $PY scripts/gitlab_cli.py merge-mr group/app 42 $PY scripts/gitlab_cli.py list-pipelines group/app --ref main $PY scripts/gitlab_cli.py trigger-pipeline group/app --ref main ``` 所有命令把 JSON 打到 stdout,失败时以非零退出码结束。 ## 兼容性 - GitLab.com - 私有化 GitLab 9.0+(REST API v4) 执行命令前会先请求 `/api/v4/version` 做版本校验,检测到低于 9.0 会输出明确的兼容性提示并退出。 确需绕过时可设 `GITLAB_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。 ## 注意事项 - `merge-mr` 要求 MR 处于可合并状态(审批规则、流水线状态都会影响)。 - 触发流水线要求项目里存在 `.gitlab-ci.yml`。 - 写操作(建 issue、建 MR、合并、触发流水线)属于 🟡 级变更,执行前跟用户确认目标项目与分支。 ## 详细文档 完整的配置方式、字段说明与排错见 `references/USAGE.md`。 ## 联系与支持 GitLab、CI/CD、DevOps 平台或研发效能问题需要人工支持时联系: 📧 [email protected] | 🌐 https://www.restartx.top
README.md
# GitLab DevOps Skill [English](#english) | [中文](#chinese) <a id="english"></a> ## English Manage GitLab projects, issues, merge requests, and CI/CD pipelines through the GitLab REST API v4. The CLI supports project discovery, controlled write operations, MR creation and merge, pipeline inspection, and pipeline triggers. ### Compatibility - GitLab.com - Self-managed GitLab 9.0+ with REST API v4 - Python 3.8+ and `requests` The CLI calls `/api/v4/version` before normal commands. A self-managed GitLab version below 9.0 fails with a clear compatibility error. Do not bypass this guard unless the target API has been independently verified. ### Quick Start ```bash pip install requests export GITLAB_URL="https://gitlab.example.com" export GITLAB_TOKEN="<access-token>" python scripts/gitlab_cli.py get-project group/project python scripts/gitlab_cli.py list-pipelines group/project --ref main ``` Use `~/.devops-skills/gitlab.json` as an alternative local configuration file. Keep tokens outside version control and protect the file with permissions `600`. ### Common Commands | Task | Command | | --- | --- | | List projects | `python scripts/gitlab_cli.py list-projects --search app` | | Read a project | `python scripts/gitlab_cli.py get-project group/project` | | List issues | `python scripts/gitlab_cli.py list-issues group/project --state opened` | | Create an issue | `python scripts/gitlab_cli.py create-issue group/project --title "Bug"` | | Create an MR | `python scripts/gitlab_cli.py create-mr group/project --source feature --target main --title "Add feature"` | | Merge an MR | `python scripts/gitlab_cli.py merge-mr group/project 42` | | Trigger a pipeline | `python scripts/gitlab_cli.py trigger-pipeline group/project --ref main` | ### Permissions and Safety Use `read_api` or a project-scoped read token for read-only work. Grant `api` scope and only the required project role for writes. This skill does not need instance administrator access. Merges and pipeline triggers remain subject to GitLab approvals, protected branches, and pipeline rules. ### Documentation and Support - Agent instructions: [SKILL.md](./SKILL.md) - Detailed Chinese manual: [使用手册.md](./使用手册.md) - Support: https://service.restartx.top/ RestartX provides technical support and implementation services for GitLab, CI/CD, DevOps platform, and engineering-efficiency needs. <a id="chinese"></a> ## 中文 通过 GitLab REST API v4 管理项目、Issue、Merge Request 和 CI/CD Pipeline。CLI 支持项目 查询、受控写操作、创建和合并 MR、查询 Pipeline 以及触发流水线。 ### 兼容性 - GitLab.com - 使用 REST API v4 的自建 GitLab 9.0+ - Python 3.8+ 与 `requests` 脚本会在正常执行前调用 `/api/v4/version`。自建 GitLab 低于 9.0 时会给出明确的不兼容错误; 除非已独立确认目标 API 兼容,否则不要跳过该检查。 ### 快速开始 ```bash pip install requests export GITLAB_URL="https://gitlab.example.com" export GITLAB_TOKEN="<access-token>" python scripts/gitlab_cli.py get-project group/project python scripts/gitlab_cli.py list-pipelines group/project --ref main ``` 也可使用本地配置文件 `~/.devops-skills/gitlab.json`。令牌不
_meta.json
{
"ownerId": "kn7abv05p1jqkcnmnmkdpdex9581nt3f",
"slug": "gitlab-devops-skill",
"version": "0.1.1",
"publishedAt": 1791447078784
}references/USAGE.md
# GitLab Skills 配置与使用手册
通过一个 Python CLI 操作 GitLab(SaaS 或自建均可),覆盖项目、Issue、Merge Request、CI/CD Pipeline。
---
## 一、环境要求
- Python 3.8 及以上
- `pip install requests`
- GitLab.com,或自建 GitLab 9.0 及以上(REST API v4)
脚本会在执行命令前调用 `/api/v4/version` 检测 GitLab 版本;若自建 GitLab
低于 9.0,会给出明确的不兼容提示。确需跳过检查时,可设置
`GITLAB_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。
---
## 二、获取访问令牌(Access Token)
1. 登录 GitLab → 右上角头像 → **Preferences / Settings**。
2. 左侧 **Access Tokens**(个人令牌)。也可用项目级 / 群组级令牌。
3. 勾选 **api** 作用域 → 创建并复制 token(只显示一次)。
---
## 三、配置连接信息(二选一)
### 方式 A:环境变量
```bash
export GITLAB_URL="https://gitlab.com" # 自建则填你的地址
export GITLAB_TOKEN="你的token"
```
### 方式 B:配置文件 `~/.devops-skills/gitlab.json`
```json
{
"url": "https://gitlab.com",
"token": "你的token"
}
```
> `chmod 600 ~/.devops-skills/gitlab.json`,不要把 token 提交到仓库。
---
## 四、命令速查
> 项目参数 `project` 支持**数字 ID** 或**路径** `group/subgroup/project`(脚本自动转义)。
| 功能 | 命令 |
| --- | --- |
| 列出我的项目 | `python scripts/gitlab_cli.py list-projects --search app` |
| 查看项目详情 | `python scripts/gitlab_cli.py get-project group/app` |
| 列出 Issue | `python scripts/gitlab_cli.py list-issues group/app --state opened` |
| 创建 Issue | `python scripts/gitlab_cli.py create-issue group/app --title "标题" --description "描述"` |
| 列出 MR | `python scripts/gitlab_cli.py list-mrs group/app --state opened` |
| 创建 MR | `python scripts/gitlab_cli.py create-mr group/app --source feat --target main --title "标题"` |
| 合并 MR | `python scripts/gitlab_cli.py merge-mr group/app 42` |
| 列出 Pipeline | `python scripts/gitlab_cli.py list-pipelines group/app --ref main` |
| 触发 Pipeline | `python scripts/gitlab_cli.py trigger-pipeline group/app --ref main` |
---
## 五、使用示例
**1. 提交一个新分支的 MR 并合并**
```bash
python scripts/gitlab_cli.py create-mr group/app \
--source feature/login --target main --title "新增登录功能"
# 记下返回的 iid,例如 42
python scripts/gitlab_cli.py merge-mr group/app 42
```
**2. 在 main 分支触发流水线并查看状态**
```bash
python scripts/gitlab_cli.py trigger-pipeline group/app --ref main
python scripts/gitlab_cli.py list-pipelines group/app --ref main
```
---
## 六、常见问题
| 现象 | 原因与解决 |
| --- | --- |
| `GITLAB_TOKEN is required` | 未配置 token |
| `HTTP 401` | token 失效或作用域不含 `api` |
| `HTTP 403` | 账号对该项目无权限 |
| `HTTP 404`(用路径时) | 路径拼写错误,或用数字 ID 再试 |
| `unsupported GitLab version ...` | GitLab 版本低于 9.0,不满足 REST API v4 兼容范围 |
| `merge-mr` 失败 | MR 未达可合并状态(待审批、流水线未过、有冲突) |
| 触发 pipeline 无效 | 项目缺少 `.gitlab-ci.yml` |
---
## 七、在 Claude / Claude Code 中使用
把 `gitlab-skills` 目录放入 skills 目录后,用自然语言触发:
- “看下 group/app 有哪些打开的 MR”
- “从 feature/login 向 main 提一个 MR”
- “在 main 上跑一次流水线”
---
## 八、技术支持与咨询
如果在 GitLab、CI/CD、代码协作、DevOps 平台或研发效能建设中遇到问题,欢迎联系
RestartX 获取支持与方案咨询:https://service.restartx.top/skill-card.md
## Description: Helps agents inspect GitLab projects, issues, merge requests, and pipelines, and perform requested GitLab write operations. This skill is ready for commercial/non-commercial use. ## Publisher: [weiguang1017](https://clawhub.ai/user/weiguang1017) ### License/Terms of Use: MIT ## Use Case: Developers and DevOps engineers use this skill to inspect GitLab projects, issues, merge requests, and CI/CD pipelines, and to create issues or merge requests, merge changes, or start pipelines when authorized. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: A GitLab token with write access can enable consequential repository changes without an enforced confirmation gate. Mitigation: Prefer project-scoped or read-only tokens where possible; require explicit human confirmation before creating issues or merge requests, merging, or triggering pipelines, and keep protected-branch and approval rules enabled. ## Reference(s): - [GitLab Skills usage guide](references/USAGE.md) - [Release source repository](https://github.com/weiguang1017/gitlab-devops-skill) - [ClawHub skill release](https://clawhub.ai/weiguang1017/skills/gitlab-devops-skill) ## Skill Output: **Output Type(s):** [Guidance, Shell commands, JSON] **Output Format:** [Text guidance and commands; GitLab CLI responses in JSON] **Output Parameters:** [1D] **Other Properties Related to Output:** [GitLab command failures return a non-zero exit status.] ## Skill Version(s): 0.1.1 (source: ClawHub release metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/weiguang1017/skills/gitlab-devops-skill",
"sourceUrl": "https://clawhub.ai/weiguang1017/skills/gitlab-devops-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T13:37:52.465Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-gitlab-devops-skill/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-gitlab-devops-skill/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T13:37:52.465Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2.6K downloads",
"href": "https://clawhub.ai/weiguang1017/gitlab-devops-skill",
"sourceUrl": "https://clawhub.ai/weiguang1017/gitlab-devops-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T13:37:52.465Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.1",
"href": "https://clawhub.ai/weiguang1017/gitlab-devops-skill",
"sourceUrl": "https://clawhub.ai/weiguang1017/gitlab-devops-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-08T08:11:18.784Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-gitlab-devops-skill/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-gitlab-devops-skill/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.1",
"description": "- Significant update with localization: SKILL.md is now fully rewritten in Chinese, expanding usage details and clarifying best practices for local environments. - Old auxiliary files (agents, scripts, skill-card.md, 使用手册.md) have been removed for cleaner structure. - A separate usage reference (references/USAGE.md) has been added for detailed configuration and troubleshooting documentation. - Stronger emphasis on secure token management and recommended Python interpreter usage. - Explicit warnings about write operations (issue/MR creation, merges, pipeline triggers) are added to require user confirmation.",
"href": "https://clawhub.ai/weiguang1017/gitlab-devops-skill",
"sourceUrl": "https://clawhub.ai/weiguang1017/gitlab-devops-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-08T08:11:18.784Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
