Building CI/CD Pipelines
Current State
!ls .github/workflows/*.yml .gitlab-ci.yml Jenkinsfile .circleci/config.yml 2>/dev/null || echo 'No CI/CD config found'
Overview
Generate CI/CD pipeline configurations for GitHub Actions, GitLab CI, Jenkins, CircleCI, and Azure DevOps. Produce multi-stage workflows covering linting, testing, building container images, security scanning, and deploying to staging/production with proper gating and rollback mechanisms.
Prerequisites
- Git repository hosted on a supported platform (GitHub, GitLab, Bitbucket, Azure DevOps)
- Container runtime (Docker) if building images
- Target deployment environment credentials configured as pipeline secrets
- Test suite that can run headlessly (
npm test, pytest, go test, etc.)
- Understanding of branching strategy (trunk-based, GitFlow, or environment branches)
Instructions
- Scan the project for existing CI/CD configuration files (
.github/workflows/, .gitlab-ci.yml, Jenkinsfile, .circleci/config.yml)
- Identify the application stack: language, framework, test runner, package manager, and deployment target
- Define pipeline stages:
lint -> test -> build -> security-scan -> deploy-staging -> integration-test -> deploy-production
- Generate the pipeline configuration file with appropriate triggers (push to main, PR events, tags)
- Add caching for dependencies (
node_modules, .pip-cache, Go modules) to reduce build times
- Configure matrix builds for multiple language versions or OS targets where appropriate
- Add secret references for deployment credentials, container registry tokens, and API keys (never hardcode)
- Implement deployment gates: manual approval for production, automated rollback on health check failure
- Add status badges and notifications (Slack, email) for build results
- Validate the pipeline syntax using platform-specific tools (
actionlint, gitlab-ci-lint)
Output
- Pipeline configuration files (
.github/workflows/*.yml, .gitlab-ci.yml, Jenkinsfile)
- Dockerfile for container builds (multi-stage, minimal base image)
- Deployment scripts or Kubernetes manifests referenced by the pipeline
- Environment-specific variable files for staging vs. production
Error Handling
| Error |
Cause |
Solution |
Pipeline triggered but no jobs run |
Trigger conditions (paths, branches) do not match |
Review on: / only: / rules: filters and verify branch names |
Docker build failed: layer cache miss |
Cache key changed or cache storage expired |
Use content-based cache keys (hashFiles('**/package-lock.json')) and verify cache backend |
Secret not found |
Secret name mismatch or not set in pipeline settings |
Check secret names match exactly (case-sensitive) in repository/project settings |
Deploy failed: unauthorized |
Expired or incorrect deployment credentials |
Rotate credentials, update pipeline secrets, and verify IAM role/service account permissions |
Tests pass locally but fail in CI |
Environment differences (OS, node version, timezone) |
Pin runtime versions in pipeline config; use matrix to test across environments |
Examples
- "Create a GitHub Actions workflow for a Node.js app: lint with ESLint, test with Jest, build Docker image, push to ECR, deploy to EKS staging on PR merge."
- "Generate a GitLab CI pipeline with parallel test jobs, SAST scanning, and manual production deployment gate."
- "Build a Jenkins pipeline that runs Python tests in a Docker agent, publishes coverage to SonarQube, and deploys via Terraform."
Resources
Source: jeremylongshore/claude-code-plugins-plus-skills → skills/.curated/building-cicd-pipelines/SKILL.md
Also appears in: jeremylongshore/claude-code-plugins-plus-skills/plugins/devops/ci-cd-pipeline-builder/skills/building-cicd-pipelines/SKILL.md
1---2name: building-cicd-pipelines3description: 'Execute use when you need to work with deployment and CI/CD. This skill provides deployment automation and pipeline orchestration with comprehensive guidance and automation. Trigger with phrases like "deploy application", "create pipeline", or "automate deployment". '4---56# Building CI/CD Pipelines78## Current State910!`ls .github/workflows/*.yml .gitlab-ci.yml Jenkinsfile .circleci/config.yml 2>/dev/null || echo 'No CI/CD config found'`1112## Overview1314Generate CI/CD pipeline configurations for GitHub Actions, GitLab CI, Jenkins, CircleCI, and Azure DevOps. Produce multi-stage workflows covering linting, testing, building container images, security scanning, and deploying to staging/production with proper gating and rollback mechanisms.1516## Prerequisites1718- Git repository hosted on a supported platform (GitHub, GitLab, Bitbucket, Azure DevOps)19- Container runtime (Docker) if building images20- Target deployment environment credentials configured as pipeline secrets21- Test suite that can run headlessly (`npm test`, `pytest`, `go test`, etc.)22- Understanding of branching strategy (trunk-based, GitFlow, or environment branches)2324## Instructions25261. Scan the project for existing CI/CD configuration files (`.github/workflows/`, `.gitlab-ci.yml`, `Jenkinsfile`, `.circleci/config.yml`)272. Identify the application stack: language, framework, test runner, package manager, and deployment target283. Define pipeline stages: `lint` -> `test` -> `build` -> `security-scan` -> `deploy-staging` -> `integration-test` -> `deploy-production`294. Generate the pipeline configuration file with appropriate triggers (push to main, PR events, tags)305. Add caching for dependencies (`node_modules`, `.pip-cache`, Go modules) to reduce build times316. Configure matrix builds for multiple language versions or OS targets where appropriate327. Add secret references for deployment credentials, container registry tokens, and API keys (never hardcode)338. Implement deployment gates: manual approval for production, automated rollback on health check failure349. Add status badges and notifications (Slack, email) for build results3510. Validate the pipeline syntax using platform-specific tools (`actionlint`, `gitlab-ci-lint`)3637## Output3839- Pipeline configuration files (`.github/workflows/*.yml`, `.gitlab-ci.yml`, `Jenkinsfile`)40- Dockerfile for container builds (multi-stage, minimal base image)41- Deployment scripts or Kubernetes manifests referenced by the pipeline42- Environment-specific variable files for staging vs. production4344## Error Handling4546| Error | Cause | Solution |47|-------|-------|---------|48| `Pipeline triggered but no jobs run` | Trigger conditions (paths, branches) do not match | Review `on:` / `only:` / `rules:` filters and verify branch names |49| `Docker build failed: layer cache miss` | Cache key changed or cache storage expired | Use content-based cache keys (`hashFiles('**/package-lock.json')`) and verify cache backend |50| `Secret not found` | Secret name mismatch or not set in pipeline settings | Check secret names match exactly (case-sensitive) in repository/project settings |51| `Deploy failed: unauthorized` | Expired or incorrect deployment credentials | Rotate credentials, update pipeline secrets, and verify IAM role/service account permissions |52| `Tests pass locally but fail in CI` | Environment differences (OS, node version, timezone) | Pin runtime versions in pipeline config; use `matrix` to test across environments |5354## Examples5556- "Create a GitHub Actions workflow for a Node.js app: lint with ESLint, test with Jest, build Docker image, push to ECR, deploy to EKS staging on PR merge."57- "Generate a GitLab CI pipeline with parallel test jobs, SAST scanning, and manual production deployment gate."58- "Build a Jenkins pipeline that runs Python tests in a Docker agent, publishes coverage to SonarQube, and deploys via Terraform."5960## Resources6162- GitHub Actions: https://docs.github.com/en/actions63- GitLab CI/CD: https://docs.gitlab.com/ee/ci/64- Jenkins Pipeline: https://www.jenkins.io/doc/book/pipeline/65- CI/CD best practices: https://martinfowler.com/articles/continuousIntegration.html6667---6869**Source:** [`jeremylongshore/claude-code-plugins-plus-skills`](https://github.com/jeremylongshore/claude-code-plugins-plus-skills) → `skills/.curated/building-cicd-pipelines/SKILL.md`7071**Also appears in:** `jeremylongshore/claude-code-plugins-plus-skills/plugins/devops/ci-cd-pipeline-builder/skills/building-cicd-pipelines/SKILL.md`
thedixitjain