Claude-skill-registry gitlab-branches

Overview

This skill handles branch-related tasks in GitLab via MCP tools. Focus on one operation per call for efficiency.

Available Tools

• get_branches

  : Get branches in a GitLab project, optionally filtered.
  • Parameters:

    • project_id

      (str): Optional. - Project ID or path

    • search

      (Optional[str]): Optional. - Filter branches by name containing this term

    • regex

      (Optional[str]): Optional. - Filter branches by regex pattern on name

    • branch

      (Optional[str]): Optional. - Branch name

• create_branch

  : Create a new branch in a GitLab project from a reference.
  • Parameters:

    • project_id

      (str): Optional. - Project ID or path

    • branch

      (str): Optional. - New branch name

    • ref

      (str): Optional. - Reference to create from (branch/tag/commit SHA)

• delete_branch

  : Delete a branch or all merged branches in a GitLab project.
  • Parameters:

    • project_id

      (str): Optional. - Project ID or path

    • branch

      (Optional[str]): Optional. - Branch name to delete

    • delete_merged_branches

      (Optional[bool]): Optional. - Delete all merged branches (excluding protected)

    • ctx

      (Optional[Context]): Optional. - MCP context for progress

Usage Instructions

1. Identify the project_id (e.g., from query or prior context).
2. Call the appropriate tool with minimal params.
3. Handle pagination if results exceed limits (use MCP's built-in support).

Examples

• List branches: Call

  get_branches

  with project_id="my/project" and search="feature".
• Create:

  create_branch

  with project_id="123", branch="new-feature", ref="main".
• Delete merged:

  delete_branch

  with project_id="123", delete_merged_branches=true.

Error Handling

• Missing params: Retry with required fields.
• 404: Branch/project not found—verify IDs.
• Rate limits: Wait and retry.