borghei/Claude-Skills / engineering/devops-workflow-engineer
devops-workflow-engineer
UnverifiedGenerate and optimize GitHub Actions CI/CD workflows. Use when designing workflows, planning multi-environment deployments, optimizing pipeline cost and runtime, or implementing blue-green, canary, or rolling deployment strategies.
DevOps Workflow Engineer
Generate GitHub Actions workflow YAML, analyze existing pipelines for optimization opportunities, and create deployment plans with strategy selection, health checks, and rollback procedures.
Core Capabilities
- CI pipeline design — fail-fast job ordering (lint → unit → build → integration → security) with matrix testing and CI time/flake/cache targets.
- CD & multi-environment — dev/staging/prod promotion flows, build-once-deploy-everywhere, environment protection rules, and rollback at every stage.
- Pipeline optimization — detect missing caching, missing timeouts, serial chains, deprecated actions, leaked secrets, and oversized runners; apply path filtering and concurrency cancellation.
- Deployment strategies — choose blue-green, canary, or rolling via decision tree; canary traffic-split schedule with promotion gates.
- GitHub Actions patterns — reusable workflows, OIDC auth, secrets hierarchy, and runner cost estimation.
When to Use
- Designing a new CI or CD workflow from scratch.
- Planning a multi-environment (dev/staging/prod) deployment.
- Optimizing an existing pipeline's cost or runtime.
- Implementing a blue-green, canary, or rolling deployment strategy.
Clarify First
Before generating the workflow, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.
- Workflow type: CI, CD, release, or security-scan (sets
workflow_generator.py --type). - Stack: language and test framework (e.g. python/pytest) (drives the generated YAML steps via
--language/--test-framework). - Deployment strategy & environments: blue-green, canary, or rolling, and which of dev/staging/prod (drives the
deployment_planner.pyplan).
Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.
Workflow
- Decide what CI is for. Many teams run the test suite locally before pushing and let CI only lint, build and deploy; others gate merges on CI tests. Ask, and generate with
--no-testsfor the first case. - Generate the workflow with
workflow_generator.py(CI, CD, release, security-scan or docs-check) and adapt the install, lint and deploy commands to the repository. - Harden it: least-privilege
permissions:, OIDC instead of long-lived cloud keys,timeout-minuteson every job, concurrency cancellation, and third-party actions pinned to a full commit SHA (tools such as Dependabot or pinact keep SHA pins current). The generator emits major-version tags (for exampleactions/checkout@v7) for readability; in production, pin each one to its full commit SHA with the tag as a comment. - Analyze the result and any existing workflows with
pipeline_analyzer.py; fix every critical finding. - Plan the rollout with
deployment_planner.py(blue-green, canary or rolling) and wire its health checks and rollback steps into the CD job. - Verify on a branch: the workflow runs green, a deliberately failing step fails the run, and a rollback has been rehearsed.
Quick Start
python3 scripts/workflow_generator.py --type ci --language python --test-framework pytest
python3 scripts/workflow_generator.py --type ci --language node --no-tests --branches main
python3 scripts/pipeline_analyzer.py assets/sample_flawed_workflow.yml # hard-coded key, v2 actions, no timeouts (exit 1)
python3 scripts/pipeline_analyzer.py assets/ci-template.yml # info only (exit 0)
python3 scripts/deployment_planner.py --type webapp --environments dev,staging,prod --strategy canary
Tools Overview
| Tool | What it does | Key flags | Exit codes |
|---|---|---|---|
workflow_generator.py | GitHub Actions YAML for ci, cd, release, security-scan, docs-check in python, node, go or rust; CD targets kubernetes, docker compose, ECS, static | --type, --language, --test-framework, --deploy-target, --branches, --no-tests, `--format yaml | json` |
pipeline_analyzer.py | Missing caching/timeouts/permissions, serial chains, outdated actions, possible hard-coded secrets, oversized runners, cost estimate | <file-or-dir>, `--format json | text` |
deployment_planner.py | Strategy, stages, health checks and rollback per environment | --type, --environments, --strategy, --format | 0, 2 bad input |
Generated versions as of November 2026: Python 3.11-3.15 (default 3.14), Node 22, 24 and 26 LTS (default 24), Go oldstable/stable aliases, Rust stable/beta; GitHub actions checkout@v7, setup-python@v7, setup-node@v7, setup-go@v7, cache@v6, upload-artifact@v7, download-artifact@v8. Check them against current support schedules and releases before relying on them.
Anti-Patterns
Mistake: Pinning actions to a tag such as @v7 in production.
Why it happens: Tags read well and update automatically.
Instead: Tags can be moved to malicious commits. Pin to a full SHA with a comment naming the version, and let a bot bump it.
Mistake: Storing cloud credentials as repository secrets for deploys. Why it happens: It is the quickest way to get a deploy working. Instead: Use OIDC federation to the cloud provider with a role scoped to the environment.
Mistake: Running the full suite in CI when the team already runs it locally, and calling the duplicate "safety".
Why it happens: CI templates include a test job by default.
Instead: Decide where tests run. If locally, generate --no-tests and keep CI for lint, build, deploy and environment-only checks such as migration rehearsal.
Files
scripts/workflow_generator.py,scripts/pipeline_analyzer.py,scripts/deployment_planner.py— the tools above.assets/ci-template.yml,assets/cd-template.yml— reference workflows;assets/sample_flawed_workflow.yml— analyzer demo with a fake placeholder key.
Reference Documentation
Load the reference that matches the task — keep this file lean and pull detail on demand:
- references/workflows-and-optimization.md — the CI / CD / optimization workflows with full YAML, deployment-strategy decision tree and canary schedule, GitHub Actions patterns, runner cost table, anti-patterns, and troubleshooting. Read when building or tuning a pipeline.
- references/github-actions-patterns.md — deep GitHub Actions pattern library. Read when authoring advanced workflow YAML.
- references/deployment-strategies.md — deep deployment strategy guide (blue-green, canary, rolling). Read when planning a release rollout.
- references/agentic-workflows-guide.md — agentic/automated workflow patterns. Read when wiring up AI-driven or autonomous pipeline steps.
Scope & Limitations
In Scope:
- Generating GitHub Actions YAML with
workflow_generator.pyfor CI, CD, release, security-scan and docs-check workflows in Python, Node, Go or Rust, with CD targets for Kubernetes, Docker Compose, AWS ECS or static hosting - Analyzing existing workflow files with
pipeline_analyzer.pyfor missing caching and timeouts, serial job chains, deprecated actions, possible leaked secrets and oversized runners, with severity ratings and cost estimates - Deployment plans from
deployment_planner.pyfor blue-green, canary or rolling releases, with health checks and rollback steps per environment - Patterns for reusable workflows, OIDC authentication, secrets hierarchy and multi-environment promotion from the references
Out of Scope:
- CI systems other than GitHub Actions, such as GitLab CI, CircleCI and Buildkite (see
engineering/ci-cd-pipeline-builder/) - Provisioning infrastructure (see
engineering/terraform-patterns/andengineering/senior-devops/) - Versioning, changelogs and release coordination (see
engineering/release-orchestrator/) - Helm chart authoring and review (see
engineering/helm-chart-builder/) - Running deployments or watching live rollouts; the tools produce files and plans only
Important Caveats:
- Generated workflows are templates. Secrets, environment names, deploy commands and action versions need review before the workflow runs.
- The analyzer parses YAML with a minimal built-in parser and pattern checks. Complex anchors, expressions and reusable-workflow calls can be misread, and it does not run the workflow.
- Runner cost estimates use a fixed per-minute table for GitHub-hosted runners. GitHub pricing and runner images change, so treat the numbers as rough.
- Action versions and deprecations go stale quickly. Check pinned actions against their current releases.
Integration Points
| Skill | Integration |
|---|---|
release-orchestrator | Release workflows align with versioning and changelog |
senior-devops | Deployment strategies complement infra automation |
senior-secops | Security scanning steps feed SecOps dashboards |
senior-qa | CI quality gates map to QA acceptance criteria |
incident-commander | Rollback procedures connect to incident playbooks |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 195k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 117k | Updated | Claude CodeCodex | Unverified | Install |
| paperclip-pagepaperclipai/paperclipPublish static HTML pages and asset folders to the Paperclip S3/CloudFront page host. Use when asked to deploy, host, or share a persistent page, viewer, prototype, report, or static site without here.now. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |