📋 TIL you can create your own GitHub Actions workflow templates

So you know how there's this wizard that you can use to create new GitHub Actions right? It turns out that there's a way to add your own GitHub Actions templates there!

All you need to do is add a workflow-templates/*.yml and workflow-templates/*.properties.json pair in your user/.github repository. This works for both organizations (like the official GitHub docs say) and regular users.

workflow-templates/say-hi.yml

name: Say hi!
on:
  push:
    branches: [$default-branch]
jobs:
  say-hi:
    runs-on: ubuntu-latest
    steps:
      - name: Echo "Hi!" to the user
        run: echo "Hi!"

workflow-templates/say-hi.properties.json

{
    "name": "Say hi!",
    "description": "Says hi to the user",
    "iconName": "emoji-wave",
    "categories": ["Automation"],
    "filePatterns": ["README.md"]
}

workflow-templates/emoji-wave.svg

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
  <text y="75px" font-size="75px">👋</text>
</svg>

📚 Further reading: Creating starter workflows for your organization (also works for users too)

How you might want to use this

A great way to take advantage of this template feature is to make workflow templates for things you do often or in every repository. Think like...

1. Node.js test.yml workflow
2. Workflow to deploy to GitHub Pages from npm run build
3. Mirroring wiki/ to the GitHub wiki page
4. Enabling /help in any issue

Anything that is arduous to re-type or re-reason about (like something that has complex on: * or permissions: * properties) on the workflow level is something that is a good candidate for a template.