github-actions-pipeline-creator — Claude Code skill: CI setup
github-actions-pipeline-creator builds GitHub Actions workflows for linting, tests, builds, and deployment. Useful when a project needs caching, matrix runs, artifacts, or failure reports.
MIT 288 installs ★ 64 updated 2026-01-12
npx skills add patricio0312rev/skills --skill github-actions-pipeline-creator -a claude-codeWhat github-actions-pipeline-creator does
This skill helps shape workflows such as .github/workflows/ci.yml, with separate jobs for linting, tests, and builds. The examples use actions/checkout@v4, actions/setup-node@v4, npm ci, ESLint, Prettier, TypeScript checks, and coverage upload through codecov/codecov-action@v3. The build waits for lint and test, then stores dist as an artifact.
It also covers test matrices across ubuntu-latest, macos-latest, and windows-latest, dependency and build caches, Docker Buildx, image publishing, and deployment with amondnet/vercel-action@v25. Other examples add a composite action and collect test results after failures. Docker Hub publishing uses the DOCKER_USERNAME and DOCKER_PASSWORD secrets; without them, the registry login step cannot complete.
What it helps with
- create CI jobs for linting, tests, and TypeScript
- run tests across several operating systems and Node.js versions
- cache npm dependencies and build output
- store coverage and test results as artifacts
- build and publish a Docker image
Example prompts for the agent
- Create
.github/workflows/ci.ymlwith lint, test, build, anddistartifact jobs. - Set up a GitHub Actions matrix for
ubuntu-latest,macos-latest, andwindows-latestwith Node.js18,20, and21, excluding Windows with Node.js18. - Configure
.github/workflows/deploy.ymlto deploy throughamondnet/vercel-action@v25tostagingandproduction.
How to install github-actions-pipeline-creator
1Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill github-actions-pipeline-creator -a claude-code2Manually: put the files in place
~/.claude/skills/github-actions-pipeline-creator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/github-actions-pipeline-creator/
1Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill github-actions-pipeline-creator -a codex2Manually: put the files in place
.agents/skills/github-actions-pipeline-creator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill github-actions-pipeline-creator -a cursor2Manually: put the files in place
.cursor/skills/github-actions-pipeline-creator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install patricio0312rev/skills ci-cd/github-actions-pipeline-creator/SKILL.md2Manually: put the files in place
.github/skills/github-actions-pipeline-creator/SKILL.md1Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill github-actions-pipeline-creator -a gemini-cli2Platform CLI
gemini skills install https://github.com/patricio0312rev/skills --path ci-cd/github-actions-pipeline-creatorManually: put the files in place
.devin/skills/github-actions-pipeline-creator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill github-actions-pipeline-creator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about github-actions-pipeline-creator
How do I install github-actions-pipeline-creator in Claude Code?
Run npx skills add patricio0312rev/skills --skill github-actions-pipeline-creator -a claude-code, then check ~/.claude/skills/github-actions-pipeline-creator/SKILL.md.
What does github-actions-pipeline-creator do?
It helps create GitHub Actions workflows for linting, testing, building, and deployment. The included patterns also cover caches, job matrices, artifacts, and failure diagnostics.
Which environments are used in its test matrix?
The example covers ubuntu-latest, macos-latest, and windows-latest with Node.js 18, 20, and 21. Windows with Node.js 18 is excluded.
Source text
SKILL.md · MIT
---
name: github-actions-pipeline-creator
description: Creates comprehensive GitHub Actions CI/CD workflows for linting, testing, building, and deploying. Includes caching strategies, matrix builds, artifact handling, and failure diagnostics. Use for "GitHub Actions", "CI pipeline", "workflow automation", or "continuous integration".
---
# GitHub Actions Pipeline Creator
Build production-ready GitHub Actions workflows with best practices.
## Basic CI Workflow
```yaml
# .github/workflows/ci.yml
name: CI
on:
push:
branches: [main, develop]
pull_request:
branches: [main]
# Cancel in-progress runs for same workflow
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
jobs:
lint:
name: Lint
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"
- name: Install dependencies
run: npm ci
- name: Run ESLint
run: npm run lint
- name: Run Prettier
run: npm run format:check
- name: Run TypeScript
run: npm run type-check
test:
name: Test
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"
- name: Install dependencies
run: npm ci
- name: Run tests
run: npm test -- --coverage
- name: Upload coverage
uses: codecov/codecov-action@v3
with:
files: ./coverage/coverage-final.json
flags: unittests
fail_ci_if_error: true
build:
name: Build
runs-on: ubuntu-latest
needs: [lint, test]
steps:
- uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"
- name: Install dependencies
run: npm ci
- name: Build
run: npm run build
env:
NODE_ENV: production
- name: Upload build artifacts
uses: actions/upload-artifact@v4
with:
name: dist
path: dist/
retention-days: 7
```
## Matrix Strategy
```yaml
test:
name: Test
runs-on: ${{ matrix.os }}
strategy:
matrix:
os: [ubuntu-latest, macos-latest, windows-latest]
node-version: [18, 20, 21]
exclude:
# Skip Windows + Node 18 (slow)
- os: windows-latest
node-version: 18
fail-fast: false
steps:
- uses: actions/checkout@v4
- name: Setup Node.js ${{ matrix.node-version }}
uses: actions/setup-node@v4
with:
node-version: ${{ matrix.node-version }}
cache: "npm"
- run: npm ci
- run: npm test
```
## Advanced Caching
```yaml
- name: Cache dependencies
uses: actions/cache@v3
with:
path: |
~/.npm
node_modules
.next/cache
key: ${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}
restore-keys: |
${{ runner.os }}-npm-
- name: Cache build
uses: actions/cache@v3
with:
path: |
dist
.cache
key: build-${{ github.sha }}
restore-keys: |
build-
```
## Docker Build & Push
```yaml
docker:
name: Build & Push Docker
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v3
- name: Login to Docker Hub
uses: docker/login-action@v3
with:
username: ${{ secrets.DOCKER_USERNAME }}
password: ${{ secrets.DOCKER_PASSWORD }}
- name: Extract metadata
id: meta
uses: docker/metadata-action@v5
with:
images: mycompany/myapp
tags: |
type=ref,event=branch
type=ref,event=pr
type=semver,pattern={{version}}
type=sha
- name: Build and push
uses: docker/build-push-action@v5
with:
context: .
push: true
tags: ${{ steps.meta.outputs.tags }}
labels: ${{ steps.meta.outputs.labels }}
cache-from: type=registry,ref=mycompany/myapp:buildcache
cache-to: type=registry,ref=mycompany/myapp:buildcache,mode=max
```
## Deployment Workflow
```yaml
# .github/workflows/deploy.yml
name: Deploy
on:
push:
branches: [main]
workflow_dispatch:
inputs:
environment:
description: "Environment to deploy to"
required: true
type: choice
options:
- staging
- production
jobs:
deploy:
name: Deploy to ${{ github.event.inputs.environment || 'staging' }}
runs-on: ubuntu-latest
environment:
name: ${{ github.event.inputs.environment || 'staging' }}
url: https://${{ steps.deploy.outputs.url }}
steps:
- uses: actions/checkout@v4
- name: Download artifacts
uses: actions/download-artifact@v4
with:
name: dist
path: dist/
- name: Deploy to Vercel
id: deploy
uses: amondnet/vercel-action@v25
with:
vercel-token: ${{ secrets.VERCEL_TOKEN }}
vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
vercel-args: ${{ github.event.inputs.environment == 'production' && '--prod' || '' }}
```
## Failure Diagnostics
```yaml
- name: Run tests
id: test
run: npm test
continue-on-error: true
- name: Upload test results
if: always()
uses: actions/upload-artifact@v4
with:
name: test-results
path: |
test-results/
coverage/
- name: Comment PR with results
if: failure() && github.event_name == 'pull_request'
uses: actions/github-script@v7
with:
script: |
github.rest.issues.createComment({
issue_number: context.issue.number,
owner: context.repo.owner,
repo: context.repo.repo,
body: '❌ Tests failed. Check the [test results](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }})'
})
- name: Fail if tests failed
if: steps.test.outcome == 'failure'
run: exit 1
```
## Composite Actions
```yaml
# .github/actions/setup-node/action.yml
name: "Setup Node.js with Cache"
description: "Setup Node.js and restore cache"
inputs:
node-version:
description: "Node.js version"
required: false
default: "20"
runs:
using: "composite"
steps:
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: ${{ inputs.node-version }}
cache: "npm"
- name: Install dependencies
shell: bash
run: npm ci
# Usage in workflow:
# - uses: ./.github/actions/setup-node
# with:
# node-version: '20'
```
## Conditional Jobs
```yaml
lint:
if: github.event_name == 'pull_request'
runs-on: ubuntu-latest
steps: [...]
deploy:
if: github.ref == 'refs/heads/main' && github.event_name == 'push'
needs: [build, test]
runs-on: ubuntu-latest
steps: [...]
```
## Best Practices
1. **Cache dependencies**: Speeds up 3-5x
2. **Parallel jobs**: Run lint/test/build concurrently
3. **Matrix strategy**: Test multiple versions/platforms
4. **Fail fast**: Stop on first failure (or not)
5. **Upload artifacts**: Debug failures
6. **Concurrency control**: Cancel outdated runs
7. **Secrets management**: Never log secrets
8. **Status checks**: Require passing CI
## Output Checklist
- [ ] Lint job configured
- [ ] Test job with coverage
- [ ] Build job with artifacts
- [ ] Deploy job with environments
- [ ] Caching strategy implemented
- [ ] Matrix builds (if needed)
- [ ] Failure diagnostics
- [ ] PR comments on failure
- [ ] Docker build (if needed)
- [ ] Status badges in README
© patricio0312rev · MIT · patricio0312rev/skills