Skip to content

Investigate: composite actions vs. re-usable workflows #10

Description

@woutdenolf

Activity

  1. woutdenolf commented on Mar 25, 2026

    @woutdenolf
    MemberAuthor

    LLM:

    Feature Composite Action Reusable Workflow
    Level Step Job / Workflow
    Can define jobs ❌ ✅
    Matrix support ❌ ✅
    Secrets handling Limited Full
    Use case Small reusable logic Full CI/CD pipelines
    Called via uses: in steps uses: in jobs
    • If it fits inside a single job step → use a composite action
    • If it involves multiple jobs or environments → use a reusable workflow

    Keep as reusable workflow if it:

    • Defines jobs (jobs:)
    • Uses runs-on
    • Has multiple jobs or dependencies
    • Uses matrix builds
    • Needs secrets or environments
    • Represents a full pipeline step (CI, release, deploy)

    👉 These cannot be composite actions by design

  2. loichuder commented on Mar 25, 2026

    @loichuder
    Member

    Nice summary 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Fields

    priority

    None yet

    progress

    planned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions