Gitlab Assistant

GitLab Assistant

Central hub for GitLab automation using the glab CLI. Routes requests to the most appropriate specialized skill.

Quick Reference

Risk Legend: - Safe | ⚠️ Caution | ⚠️⚠️ Warning | ⚠️⚠️⚠️ Danger

Routing Rules

Rule 1: Explicit Resource Type

Route based on the GitLab resource being worked with:

Rule 2: Common Workflows

Rule 3: Multi-Step Operations

For complex workflows that span multiple skills, coordinate them:

Example: "Release version 1.2.0"
1. gitlab-mr: Ensure all MRs are merged
2. gitlab-ci: Verify pipeline passes
3. gitlab-release: Create release with changelog

Skills Overview

gitlab-mr (Merge Requests)

• Purpose: Create, review, approve, and merge MRs
• Key commands: glab mr list, glab mr create, glab mr checkout, glab mr merge
• Risk: ⚠️ (merge is destructive)
• Triggers: MR, merge request, review, approve, merge, checkout

gitlab-issue (Issues)

• Purpose: Track bugs, features, and tasks
• Key commands: glab issue list, glab issue create, glab issue close
• Risk: ⚠️ (close/delete are destructive)
• Triggers: issue, bug, task, ticket, feature

gitlab-ci (CI/CD Pipelines)

• Purpose: View, trigger, and manage CI/CD pipelines
• Key commands: glab ci status, glab ci view, glab ci run, glab ci artifact
• Risk: ⚠️ (run triggers compute resources)
• Triggers: CI, pipeline, build, job, deploy, artifacts, lint

gitlab-repo (Repositories)

• Purpose: Clone, fork, create, and manage repositories
• Key commands: glab repo clone, glab repo fork, glab repo create
• Risk: ⚠️⚠️ (delete is highly destructive)
• Triggers: repo, repository, project, clone, fork

gitlab-release (Releases)

• Purpose: Create and manage releases
• Key commands: glab release create, glab release list, glab release view
• Risk: ⚠️ (creates tags and releases)
• Triggers: release, version, changelog, tag

gitlab-label (Labels)

• Purpose: Manage project labels
• Key commands: glab label create, glab label list
• Risk: ⚠️ (affects issue/MR categorization)
• Triggers: label, tag (for categorization)

gitlab-milestone (Milestones)

• Purpose: Manage project milestones
• Key commands: glab milestone create, glab milestone list
• Risk: ⚠️ (affects planning)
• Triggers: milestone, sprint, iteration

gitlab-variable (CI/CD Variables)

• Purpose: Manage CI/CD variables and secrets
• Key commands: glab variable set, glab variable list
• Risk: ⚠️⚠️ (contains secrets)
• Triggers: variable, secret, env var, CI variable

gitlab-group (Groups - API)

• Purpose: Manage groups, members, subgroups via API
• Key commands: glab api groups, glab api groups/:id/members
• Risk: ⚠️ (group management)
• Triggers: group, team, organization, members, namespace

gitlab-search (Search - API)

• Purpose: Search across GitLab (projects, issues, code, etc.)
• Key commands: glab api "search?scope=...&search=..."
• Risk: - (read-only)
• Triggers: search, find, query

gitlab-protected-branch (Protected Branches - API)

• Purpose: Manage branch protection rules
• Key commands: glab api projects/:id/protected_branches
• Risk: ⚠️ (affects branch access)
• Triggers: protect branch, branch protection, access rules

gitlab-webhook (Webhooks - API)

• Purpose: Manage project webhooks
• Key commands: glab api projects/:id/hooks
• Risk: ⚠️ (external integrations)
• Triggers: webhook, hook, notification, integration

gitlab-file (Repository Files - API)

• Purpose: Read/write repository files via API
• Key commands: glab api projects/:id/repository/files/:path
• Risk: ⚠️ (modifies files)
• Triggers: file, blob, content, raw

gitlab-wiki (Wiki - API)

• Purpose: Manage project wiki pages
• Key commands: glab api projects/:id/wikis
• Risk: ⚠️ (documentation changes)
• Triggers: wiki, documentation page

gitlab-discussion (Discussions - API)

• Purpose: Manage threaded discussions on MRs/issues
• Key commands: glab api projects/:id/merge_requests/:iid/discussions
• Risk: ⚠️ (comments)
• Triggers: discussion, thread, comment, note, reply

gitlab-badge (Badges - API)

• Purpose: Manage project badges
• Key commands: glab api projects/:id/badges
• Risk: ⚠️ (project display)
• Triggers: badge, status badge, coverage badge

gitlab-container (Container Registry - API)

• Purpose: Manage container registry images and tags
• Key commands: glab api projects/:id/registry/repositories
• Risk: ⚠️⚠️ (delete images is destructive)
• Triggers: container, registry, docker, image

gitlab-vulnerability (Vulnerabilities - API)

• Purpose: Manage security vulnerabilities (Ultimate)
• Key commands: glab api projects/:id/vulnerabilities
• Risk: ⚠️ (security state changes)
• Triggers: vulnerability, security, scan, CVE

Connection Verification

Before any operation, verify GitLab is configured:

glab auth status

If not authenticated:

glab auth login

Check current repository context:

glab repo view

Common glab Commands Quick Reference

# Authentication
glab auth login              # Interactive login
glab auth status             # Check auth status

# Merge Requests
glab mr list                 # List MRs
glab mr create               # Create MR
glab mr view <id>            # View MR details
glab mr checkout <id>        # Checkout MR branch
glab mr merge <id>           # Merge MR

# Issues
glab issue list              # List issues
glab issue create            # Create issue
glab issue view <id>         # View issue
glab issue close <id>        # Close issue

# CI/CD
glab ci status               # Current pipeline status
glab ci view                 # Interactive pipeline view
glab ci run                  # Trigger pipeline
glab ci artifact             # Download artifacts

# Repository
glab repo clone <path>       # Clone repository
glab repo fork <path>        # Fork repository
glab repo view               # View repo info

Disambiguation

When request is ambiguous, ask for clarification:

Related Documentation

• Decision Tree
• API Helpers
• Safeguards
• Quick Reference