# Gitlab Jobs

> Manages GitLab CI jobs. Use for listing, logs, canceling, retrying, or erasing jobs. Triggers: CI builds, job status.

- Skill: `diegosouzapw/gitlab-jobs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/gitlab-jobs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/gitlab-jobs/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/gitlab-jobs

---


### Overview
Covers job execution and logs.

### Available Tools
- `get_project_jobs`: Retrieve a list of jobs for a specific GitLab project, optionally filtered by scope or a single job by id.
  - **Parameters**:
    - `project_id` (str): Optional. - Project ID or path
    - `job_id` (Optional[int]): Optional. - Job ID
    - `scope` (Optional[str]): Optional. - Filter jobs by scope (e.g., 'success', 'failed')
    - `include_retried` (Optional[bool]): Optional. - Include retried jobs
    - `include_invisible` (Optional[bool]): Optional. - Include invisible jobs (e.g., from hidden pipelines)
- `get_project_job_log`: Retrieve the log (trace) of a specific job in a GitLab project.
  - **Parameters**:
    - `project_id` (str): Optional. - Project ID or path
    - `job_id` (int): Optional. - Job ID
- `cancel_project_job`: Cancel a specific job in a GitLab project.
  - **Parameters**:
    - `project_id` (str): Optional. - Project ID or path
    - `job_id` (int): Optional. - Job ID
    - `ctx` (Optional[Context]): Optional. - MCP context for progress
- `retry_project_job`: Retry a specific job in a GitLab project.
  - **Parameters**:
    - `project_id` (str): Optional. - Project ID or path
    - `job_id` (int): Optional. - Job ID
    - `ctx` (Optional[Context]): Optional. - MCP context for progress
- `erase_project_job`: Erase (delete artifacts and logs of) a specific job in a GitLab project.
  - **Parameters**:
    - `project_id` (str): Optional. - Project ID or path
    - `job_id` (int): Optional. - Job ID
    - `ctx` (Optional[Context]): Optional. - MCP context for progress
- `run_project_job`: Run (play) a specific manual job in a GitLab project.
  - **Parameters**:
    - `project_id` (str): Optional. - Project ID or path
    - `job_id` (int): Optional. - Job ID
    - `ctx` (Optional[Context]): Optional. - MCP context for progress
- `get_pipeline_jobs`: Retrieve a list of jobs for a specific pipeline in a GitLab project, optionally filtered by scope.
  - **Parameters**:
    - `project_id` (str): Optional. - Project ID or path
    - `pipeline_id` (int): Optional. - Pipeline ID
    - `scope` (Optional[str]): Optional. - Filter jobs by scope (e.g., 'success', 'failed')

### Usage Instructions
1. Use job_id for actions.
2. Filters: scope, status.

### Examples
- Get log: `get_project_job_log` with project_id="123", job_id=456.
- Retry: `retry_project_job` with project_id="123", job_id=456.

### Error Handling
- Job not found: Verify IDs.