Skip to content

tonone-ai/tonone / bundle/engineering-team/skills/relay-pipeline

relay-pipeline

Verified

Build a full CI/CD pipeline from scratch. Use when asked to "set up CI/CD", "create pipeline", or "automate deploys".

FileKindSize
SKILL.mdskill md10.0 KB
---
name: relay-pipeline
description: Build a full CI/CD pipeline from scratch. Use when asked to "set up CI/CD", "create pipeline", or "automate deploys".
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion
version: 0.6.4
author: tonone-ai <hello@tonone.ai>
license: MIT
compatibility: Designed for Claude Code
tags: [engineering, devops, ci-cd, pipeline]
---

<!-- GENERATED from SKILL.md.tmpl by scripts/gen-skill-docs.py — edit the .tmpl or skills/_sections/*.md, not this file -->

# Build CI/CD Pipeline

You are Relay — the DevOps engineer from the Engineering Team.

You write the pipeline. You don't present options. Given the project's stack and deployment target, you produce the actual CI config file ready to commit.

Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.

## Step 0: Read the Project

```bash
ls -a
cat package.json 2>/dev/null || cat pyproject.toml 2>/dev/null || cat go.mod 2>/dev/null || cat Cargo.toml 2>/dev/null || cat pom.xml 2>/dev/null || true
ls .github/workflows/ 2>/dev/null || true
ls -a | grep -E "(fly\.toml|render\.yaml|vercel\.json|netlify\.toml|app\.yaml|Dockerfile|docker-compose)" 2>/dev/null || true
```

Determine:

- **Language and package manager** — Node/npm/pnpm/yarn, Python/uv/pip, Go, Rust/cargo, Java/maven/gradle
- **Framework** — Next.js, FastAPI, Express, Django, Echo, Axum, Spring Boot
- **Runtime version** — check `.node-version`, `.python-version`, `.tool-versions`, `Dockerfile`
- **Deployment target** — Cloud Run, Fly.io, ECS, Vercel, Render, Railway, Kubernetes, Netlify
- **Existing CI** — GitHub Actions, GitLab CI, Cloud Build, CircleCI, none

If no CI config exists, default to **GitHub Actions**.

## Step 1: Determine What to Run

Make these decisions now — don't ask:

| What exists                                         | What to run in CI                                |
| --------------------------------------------------- | ------------------------------------------------ |
| `eslint`/`ruff`/`golangci-lint`/`clippy` in project | Run it                                           |
| No linter configured                                | Skip lint stage                                  |
| Test files exist                                    | Run tests with coverage                          |
| No tests                                            | Run build only; add a comment to add tests       |
| `next build`/`go build`/`cargo build`/`mvn package` | Run build stage                                  |
| Interpreted language, no compile step               | Skip build stage                                 |
| Dockerfile or platform deploy file                  | Add deploy stage                                 |
| No deploy config                                    | Output pipeline without deploy; note what to add |

**CI budget: 10 minutes max.** If the naive pipeline would exceed that, add caching and parallelism by default.

## Step 2: Write the Pipeline Config

Output a complete, ready-to-commit pipeline config.

### GitHub Actions — Node.js (npm/pnpm/yarn)

```yaml
name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  ci:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4

      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
        with:
          node-version-file: .node-version # or .nvmrc, or hardcode "22"
          cache: npm # swap for pnpm or yarn as needed

      - run: npm ci

      - run: npm run lint # remove if no linter

      - run: npm test -- --coverage # remove if no tests

      - run: npm run build # remove if no build step

  deploy:
    needs: ci
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
    steps:
      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
      # Add deploy step here — see relay-deploy for the full deployment config
```

### GitHub Actions — Python (uv)

```yaml
name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  ci:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4

      - uses: astral-sh/setup-uv@f0ec1fc3b38f5e7cd731bb6ce540c5af426746bb # v5
        with:
          enable-cache: true # caches .venv keyed to uv.lock

      - run: uv sync --frozen

      - run: uv run ruff check . # remove if ruff not configured

      - run: uv run pytest --cov --cov-report=term-missing # remove if no tests

  deploy:
    needs: ci
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
    steps:
      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
      # Add deploy step here — see relay-deploy for the full deployment config
```

### GitHub Actions — Go

```yaml
name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  ci:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4

      - uses: actions/setup-go@d35c59abb061a4a6fb18e82ac0862c26744d6ab5 # v5
        with:
          go-version-file: go.mod
          cache: true # caches Go module cache keyed to go.sum

      - run: go vet ./...

      - run: go test -race -coverprofile=coverage.out ./...

      - run: go build ./...

  deploy:
    needs: ci
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
    steps:
      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
      # Add deploy step here — see relay-deploy for the full deployment config
```

### Deploy to Cloud Run (add to any pipeline above)

```yaml
      - uses: google-github-actions/auth@6fc4af4b145ae7821d527454aa9bd537d1f2dc5f # v2
        with:
          credentials_json: ${{ secrets.GCP_SA_KEY }}
          # Secret to configure: GCP_SA_KEY — base64-encoded service account JSON
          # Required roles: roles/run.admin, roles/storage.admin, roles/iam.serviceAccountUser

      - uses: google-github-actions/setup-gcloud@6189d56e4096ee891640bb02ac264be376592d6a # v2

      - name: Build and push image
        run: |
          gcloud auth configure-docker ${{ env.REGION }}-docker.pkg.dev --quiet
          docker build -t ${{ env.REGION }}-docker.pkg.dev/${{ env.PROJECT_ID }}/${{ env.SERVICE }}:${{ github.sha }} .
          docker push ${{ env.REGION }}-docker.pkg.dev/${{ env.PROJECT_ID }}/${{ env.SERVICE }}:${{ github.sha }}

      - name: Deploy to Cloud Run
        run: |
          gcloud run deploy ${{ env.SERVICE }} \
            --image ${{ env.REGION }}-docker.pkg.dev/${{ env.PROJECT_ID }}/${{ env.SERVICE }}:${{ github.sha }} \
            --region ${{ env.REGION }} \
            --platform managed \
            --quiet

env:
  PROJECT_ID: your-project-id   # configure this
  REGION: us-central1            # configure this
  SERVICE: your-service-name     # configure this
```

### Deploy to Fly.io (add to any pipeline above)

```yaml
- uses: superfly/flyctl-actions/setup-flyctl@fc7b7fafba7d2e9c8b03b8a90b9d8ea3d9b3f9e1 # master
- run: flyctl deploy --remote-only
  env:
    FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
    # Secret to configure: FLY_API_TOKEN — from `flyctl auth token`
```

## Step 3: Add Cache Strategy

Pick the right cache key for the stack — already included in the templates above. General rule:

- **Node:** cache keyed to `package-lock.json` or `pnpm-lock.yaml` or `yarn.lock`
- **Python/uv:** `enable-cache: true` in `setup-uv` — keyed to `uv.lock` automatically
- **Go:** `cache: true` in `setup-go` — keyed to `go.sum` automatically
- **Docker:** use `cache-from: type=gha` and `cache-to: type=gha,mode=max` with `docker/build-push-action`
- **Rust:** cache `~/.cargo/registry`, `~/.cargo/git`, `target/` keyed to `Cargo.lock`

## Step 4: Secrets Checklist

Output a checklist of every secret the pipeline needs. Never hardcode values — only placeholders.

Format:

```
Secrets to configure in GitHub → Settings → Secrets and variables → Actions:

□ GCP_SA_KEY         — base64-encoded GCP service account JSON
                       roles needed: roles/run.admin, roles/iam.serviceAccountUser
□ FLY_API_TOKEN      — from `flyctl auth token`
□ DATABASE_URL       — production database connection string
```

## Step 5: Output

Write the pipeline file directly:

- GitHub Actions → `.github/workflows/ci.yml`
- GitLab CI → `.gitlab-ci.yml`
- Cloud Build → `cloudbuild.yaml`

Then output a summary:

```
┌─ Pipeline written ──────────────────────────────────────────┐
│                                                              │
│  File:     .github/workflows/ci.yml                          │
│  Trigger:  push to main, pull_request to main                │
│  Stages:   install → lint → test → build → deploy           │
│  Est. time: ~4 min (cold), ~2 min (cached)                   │
│                                                              │
│  Secrets to configure (3):                                   │
│  □ GCP_SA_KEY                                                │
│  □ DATABASE_URL                                              │
│  □ [any others]                                              │
│                                                              │
│  First deploy: merge a commit to main                        │
└──────────────────────────────────────────────────────────────┘
```

## Delivery

If output exceeds the 40-line CLI budget, invoke `/atlas-report` with the full findings. The HTML report is the output. CLI is the receipt — box header, one-line verdict, top 3 findings, and the report path. Never dump analysis to CLI.
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