gitlab-catalog-browser 0.1.0

package/skills/gitlab-catalog-browser/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: gitlab-catalog-browser
+description: GitLab CI/CD Catalog browsing and pipeline management CLI for AI agents. Use when the user needs to browse GitLab CI/CD components, inspect component schemas, validate .gitlab-ci.yml files, analyze pipeline structure, or manage GitLab CI/CD configurations. Triggers include requests to "browse the GitLab catalog", "list components", "validate a pipeline", "inspect a CI component", "check pipeline dependencies", "trace variables", or any task involving GitLab CI/CD pipeline management.
+---
+
+# gitlab-catalog-browser
+
+CLI tool for AI agents to browse the GitLab CI/CD Catalog, inspect component schemas, validate pipeline configurations, and analyze pipeline structure. Inspired by agent-browser architecture.
+
+## Installation
+
+```bash
+npm install -g gitlab-catalog-browser
+gitlab-ci-cli init                # Verify environment and create config
+```
+
+## Quick Start
+
+Before running any command, load the current workflow content:
+
+```bash
+gitlab-ci-cli skills get core             # Workflows, patterns, troubleshooting
+gitlab-ci-cli skills get core --full      # Include full command reference
+```
+
+## Basic workflow
+
+1. **Initialize**: `gitlab-ci-cli init` — verify Node.js, create config
+2. **Browse catalog**: `gitlab-ci-cli catalog list --org <namespace>`
+3. **Inspect component**: `gitlab-ci-cli component schema <full-path>`
+4. **Validate pipeline**: `gitlab-ci-cli validate .gitlab-ci.yml`
+5. **Analyze**: `gitlab-ci-cli pipeline explain --jobs build,test`
+
+## Configuration
+
+Create `.gitlab-ci-cli.json` (automatically via `init` or manually):
+
+```json
+{
+  "gitlabUrl": "https://gitlab.com",
+  "token": "glpat-xxxx",
+  "timeout": 30000,
+  "output": "json"
+}
+```
+
+Environment variables override file values:
+- `GITLAB_CI_CLI_URL` — GitLab instance URL
+- `GITLAB_CI_CLI_TOKEN` — Personal access token