Claude-skill-registry gitlab-runners

Name: gitlab-runners
Author: majiayu000

Manages GitLab runners. Use for registering, updating, deleting runners at various levels. Triggers: CI infrastructure.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/gitlab-runners" ~/.claude/skills/majiayu000-claude-skill-registry-gitlab-runners && rm -rf "$T"

manifest: skills/data/gitlab-runners/SKILL.md

source content

Overview

Covers runner setup.

Available Tools

```
get_runners
```
: Retrieve a list of runners in GitLab, optionally filtered by scope, type, status, or tags or Retrieve details of a specific GitLab runner..
- Parameters:
  - ```
  runner_id
```
  (Optional[int]): Optional. - ID of the runner to retrieve
- ```
scope
```
    (Optional[str]): Optional. - Filter runners by scope (e.g., 'active')
  - ```
  type
```
  (Optional[str]): Optional. - Filter runners by type (e.g., 'instance_type')
- ```
status
```
    (Optional[str]): Optional. - Filter runners by status (e.g., 'online')
  - ```
  tag_list
```
  (Optional[List[str]]): Optional. - Filter runners by tags
```
update_runner_details
```
: Update details for a specific GitLab runner.
- Parameters:
  - ```
  runner_id
```
  (int): Optional. - ID of the runner to update
- ```
description
```
    (Optional[str]): Optional. - New description of the runner
  - ```
  active
```
  (Optional[bool]): Optional. - Whether the runner is active
- ```
tag_list
```
    (Optional[List[str]]): Optional. - List of tags for the runner
  - ```
  run_untagged
```
  (Optional[bool]): Optional. - Whether the runner can run untagged jobs
- ```
locked
```
    (Optional[bool]): Optional. - Whether the runner is locked
  - ```
  access_level
```
  (Optional[str]): Optional. - Access level of the runner (e.g., 'ref_protected')
- ```
maximum_timeout
```
    (Optional[int]): Optional. - Maximum timeout for the runner in seconds
  - ```
  ctx
```
  (Optional[Context]): Optional. - MCP context for progress
```
pause_runner
```
: Pause or unpause a specific GitLab runner.
- Parameters:
  - ```
  runner_id
```
  (int): Optional. - ID of the runner to pause or unpause
- ```
active
```
    (bool): Optional. - Whether the runner should be active (True) or paused (False)
  - ```
  ctx
```
  (Optional[Context]): Optional. - MCP context for progress
```
get_runner_jobs
```
: Retrieve jobs for a specific GitLab runner, optionally filtered by status or sorted.
- Parameters:
  - ```
  runner_id
```
  (int): Optional. - ID of the runner to retrieve jobs for
- ```
status
```
    (Optional[str]): Optional. - Filter jobs by status (e.g., 'success', 'failed')
  - ```
  sort
```
  (Optional[str]): Optional. - Sort jobs by criteria (e.g., 'created_at')
```
get_project_runners
```
: Retrieve a list of runners in a specific GitLab project, optionally filtered by scope.
- Parameters:
  - ```
  project_id
```
  (str): Optional. - Project ID or path
- ```
scope
```
    (Optional[str]): Optional. - Filter runners by scope (e.g., 'active')
```
enable_project_runner
```
: Enable a runner in a specific GitLab project.
- Parameters:
  - ```
  project_id
```
  (str): Optional. - Project ID or path
- ```
runner_id
```
    (int): Optional. - ID of the runner to enable
  - ```
  ctx
```
  (Optional[Context]): Optional. - MCP context for progress
```
delete_project_runner
```
: Delete a runner from a specific GitLab project.
- Parameters:
  - ```
  project_id
```
  (str): Optional. - Project ID or path
- ```
runner_id
```
    (int): Optional. - ID of the runner to delete
  - ```
  ctx
```
  (Optional[Context]): Optional. - MCP context for progress
```
get_group_runners
```
: Retrieve a list of runners in a specific GitLab group, optionally filtered by scope.
- Parameters:
  - ```
  group_id
```
  (str): Optional. - Group ID or path
- ```
scope
```
    (Optional[str]): Optional. - Filter runners by scope (e.g., 'active')
```
register_new_runner
```
: Register a new GitLab runner.
- Parameters:
  - ```
  token
```
  (str): Optional. - Registration token for the runner
- ```
description
```
    (Optional[str]): Optional. - Description of the runner
  - ```
  tag_list
```
  (Optional[List[str]]): Optional. - List of tags for the runner
- ```
run_untagged
```
    (Optional[bool]): Optional. - Whether the runner can run untagged jobs
  - ```
  locked
```
  (Optional[bool]): Optional. - Whether the runner is locked
- ```
ctx
```
    (Optional[Context]): Optional. - MCP context for progress
```
delete_runner
```
: Delete a GitLab runner by ID or token.
- Parameters:
  - ```
  runner_id
```
  (Optional[int]): Optional. - ID of the runner to delete
- ```
token
```
    (Optional[str]): Optional. - Token of the runner to delete
  - ```
  ctx
```
  (Optional[Context]): Optional. - MCP context for progress
```
verify_runner_authentication
```
: Verify authentication for a GitLab runner using its token.
- Parameters:
  - ```
  token
```
  (str): Optional. - Runner token to verify
- ```
ctx
```
    (Optional[Context]): Optional. - MCP context for progress
```
reset_gitlab_runner_token
```
: Reset the GitLab runner registration token.
- Parameters:
  - ```
  ctx
```
  (Optional[Context]): Optional. - MCP context for progress
```
reset_project_runner_token
```
: Reset the registration token for a project's runner in GitLab.
- Parameters:
  - ```
  project_id
```
  (str): Optional. - Project ID or path
- ```
ctx
```
    (Optional[Context]): Optional. - MCP context for progress
```
reset_group_runner_token
```
: Reset the registration token for a group's runner in GitLab.
- Parameters:
  - ```
  group_id
```
  (str): Optional. - Group ID or path
- ```
ctx
```
    (Optional[Context]): Optional. - MCP context for progress
```
reset_token
```
: Reset the authentication token for a specific GitLab runner.
- Parameters:
  - ```
  runner_id
```
  (int): Optional. - ID of the runner to reset the token for
- ```
token
```
    (str): Optional. - Current token of the runner
  - ```
  ctx
```
  (Optional[Context]): Optional. - MCP context for progress

Usage Instructions

Use tokens for registration.

Examples

Register:
```
register_new_runner
```
with token="abc123".
Enable:
```
enable_project_runner
```
with runner_id=1.

Error Handling

Token invalid: Reset.