Enhance GitLab skill with CLI documentation by jpshackelford · Pull Request #63 · OpenHands/extensions

jpshackelford · 2026-02-19T23:14:17Z

Summary

This PR enhances the GitLab skill to have equivalent detail to the GitHub skill, particularly around CLI usage and URL recognition.

Changes

URL Recognition

Added https://gitlab.com as a trigger so the skill activates when GitLab URLs are mentioned
Added explicit note in the <IMPORTANT> section that any URL starting with https://gitlab.com refers to a GitLab artifact

CLI Documentation

Added comprehensive glab CLI command reference:

Merge Request commands: list, view (with comments), create, checkout, approve, merge
Issue commands: list, view (with comments), create, close, add comments
Pipeline/CI commands: status, view, list pipelines, retry failed, trace job logs
API access: direct API calls via glab

Review Comment Handling

Added section on handling review comments (matching GitHub skill guidance)
Added section on resolving discussion threads via GitLab API

Other Improvements

Added note about not marking MRs ready to merge unless explicitly asked
Fixed terminology (PR → MR where appropriate)

Motivation

The GitHub skill had significantly more detail about CLI usage, especially around:

Using gh for workflow monitoring
GraphQL API for resolving review threads
Best practices for handling review comments

This update brings the GitLab skill to parity, ensuring agents have the same level of guidance when working with GitLab repositories.

Testing

The glab CLI commands were tested against a live GitLab repository to verify accuracy.

@jpshackelford can click here to continue refining the PR

- Add trigger for https://gitlab.com URLs to identify GitLab artifacts - Add IMPORTANT note about recognizing GitLab URLs - Add glab CLI examples for checking pipeline status, viewing MRs/issues - Add section on handling review comments (matching GitHub skill) - Add comprehensive glab CLI command reference: - Merge request commands (list, view, create, checkout, approve, merge) - Issue commands (list, view, create, close, comment) - Pipeline/CI commands (status, view, list, retry, trace) - API access commands - Add section on resolving discussion threads via API - Add note about not marking MRs ready unless explicitly asked This brings the GitLab skill to parity with the GitHub skill in terms of CLI usage documentation and best practices. Co-authored-by: openhands <openhands@all-hands.dev>

Removed the verbose 'Common GitLab CLI Commands' reference section. Key examples are already in the IMPORTANT block, and the discussion thread resolution section provides the equivalent of GitHub's GraphQL examples. Co-authored-by: openhands <openhands@all-hands.dev>

jpshackelford · 2026-02-19T23:26:50Z

A customer indicated that the agent was attempting to use the web-browser to access GitLab issues and MRs. I have updated the GitLab skill to use the gitlab command-line so as to give equivalent instructions as the GitHub skill. I have tested with my own GitLab instance.

all-hands-bot

🟡 Acceptable - Brings GitLab skill to parity with GitHub, but command syntax and consistency need fixes.

all-hands-bot · 2026-02-19T23:36:38Z

skills/gitlab/SKILL.md

 ---
 name: gitlab
-description: Interact with GitLab repositories, merge requests, and APIs using the GITLAB_TOKEN environment variable. Use when working with code hosted on GitLab or managing GitLab resources.
+description: Interact with GitLab repositories, merge requests, issues, and pipelines using the GITLAB_TOKEN environment variable and GitLab CLI (glab). Use when working with code hosted on GitLab or managing GitLab resources. Any URL starting with https://gitlab.com is a GitLab artifact.


🟠 Important: Description is 180+ characters. The GitHub skill keeps it concise (~100 chars). Long descriptions break UI displays and catalog views. Consider:

Suggested change

description: Interact with GitLab repositories, merge requests, issues, and pipelines using the GITLAB_TOKEN environment variable and GitLab CLI (glab). Use when working with code hosted on GitLab or managing GitLab resources. Any URL starting with https://gitlab.com is a GitLab artifact.

description: Interact with GitLab repositories, merge requests, issues, and pipelines using the GITLAB_TOKEN environment variable and GitLab CLI (glab). Use when working with code hosted on GitLab.

all-hands-bot · 2026-02-19T23:36:38Z

skills/gitlab/SKILL.md

+
+1. Get the discussion IDs for a merge request:
+```bash
+glab api projects/:id/merge_requests/:mr_iid/discussions


🟡 Suggestion: Placeholders :id and :mr_iid are not explained. Make it concrete:

Suggested change

glab api projects/:id/merge_requests/:mr_iid/discussions

1. Get the discussion IDs for a merge request (replace PROJECT_ID with numeric ID or URL-encoded path, MR_IID with merge request number):

```bash

glab api projects/12345/merge_requests/42/discussions

# Or with URL-encoded path:

glab api projects/mygroup%2Fmyrepo/merge_requests/42/discussions

all-hands-bot · 2026-02-19T23:36:38Z

skills/gitlab/SKILL.md

+curl --request POST --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  "https://gitlab.com/api/v4/projects/:id/merge_requests/:mr_iid/discussions/:discussion_id/notes" \
+  --data "body=Fixed in <COMMIT_SHA>"
+```
+
+3. Resolve a discussion thread:
+```bash
+curl --request PUT --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  "https://gitlab.com/api/v4/projects/:id/merge_requests/:mr_iid/discussions/:discussion_id" \
+  --data "resolved=true"


🟡 Suggestion: Inconsistent tooling. Line 62 uses glab api, then suddenly switches to curl. Pick one approach or explain why you switch. For consistency with the skill's preference for glab:

Suggested change

curl --request POST --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \

"https://gitlab.com/api/v4/projects/:id/merge_requests/:mr_iid/discussions/:discussion_id/notes" \

--data "body=Fixed in <COMMIT_SHA>"

```

3. Resolve a discussion thread:

```bash

curl --request PUT --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \

"https://gitlab.com/api/v4/projects/:id/merge_requests/:mr_iid/discussions/:discussion_id" \

--data "resolved=true"

2. Reply to a discussion thread:

```bash

glab api --method POST projects/:id/merge_requests/:mr_iid/discussions/:discussion_id/notes \

-f body="Fixed in <COMMIT_SHA>"

Resolve a discussion thread:

glab api --method PUT projects/:id/merge_requests/:mr_iid/discussions/:discussion_id \ -f resolved=true

all-hands-bot · 2026-02-19T23:36:38Z

skills/gitlab/SKILL.md

+# List recent pipelines to find the ID
+glab pipeline list
+
+# Retry the failed pipeline
+glab ci retry <pipeline-id>


🔴 Critical: Command syntax is wrong. glab ci retry does NOT take a pipeline ID argument - it retries the last pipeline for the current branch. For a specific pipeline:

Suggested change

# List recent pipelines to find the ID

glab pipeline list

# Retry the failed pipeline

glab ci retry <pipeline-id>

4. Retry a failed pipeline:

```bash

# List recent pipelines to find the ID

glab ci list

# Retry a specific pipeline (use glab API)

glab api --method POST projects/:id/pipelines/:pipeline_id/retry

# Or retry the latest pipeline for current branch

glab ci retry

all-hands-bot · 2026-02-19T23:36:38Z

skills/gitlab/SKILL.md

+glab pipeline list
+
+# Retry the failed pipeline
+glab ci retry <pipeline-id>


🟢 Nit: File should end with a newline (POSIX standard). Git will flag this.

juanmichelini

Can you double check the commands?

openhands-agent added 2 commits February 19, 2026 23:13

jpshackelford requested a review from juanmichelini February 19, 2026 23:24

neubig requested a review from all-hands-bot February 19, 2026 23:34

jpshackelford changed the title ~~Enhance GitLab skill with comprehensive CLI documentation~~ Enhance GitLab skill with CLI documentation Feb 19, 2026

all-hands-bot reviewed Feb 19, 2026

View reviewed changes

juanmichelini approved these changes Feb 20, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Enhance GitLab skill with CLI documentation#63

Enhance GitLab skill with CLI documentation#63
jpshackelford wants to merge 2 commits intomainfrom
feature/enhance-gitlab-skill

jpshackelford commented Feb 19, 2026

Uh oh!

jpshackelford commented Feb 19, 2026

Uh oh!

all-hands-bot left a comment

Uh oh!

all-hands-bot Feb 19, 2026

Uh oh!

all-hands-bot Feb 19, 2026

Uh oh!

all-hands-bot Feb 19, 2026

Uh oh!

all-hands-bot Feb 19, 2026

Uh oh!

all-hands-bot Feb 19, 2026

Uh oh!

juanmichelini left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

	description: Interact with GitLab repositories, merge requests, issues, and pipelines using the GITLAB_TOKEN environment variable and GitLab CLI (glab). Use when working with code hosted on GitLab or managing GitLab resources. Any URL starting with https://gitlab.com is a GitLab artifact.
	description: Interact with GitLab repositories, merge requests, issues, and pipelines using the GITLAB_TOKEN environment variable and GitLab CLI (glab). Use when working with code hosted on GitLab.

-glab api projects/:id/merge_requests/:mr_iid/discussions
+. Get the discussion IDs for a merge request (replace PROJECT_ID with numeric ID or URL-encoded path, MR_IID with merge request number):
+```bash
+glab api projects/12345/merge_requests/42/discussions
+# Or with URL-encoded path:
+glab api projects/mygroup%2Fmyrepo/merge_requests/42/discussions

Conversation

jpshackelford commented Feb 19, 2026

Summary

Changes

URL Recognition

CLI Documentation

Review Comment Handling

Other Improvements

Motivation

Testing

Uh oh!

jpshackelford commented Feb 19, 2026

Uh oh!

all-hands-bot left a comment

Choose a reason for hiding this comment

Uh oh!

all-hands-bot Feb 19, 2026

Choose a reason for hiding this comment

Uh oh!

all-hands-bot Feb 19, 2026

Choose a reason for hiding this comment

Uh oh!

all-hands-bot Feb 19, 2026

Choose a reason for hiding this comment

Uh oh!

all-hands-bot Feb 19, 2026

Choose a reason for hiding this comment

Uh oh!

all-hands-bot Feb 19, 2026

Choose a reason for hiding this comment

Uh oh!

juanmichelini left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants