gitlab-cli-skills

Files (90)

• LICENSE
• README.md
• SECURITY.md
• SKILL.md
• VERSION
• SKILL.md · glab-alias/
• commands.md · glab-alias/references/
• SKILL.md · glab-api/
• SKILL.md · glab-attestation/
• commands.md · glab-attestation/references/
• SKILL.md · glab-auth/
• commands.md · glab-auth/references/
• SKILL.md · glab-changelog/
• commands.md · glab-changelog/references/
• SKILL.md · glab-check-update/
• SKILL.md · glab-ci/
• commands.md · glab-ci/references/
• pipeline-best-practices.md · glab-ci/references/
• README.md · glab-ci/templates/
• docker-build.yml · glab-ci/templates/
• nodejs-basic.yml · glab-ci/templates/
• nodejs-multistage.yml · glab-ci/templates/
• SKILL.md · glab-cluster/
• commands.md · glab-cluster/references/
• SKILL.md · glab-completion/
• SKILL.md · glab-config/
• commands.md · glab-config/references/
• SKILL.md · glab-deploy-key/
• commands.md · glab-deploy-key/references/
• SKILL.md · glab-duo/
• commands.md · glab-duo/references/
• SKILL.md · glab-gpg-key/
• commands.md · glab-gpg-key/references/
• SKILL.md · glab-help/
• SKILL.md · glab-incident/
• commands.md · glab-incident/references/
• SKILL.md · glab-issue/
• commands.md · glab-issue/references/
• SKILL.md · glab-iteration/
• commands.md · glab-iteration/references/
• SKILL.md · glab-job/
• commands.md · glab-job/references/
• SKILL.md · glab-label/
• commands.md · glab-label/references/
• SKILL.md · glab-mcp/
• commands.md · glab-mcp/references/
• SKILL.md · glab-milestone/
• commands.md · glab-milestone/references/
• SKILL.md · glab-mr/
• commands.md · glab-mr/references/
• SKILL.md · glab-opentofu/
• commands.md · glab-opentofu/references/
• SKILL.md · glab-quick-actions/
• SKILL.md · glab-release/
• commands.md · glab-release/references/
• SKILL.md · glab-repo/
• commands.md · glab-repo/references/
• SKILL.md · glab-runner-controller/
• commands.md · glab-runner-controller/references/
• SKILL.md · glab-runner/
• …and 30 more

SKILL.md (first lines)

# GitLab CLI Skills

Comprehensive GitLab CLI (glab) command reference and workflows.

## Quick start

```bash
# First time setup
glab auth login

# Common operations
glab mr create --fill              # Create MR from current branch
glab issue create                  # Create issue
glab ci view                       # View pipeline status
glab repo view --web              # Open repo in browser
```

## Multi-agent identity note

When you want different agents to appear as different GitLab users, give each agent its own GitLab bot/service account. Multiple personal access tokens on the same GitLab user still act as that same visible identity.

Use the **Actor identity** for actor-authored GitLab comments, replies, approvals, and other writes. Use an **agent identity** only when the GitLab action is explicitly that agent's own work product. Choose the intended visible actor **before the first GitLab write**.

Treat shell identity as sticky and unsafe by default. If another env file was sourced earlier in the same shell/session, `glab` may still write as that previously loaded identity unless you deliberately switch and verify first.

A practical pattern is one env file per actor, for example `~/.config/openclaw/env/gitlab-actor.env`, `~/.config/openclaw/env/gitlab-reviewer.env`, and `~/.config/openclaw/env/gitlab-release.env`. Keep these env files outside version control, restrict their permissions (for example `chmod 600`), be mindful of backup exposure, and use least-privilege bot/service-account tokens. In a reused shell, clear stale GitLab auth vars first or start a fresh shell. If those files use plain `KEY=value` lines, load them with exported vars before running `glab`:

```bash
unset GITLAB_TOKEN GITLAB_ACCESS_TOKEN OAUTH_TOKEN GITLAB_HOST
set -a
source ~/.config/openclaw/env/gitlab-<actor>.env
set +a
```

Plain `source` updates the current shell but may not export variables to child processes such as `glab`. If the token/host vars are not exported, `glab` may silently fall back to shared stored auth from `~/.config/glab-cli/config.yml`, which can make the wrong account appear to perform the action.

### Required pre-flight before any GitLab write

Run this immediately before any GitLab write, including `glab mr note`, review replies/approvals, and any `glab api` `POST`/`PATCH`/`PUT`/`DELETE` call:

```bash
glab auth status --hostname "$GITLAB_HOST"
glab api --hostname "$GITLAB_HOST" user
```

This assumes the target actor env file set `GITLAB_HOST` for the exact GitLab instance you intend to modify. Do not write until both commands clearly show the intended visible actor on that host.

### Wrong-identity remediation

If a comment or reply was posted under the wrong identity:

1. Stop posting.
2. Delete the mistaken comment or reply if cleanup is needed.
3. `unset GITLAB_TOKEN GITLAB_ACCESS_TOKEN OAUTH_TOKEN GITLAB_HOST` or start a fresh shell.
4. Source the correct env file with `set -a; source ...; set +a`.
5. Rerun `glab auth status --hostname "$GITLAB_HOST"` and `glab api --hostname "$GITLAB_HOST" user`.
6. Repost under the correct actor.
7. Verify the thread no longer shows the wrong visible author for the replacement message.

If the wrong-identity write changed state beyond a comment or reply, do not treat the comment cleanup steps as sufficient. Re-auth as above, then use the matching GitLab reversal for that write under the correct actor and host, such as unapproving an MR or sending the compensating `glab api --hostname "$GITLAB_HOST"` mutation for the exact resource that was changed.

## Skill organization

This skill routes to specialized sub-skills by GitLab domain:

**Core Workflows:**
- `glab-mr` - Merge requests: create, review, approve, merge
- `glab-issue` - Issues: create, list, update, close, comment
- `glab-ci` - CI/CD: pipelines, jobs, logs, artifacts
- `glab-repo` - Repositories: clone, create, fork, manage

**Project Management:**
- `glab-milestone` - Release planning and milestone tracking
- `glab-iteration` - Sprint/iteration management
- `glab-label` - Label management and organization
- `glab-release` - Software releases and versioning

**Authentication & Config:**
- `glab-auth` - Login, logout, Docker registry auth
- `glab-config` - CLI configuration and defaults
- `glab-ssh-key` - SSH key management
- `glab-gpg-key` - GPG keys for commit signing
- `glab-token` - Personal and project access tokens
- `glab-todo` - Personal GitLab to-do triage and completion (added v1.92.0)

**CI/CD Management:**
- `glab-job` - Individual job operations
- `glab-schedule` - Scheduled pipelines and cron jobs
- `glab-variable` - CI/CD variables and secrets
- `glab-securefile` - Secure files for pipelines
- `glab-runner` - Runner management: list, assign/unassign, inspect jobs/managers, pause/unpause, delete (added v1.87.0; expanded in v1.90.0)
- `glab-runner-controller` - Runner controller, scope, and token management (EXPERIMENTAL, admin-only)

**Collaboration:**
- `glab-user` - User profiles and information
- `glab-snippet` - Code snippets (GitLab gists)
- `glab-incident` - Incident management
- `glab-workitems` - Work items: tasks, OKRs, key results, next-gen epics (added v1.87.0)

**Advanced:**
- `glab-api` - Direct REST API calls
- `glab-cluster` - Kubernetes cluster integration
- `glab-deploy-key` - Deploy keys for automation
- `glab-quick-actions` - GitLab slash command quick actions for batching state changes
- `glab-stack` - Stacked/dependent merge requests
- `glab-opentofu` - Terraform/OpenTofu state management

**Utilities:**
- `glab-alias` - Custom command aliases
- `glab-completion` - Shell autocompletion
- `glab-help` - Command help and documentation
- `glab-version` - Version information
- `glab-check-update` - Update checker
- `glab-changelog` - Changelog generation
- `glab-attestation` - Software supply chain security
- `glab-duo` - GitLab Duo AI assistant
- `glab-mcp` - Model Context Protocol server for AI assistant integration (EXPERIMENTAL)

## v1.92.0 Updates

From a-ng-d/claude-ui-color-palette, MIT.

More from a-ng-d/claude-ui-color-palette