Vince Lozada 78b9bf522d Enhancement: Add pipeline best practices, templates, and advanced troubleshooting (#25)
Phase 1: Pipeline Best Practices
- Created glab-ci/references/pipeline-best-practices.md (12KB)
- Comprehensive guide covering:
  * Caching strategies (node_modules, lockfile-based, per-job)
  * Multi-stage pipeline patterns (sequential, parallel, artifacts)
  * Coverage reporting integration (Jest, Vitest, badges)
  * Security scanning (npm audit, SAST, secret detection, Docker)
  * Common patterns (matrix builds, conditional jobs, retries)
  * Performance optimization (fail fast, parallelization, caching)
  * Environment-specific configurations (variables, review apps)

Phase 2: Pipeline Templates
- Created glab-ci/templates/ directory with 3 production-ready templates:
  * nodejs-basic.yml - Simple Node.js CI/CD pipeline
  * nodejs-multistage.yml - Multi-environment (staging + production)
  * docker-build.yml - Docker build, test, scan, and deploy
- Created templates/README.md with:
  * Usage instructions and validation steps
  * Customization tips for different package managers
  * Environment variable configuration guide
  * Template comparison matrix
  * Advanced patterns (monorepo, matrix builds, schedules)
  * Troubleshooting common template issues

Phase 3: Enhanced Troubleshooting
- Expanded glab-ci/SKILL.md troubleshooting section:
  * Runtime issues (stuck pipelines, job failures)
  * Configuration issues (cache, job ordering, slow builds, artifacts, coverage)
  * Performance optimization workflow (identify, analyze, optimize, validate)
- Added 'Pipeline Configuration' section with:
  * References to templates directory
  * Link to best practices guide
  * Validation examples
- Updated 'Related Skills' section with new resource links

Total additions: ~22KB of documentation
Borrowed best ideas from ClawHub cicd-pipeline-generator skill
Fills gap between 'how to use glab ci' and 'how to write good .gitlab-ci.yml'
Target version: v1.3.0
Expected score: 9.8/10 (up from 9.5/10)

Co-authored-by: Steven (Bot) <steven@winkintel.com>
2026-02-15 14:00:34 -06:00
2026-01-30 14:43:52 -06:00
2026-01-30 22:00:19 +00:00

   ____ _ _   _          _        ____ _     ___   ____  _    _ _ _     
  / ___(_) |_| |    __ _| |__    / ___| |   |_ _| / ___|| | _(_) | |___ 
 | |  _| | __| |   / _` | '_ \  | |   | |    | |  \___ \| |/ / | | / __|
 | |_| | | |_| |__| (_| | |_) | | |___| |___ | |   ___) |   <| | | \__ \
  \____|_|\__|_____\__,_|_.__/   \____|_____|___| |____/|_|\_\_|_|_|___/
                                                                        

GitLab CLI Skills

A collection of skills for AI coding agents following the Agent Skills format. These skills enable AI agents to use the GitLab CLI (glab) effectively.

Available Skills

Available Skills

Installation

npx skills add vince-winkintel/gitlab-cli-skills

Usage

Skills are automatically activated when relevant tasks are detected. Example prompts:

  • "Log into GitLab CLI"
  • "Check glab auth status"
  • "Configure GitLab Docker auth"

Prerequisites

  • GitLab CLI installed (glab)
  • GitLab access token or browser auth

Install glab (Homebrew)

brew install glab

License

MIT

S
Description
Comprehensive GitLab CLI (glab) command reference and workflows for all GitLab operations via terminal. Use when user mentions GitLab CLI, glab commands,…
Readme MIT 614 KiB
Languages
Python 70.3%
Shell 29.7%