ci(pre-commit): add action-docs

.pre-commit-config.yaml

@@ -23,3 +23,10 @@ repos:
       - id: actionlint
         # actionlint doesn't like the uses: ./
         exclude: ci.yaml
+  - repo: local
+    hooks:
+      - id: update-action-readme
+        name: update-action-readme
+        entry: ./script/update-action-readme
+        language: script
+        files: '.*/action\.yaml$'

script/update-action-readme

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+set -e
+
+for i in $*; do
+  # ignore if the file does not end with /action.yaml
+  if [[ "$i" != *"action.yaml" ]]; then
+    echo "skipping: ${i}"
+    continue
+  fi
+  readme_file=$(dirname "$i")/README.md
+  echo "npx action-docs --no-banner -s "${i}""
+  npx action-docs@2 --no-banner -s "${i}" -u "${readme_file}"
+done