Add action-readme pre-commit hook

.ci/scripts/action-readme.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+# This script updates the README.md files in the directories that contain both an action.yml and a README.md file.
+# Prerequisites:
+# - gh: GitHub CLI
+#
+set -euo pipefail
+
+function find_dirs_with_action_yml_and_readme_md() {
+    find . \( -name 'action.yml' -o -name 'README.md' \) -exec dirname {} \; \
+    | sort \
+    | uniq -c \
+    | grep -E '^\s+2' \
+    | awk '{ print $2 }'
+}
+
+for dir in $(find_dirs_with_action_yml_and_readme_md); do
+  VERSION=v1 gh action-readme update --action="$dir/action.yml" --readme="$dir/README.md"
+done

.github/workflows/pre-commit.yml

@@ -13,5 +13,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+      - name: Install gh-action-readme
+        run: gh extension install reakaleek/gh-action-readme --pin v0.2.0
+        env:
+          GH_TOKEN: ${{ github.token }}
       - uses: actions/setup-python@v5
       - uses: pre-commit/[email protected]

.pre-commit-config.yaml

@@ -9,3 +9,11 @@ repos:
       - id: end-of-file-fixer
       - id: mixed-line-ending
       - id: trailing-whitespace
+  - repo: local
+    hooks:
+      - id: action-readme
+        name: action-readme
+        entry: .ci/scripts/action-readme.sh
+        language: script
+        pass_filenames: false
+        files: (action.ya?ml|README.md)$