gitlab-api

The GitLab API skill provides a robust interface for interacting with both GitLab.com and self-hosted GitLab instances. Designed for software engineers, DevOps practitioners, and automation-focused agents, this skill streamlines repository interactions by enabling direct execution of REST API commands. It eliminates the need for manual browser interaction when performing common Git operations, allowing agents to act as autonomous contributors within your development lifecycle.

• Perform comprehensive file operations: Read, create, update, and delete files directly within the repository using simple natural language requests.

• Manage project structure: List projects, retrieve project IDs by path, and navigate repository trees to inspect directory contents.

• Handle branching workflows: List existing branches, create new feature branches from specific references, and manage branch metadata.

• Retrieve full repository archives: Generate and download compressed tar.gz archives for external analysis or backup tasks.

• Integration ready: Supports automated scripts for CI/CD pipelines, repository health checks, and routine file maintenance tasks.

• Configuration: Requires a GitLab personal access token with 'api' or 'read_api' + 'write_repository' scopes. Supports custom instance URLs for self-hosted enterprise deployments.

• Rate Limiting: Respects standard GitLab API limits (300 requests/minute for authenticated users on GitLab.com, adjustable for self-hosted instances).

• Inputs and Outputs: Accepts JSON-encoded payloads for file modifications and returns structured JSON responses from the GitLab API v4, which are then parsed into human-readable results.

• Security: Encapsulates authentication via environment variables or local config files, ensuring tokens remain localized and secure. Ensure your environment properly manages private tokens according to organizational security policies.

• Usage constraints: Ensure your runner environment has 'curl' and 'jq' installed to facilitate the provided helper scripts and JSON processing tasks.