github-actions-workflows

GitHub Actions Workflows

Expert guidance for designing reliable, secure, and performant GitHub Actions CI/CD pipelines with patterns for matrix builds, reusable workflows, caching, and deployment automation.

When to Use This Skill

• Setting up CI/CD pipelines with GitHub Actions from scratch
• Optimizing slow or expensive GitHub Actions workflows
• Implementing matrix builds for multi-environment testing
• Creating reusable workflows and composite actions for DRY pipelines
• Managing secrets securely across environments
• Configuring caching for dependency and build artifact reuse
• Setting up deployment workflows with staging and production gates
• Debugging failing or flaky workflow runs
• Implementing concurrency controls to prevent duplicate runs

Quick Reference

Task	Load reference
Matrix builds, reusable workflows, caching, deployment, concurrency	skills/github-actions-workflows/references/workflow-patterns.md

Core Principles

• Structured jobs: Break workflows into clear, distinct jobs with defined dependencies
• DRY configuration: Use reusable workflows and composite actions to avoid duplication
• Security first: Use GitHub secrets, OIDC, and minimum necessary permissions
• Cache aggressively: Cache dependencies, build outputs, and test fixtures
• Trigger thoughtfully: Configure event triggers to avoid unnecessary workflow runs
• Document workflows: Add comments explaining non-obvious YAML configuration

Workflow

1. Design

Plan the pipeline structure before writing YAML.

• Identify trigger events (push, pull_request, schedule, workflow_dispatch)
• Map job dependencies and what can run in parallel
• Determine caching opportunities (dependencies, build outputs)
• Plan environment promotion (dev, staging, production)

2. Implementation

Build the pipeline incrementally.

• Start with a minimal workflow and add complexity
• Use matrix builds for multi-environment testing
• Extract reusable workflows for shared patterns
• Configure secrets management with environment protection