Reusable GitHub Workflows

I want to reuse a workflow run from another repository. Turns out it is quite easy to do so. Here is an example.

In Target Repo:

name: Reusable Workflow
on:
  workflow_call:
    inputs:
      name:
        required: true
        type: string

jobs:
  example_job:
    runs-on: ubuntu-latest
    steps:
      - run: echo "Hello, ${{ inputs.name }}!"

In Source Repo:

name: Call Remote Workflow
on: [push]

jobs:
  call-workflow:
    uses: TARGET_REPOSITORY_OWNER/TARGET_REPOSITORY/.github/workflows/REUSABLE_WORKFLOW_FILE.yml@main
    with:
      name: 'Your Name'

Simple as that. However, there are a few gotchas.

• The triggered action runs on Source Repo, not Target Repo! For triggering an action run on Target Repo, use repository dispatch event.
• Permission. Of course. Both repo should belong to the same organization or user. However, a public repository cannot use workflows in a private repository, even if they belong to the same user or organization.
• There is a setting that must be turned on in Target Repo.