Gitlab

GitLab Skill

Use this skill to operate GitLab repositories, branches, merge requests, reviews, and commits through the packaged launcher and local CLI runtime.

Within Orbit's shared provider framework, this skill is one implementation of the repo capability.

Runtime and execution

Always run the packaged launcher through ${GITLAB_SKILL_DIR} so it works from the user's current working directory:

• macOS/Linux: ${GITLAB_SKILL_DIR}/bin/gitlab
• Windows: ${GITLAB_SKILL_DIR}\bin\gitlab.cmd

${GITLAB_SKILL_DIR} is a documentation placeholder, not a guaranteed shell environment variable. Resolve BIN to a real launcher path once before the first CLI call. Do not call node app/dist/cli.js directly.

Scope and boundaries

• GitLab API through the packaged CLI only.
• CLI-mediated operations only.
• Do not call GitLab REST endpoints directly from skill content.
• Treat merge requests as the repo.pr.* capability surface.

Capability Domain

Domain:

• repo

Provides:

• repo.config.get
• repo.config.set
• repo.repo.list
• repo.repo.search
• repo.repo.get
• repo.repo.content
• repo.repo.default-branch.get
• repo.branch.list
• repo.branch.create
• repo.pr.list
• repo.pr.get
• repo.pr.changes
• repo.pr.diff
• repo.pr.activities
• repo.pr.create
• repo.pr.update
• repo.pr.comment
• repo.pr.review-comment
• repo.pr.approve
• repo.commit.list
• repo.commit.get
• repo.commit.changes
• repo.commit.pull-requests
• provider-specific workflow helpers

Config check:

• gitlab config get

Config check

Run gitlab config get when configuration state is unknown or before the first provider-scoped task in a new session.

Quick reference

Task	Command
Version diagnostics	BIN version
Runtime diagnostics	BIN doctor
Store config	BIN config set --base-url <URL> --token <TOKEN>
Read config metadata	BIN config get
List namespace repos	BIN repo list --namespace <group-or-user>
Get repository	BIN repo get --namespace <group-or-user> --repo <name>
Read file content	BIN repo content --namespace <group-or-user> --repo <name> --path <path> [--at <ref>]
List merge requests	BIN pr list --namespace <group-or-user> --repo <name>
Get merge request	BIN pr get --namespace <group-or-user> --repo <name> --number <iid>

BIN means the resolved launcher path in the current session.

Supporting files

• Read references/commands.md for the packaged command surface.
• Read references/usage.md for execution expectations and shared framework positioning.