Skip to content

borghei/Claude-Skills / engineering/devops-workflow-engineer

devops-workflow-engineer

Flagged

Generate 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.

assets/ci-template.yml

View on GitHub
# =============================================================================
# CI Workflow Template -- Python + Node.js
# =============================================================================
#
# Production-ready continuous integration workflow for projects that use both
# Python (backend/scripts) and Node.js (frontend/tooling). Includes linting,
# testing, building, and security scanning with caching and matrix strategies.
#
# Usage:
#   1. Copy this file to .github/workflows/ci.yml
#   2. Customize the variables in the env block
#   3. Adjust matrix versions to match your project
#   4. Remove sections you do not need (e.g., Node.js if Python-only)
#
# =============================================================================

name: CI

on:
  push:
    branches: [main, dev]
    paths:
      - 'src/**'
      - 'tests/**'
      - 'packages/**'
      - 'requirements*.txt'
      - 'package*.json'
      - 'Dockerfile'
      - '.github/workflows/ci.yml'
    paths-ignore:
      - '**.md'
      - 'docs/**'
      - 'LICENSE'
  pull_request:
    branches: [main]

permissions:
  contents: read

concurrency:
  group: ci-${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

# ---------------------------------------------------------------------------
# Environment variables -- customize for your project
# ---------------------------------------------------------------------------
env:
  PYTHON_DEFAULT_VERSION: '3.14'
  NODE_DEFAULT_VERSION: '24'
  # Set to 'true' to enable the Node.js jobs (remove or set 'false' for Python-only)
  ENABLE_NODE: 'true'

# ===========================================================================
# Jobs
# ===========================================================================
jobs:

  # -------------------------------------------------------------------------
  # 1. Python Lint
  # -------------------------------------------------------------------------
  python-lint:
    name: Python Lint
    runs-on: ubuntu-latest
    timeout-minutes: 5
    steps:
      - uses: actions/checkout@v7

      - uses: actions/setup-python@v7
        with:
          python-version: ${{ env.PYTHON_DEFAULT_VERSION }}
          cache: pip

      - name: Install lint tools
        run: pip install ruff

      - name: Check formatting
        run: ruff format --check .

      - name: Check linting rules
        run: ruff check .

  # -------------------------------------------------------------------------
  # 2. Python Tests (matrix)
  # -------------------------------------------------------------------------
  python-test:
    name: Python Test (${{ matrix.python-version }})
    needs: python-lint
    runs-on: ubuntu-latest
    timeout-minutes: 15
    strategy:
      fail-fast: false
      matrix:
        python-version: ['3.11', '3.12', '3.13', '3.14', '3.15']
    steps:
      - uses: actions/checkout@v7

      - uses: actions/setup-python@v7
        with:
          python-version: ${{ matrix.python-version }}
          cache: pip

      - name: Install dependencies
        run: |
          pip install --upgrade pip
          pip install -r requirements.txt
          pip install -r requirements-dev.txt 2>/dev/null || true

      - name: Run tests
        run: |
          pytest \
            --cov=src \
            --cov-report=xml:coverage.xml \
            --junitxml=results.xml \
            -v

      - name: Upload test results
        uses: actions/upload-artifact@v7
        if: always()
        with:
          name: python-test-results-${{ matrix.python-version }}
          path: |
            results.xml
            coverage.xml
          retention-days: 7

  # -------------------------------------------------------------------------
  # 3. Node.js Lint (conditional)
  # -------------------------------------------------------------------------
  node-lint:
    name: Node.js Lint
    if: ${{ vars.ENABLE_NODE != 'false' }}
    runs-on: ubuntu-latest
    timeout-minutes: 5
    steps:
      - uses: actions/checkout@v7

      - uses: actions/setup-node@v7
        with:
          node-version: ${{ env.NODE_DEFAULT_VERSION }}
          cache: npm

      - name: Install dependencies
        run: npm ci

      - name: Lint
        run: npm run lint

      - name: Type check
        run: npm run typecheck 2>/dev/null || echo "No typecheck script defined"

  # -------------------------------------------------------------------------
  # 4. Node.js Tests (conditional, matrix)
  # -------------------------------------------------------------------------
  node-test:
    name: Node.js Test (Node ${{ matrix.node-version }})
    needs: node-lint
    if: ${{ vars.ENABLE_NODE != 'false' }}
    runs-on: ubuntu-latest
    timeout-minutes: 15
    strategy:
      fail-fast: false
      matrix:
        node-version: ['22', '24', '26']
    steps:
      - uses: actions/checkout@v7

      - uses: actions/setup-node@v7
        with:
          node-version: ${{ matrix.node-version }}
          cache: npm

      - name: Install dependencies
        run: npm ci

      - name: Run tests
        run: npm test -- --coverage --ci

      - name: Upload test results
        uses: actions/upload-artifact@v7
        if: always()
        with:
          name: node-test-results-${{ matrix.node-version }}
          path: |
            coverage/
            junit.xml
          retention-days: 7

  # -------------------------------------------------------------------------
  # 5. Build Verification
  # -------------------------------------------------------------------------
  build:
    name: Build
    needs: [python-test, node-test]
    if: always() && !cancelled()
    runs-on: ubuntu-latest
    timeout-minutes: 15
    steps:
      - uses: actions/checkout@v7

      - uses: actions/setup-python@v7
        with:
          python-version: ${{ env.PYTHON_DEFAULT_VERSION }}
          cache: pip

      - uses: actions/setup-node@v7
        if: ${{ vars.ENABLE_NODE != 'false' }}
        with:
          node-version: ${{ env.NODE_DEFAULT_VERSION }}
          cache: npm

      - name: Install Python dependencies
        run: pip install -r requirements.txt

      - name: Install Node dependencies
        if: ${{ vars.ENABLE_NODE != 'false' }}
        run: npm ci

      - name: Build Python package
        run: |
          pip install build
          python -m build 2>/dev/null || echo "No Python build configured"

      - name: Build Node package
        if: ${{ vars.ENABLE_NODE != 'false' }}
        run: npm run build 2>/dev/null || echo "No Node build configured"

      - name: Build Docker image (verify only)
        if: hashFiles('Dockerfile') != ''
        run: |
          docker build \
            --tag ci-build-test:${{ github.sha }} \
            --file Dockerfile \
            .

  # -------------------------------------------------------------------------
  # 6. Security Scanning
  # -------------------------------------------------------------------------
  security:
    name: Security Scan
    needs: python-lint
    runs-on: ubuntu-latest
    timeout-minutes: 10
    steps:
      - uses: actions/checkout@v7

      - uses: actions/setup-python@v7
        with:
          python-version: ${{ env.PYTHON_DEFAULT_VERSION }}
          cache: pip

      - name: Python dependency audit
        run: |
          pip install pip-audit
          pip-audit -r requirements.txt || true

      - name: Node dependency audit
        if: hashFiles('package-lock.json') != ''
        run: npm audit --audit-level=high || true

      - name: Scan for secrets
        uses: trufflesecurity/trufflehog@main
        with:
          extra_args: --only-verified

  # -------------------------------------------------------------------------
  # 7. CI Gate (required status check)
  # -------------------------------------------------------------------------
  ci-gate:
    name: CI Gate
    if: always()
    needs: [python-lint, python-test, build, security]
    runs-on: ubuntu-latest
    timeout-minutes: 2
    steps:
      - name: Check results
        run: |
          echo "Python Lint:  ${{ needs.python-lint.result }}"
          echo "Python Test:  ${{ needs.python-test.result }}"
          echo "Build:        ${{ needs.build.result }}"
          echo "Security:     ${{ needs.security.result }}"

          if [[ "${{ needs.python-lint.result }}" == "failure" ]] || \
             [[ "${{ needs.python-test.result }}" == "failure" ]]; then
            echo "::error::Required checks failed"
            exit 1
          fi

          echo "All required checks passed."

      - name: Generate summary
        if: always()
        run: |
          echo "## CI Results" >> "$GITHUB_STEP_SUMMARY"
          echo "| Check | Status |" >> "$GITHUB_STEP_SUMMARY"
          echo "|-------|--------|" >> "$GITHUB_STEP_SUMMARY"
          echo "| Python Lint | ${{ needs.python-lint.result }} |" >> "$GITHUB_STEP_SUMMARY"
          echo "| Python Test | ${{ needs.python-test.result }} |" >> "$GITHUB_STEP_SUMMARY"
          echo "| Build | ${{ needs.build.result }} |" >> "$GITHUB_STEP_SUMMARY"
          echo "| Security | ${{ needs.security.result }} |" >> "$GITHUB_STEP_SUMMARY"
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 119kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall