Design and generate CI/CD pipelines from project stack signals across GitHub Actions, GitLab CI, CircleCI, and Buildkite. Use when bootstrapping CI, migrating pipelines, adding deployment gates, or optimizing build times.
Generate production-grade CI/CD pipelines from detected project stack signals. Analyzes lockfiles, manifests, and scripts to produce optimized pipelines with proper caching, matrix strategies, security scanning, and deployment gates. Supports GitHub Actions, GitLab CI, CircleCI, and Buildkite with deployment strategies including blue-green, canary, and rolling updates.
Stack detection — infer language/runtime, package manager, build/test/lint commands, framework, and infrastructure (Docker, K8s, Terraform) from lockfiles and manifests.
Pipeline generation — lint/test/build/deploy stages with correct dependencies, caching, matrix builds, artifact passing, and conditional execution.
Deployment strategies — blue-green, canary, rolling updates, recreate, feature-flag integration, and manual approval gates.
Security integration — SAST (CodeQL, Semgrep, Snyk), dependency and container scanning (Trivy, Grype), secret scanning, and SBOM generation.
Optimization — caching matched to package manager, path filtering, concurrency control, and fail-fast matrices.
When to Use
Bootstrapping CI/CD for a new repository
Migrating between CI platforms
Optimizing slow or flaky pipelines
Adding deployment stages to an existing CI-only pipeline
Implementing security scanning in the pipeline
Setting up multi-environment deployment (staging, production)
Clarify First
Before generating the pipeline, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Target platform — GitHub Actions, GitLab CI, CircleCI, or Buildkite (sets the YAML dialect pipeline_generator.py emits via --platform)
Project stack — language/runtime, package manager, and whether Docker/K8s/Terraform are present (drives stack detection, caching, and which stages are generated)
Deployment strategy & gates — blue-green, canary, rolling, or CI-only, plus any manual approval gates (determines the deploy stages and conditions)
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Tools
Tool
Purpose
Command
pipeline_generator.py
Generate pipeline YAML from project stack detection
Load the reference that matches the task — keep this file lean and pull detail on demand:
references/pipeline-templates.md — stack-detection heuristics, full GitHub Actions templates (Node.js/pnpm/Next.js and Python/uv/FastAPI), the GitLab CI equivalent, the caching strategy reference table, pipeline optimization techniques, and the deployment-strategy decision framework. Read when generating a pipeline or choosing a deployment strategy.
references/quality-and-operations.md — pre-merge validation checklist, common pitfalls, best practices, troubleshooting table, and success criteria. Read before merging a generated pipeline or when one misbehaves.
Scope & Limitations
This skill covers:
Generating CI/CD pipelines for GitHub Actions, GitLab CI, CircleCI, and Buildkite
Stack detection from lockfiles, manifests, Dockerfiles, and infrastructure-as-code definitions
Deployment strategy selection (blue-green, canary, rolling, recreate) with decision framework
Pipeline optimization including caching, matrix builds, path filtering, and concurrency control
This skill does NOT cover:
Runtime infrastructure provisioning or cloud resource management (see engineering/saas-scaffolder)
Application-level security hardening beyond CI-integrated scanning (see engineering/skill-security-auditor)
Monitoring, alerting, and observability configuration after deployment (see engineering/observability-designer)
Database migration orchestration during deployments (see engineering/migration-architect)
Integration Points
Skill
Integration
Data Flow
engineering/dependency-auditor
Feeds vulnerability scan results into pipeline security gates
Auditor findings trigger pipeline failure or warning annotations
engineering/release-manager
Coordinates versioning and changelog with deploy stages
Post-deploy health checks and alerting complement pipeline gates
Pipeline triggers smoke tests; observability confirms deployment health
engineering/env-secrets-manager
Manages secrets referenced by pipeline environment variables
Secret rotation policies feed into pipeline secret store configuration
engineering/migration-architect
Database migrations run as a pre-deploy step in the pipeline
Migration status gates the application deployment job
engineering/runbook-generator
Generates rollback runbooks aligned with deployment strategy
Pipeline failure triggers link to the relevant rollback runbook
1---2name: ci-cd-pipeline-builder3description: Design and generate CI/CD pipelines from project stack signals across GitHub Actions, GitLab CI, CircleCI, and Buildkite. Use when bootstrapping CI, migrating pipelines, adding deployment gates, or optimizing build times.4license: MIT + Commons Clause5---6# CI/CD Pipeline Builder
78Generate production-grade CI/CD pipelines from detected project stack signals. Analyzes lockfiles, manifests, and scripts to produce optimized pipelines with proper caching, matrix strategies, security scanning, and deployment gates. Supports GitHub Actions, GitLab CI, CircleCI, and Buildkite with deployment strategies including blue-green, canary, and rolling updates.
910**Keywords:** CI/CD, GitHub Actions, GitLab CI, pipeline, deployment, caching, matrix builds, blue-green deployment, canary deployment, security scanning, SAST, container builds, environment gates
1112## Core Capabilities
1314- **Stack detection** — infer language/runtime, package manager, build/test/lint commands, framework, and infrastructure (Docker, K8s, Terraform) from lockfiles and manifests.
15- **Pipeline generation** — lint/test/build/deploy stages with correct dependencies, caching, matrix builds, artifact passing, and conditional execution.
16- **Deployment strategies** — blue-green, canary, rolling updates, recreate, feature-flag integration, and manual approval gates.
17- **Security integration** — SAST (CodeQL, Semgrep, Snyk), dependency and container scanning (Trivy, Grype), secret scanning, and SBOM generation.
18- **Optimization** — caching matched to package manager, path filtering, concurrency control, and fail-fast matrices.
1920## When to Use
2122- Bootstrapping CI/CD for a new repository
23- Migrating between CI platforms
24- Optimizing slow or flaky pipelines
25- Adding deployment stages to an existing CI-only pipeline
26- Implementing security scanning in the pipeline
27- Setting up multi-environment deployment (staging, production)
2829## Clarify First
3031Before generating the pipeline, confirm these inputs. If any is unknown or vague, ASK — do not assume:
3233- [ ] **Target platform** — GitHub Actions, GitLab CI, CircleCI, or Buildkite (sets the YAML dialect `pipeline_generator.py` emits via `--platform`)
34- [ ] **Project stack** — language/runtime, package manager, and whether Docker/K8s/Terraform are present (drives stack detection, caching, and which stages are generated)
35- [ ] **Deployment strategy & gates** — blue-green, canary, rolling, or CI-only, plus any manual approval gates (determines the deploy stages and conditions)
3637Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
3839## Tools
4041| Tool | Purpose | Command |
42|------|---------|---------|
43| `pipeline_generator.py` | Generate pipeline YAML from project stack detection | `python scripts/pipeline_generator.py . --platform github --deploy` |
44| `cache_optimizer.py` | Analyze pipeline configs and suggest caching improvements | `python scripts/cache_optimizer.py --dir . --severity high` |
45| `pipeline_linter.py` | Lint pipeline YAML for common issues | `python scripts/pipeline_linter.py --dir . --severity warning` |
4647## References
4849Load the reference that matches the task — keep this file lean and pull detail on demand:
5051- **[references/pipeline-templates.md](references/pipeline-templates.md)** — stack-detection heuristics, full GitHub Actions templates (Node.js/pnpm/Next.js and Python/uv/FastAPI), the GitLab CI equivalent, the caching strategy reference table, pipeline optimization techniques, and the deployment-strategy decision framework. Read when generating a pipeline or choosing a deployment strategy.
52- **[references/quality-and-operations.md](references/quality-and-operations.md)** — pre-merge validation checklist, common pitfalls, best practices, troubleshooting table, and success criteria. Read before merging a generated pipeline or when one misbehaves.
5354## Scope & Limitations
5556**This skill covers:**
57- Generating CI/CD pipelines for GitHub Actions, GitLab CI, CircleCI, and Buildkite
58- Stack detection from lockfiles, manifests, Dockerfiles, and infrastructure-as-code definitions
59- Deployment strategy selection (blue-green, canary, rolling, recreate) with decision framework
60- Pipeline optimization including caching, matrix builds, path filtering, and concurrency control
6162**This skill does NOT cover:**
63- Runtime infrastructure provisioning or cloud resource management (see `engineering/saas-scaffolder`)
64- Application-level security hardening beyond CI-integrated scanning (see `engineering/skill-security-auditor`)
65- Monitoring, alerting, and observability configuration after deployment (see `engineering/observability-designer`)
66- Database migration orchestration during deployments (see `engineering/migration-architect`)
6768## Integration Points
6970| Skill | Integration | Data Flow |
71|-------|-------------|-----------|
72| `engineering/dependency-auditor` | Feeds vulnerability scan results into pipeline security gates | Auditor findings trigger pipeline failure or warning annotations |
73| `engineering/release-manager` | Coordinates versioning and changelog with deploy stages | Release tags drive conditional deployment job execution |
74| `engineering/observability-designer` | Post-deploy health checks and alerting complement pipeline gates | Pipeline triggers smoke tests; observability confirms deployment health |
75| `engineering/env-secrets-manager` | Manages secrets referenced by pipeline environment variables | Secret rotation policies feed into pipeline secret store configuration |
76| `engineering/migration-architect` | Database migrations run as a pre-deploy step in the pipeline | Migration status gates the application deployment job |
77| `engineering/runbook-generator` | Generates rollback runbooks aligned with deployment strategy | Pipeline failure triggers link to the relevant rollback runbook |
Run npx skillmds@latest add borghei/ci-cd-pipeline-builder in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Design and generate CI/CD pipelines from project stack signals across GitHub Actions, GitLab CI, CircleCI, and Buildkite. Use when bootstrapping CI, migrating pipelines, adding deployment gates, or optimizing build times. It is listed under DevOps & Infra on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free. This skill is licensed under MIT + Commons Clause.
borghei (@borghei) published this skill. Their other Agent Skills are listed on their SkillMD profile.