Add actionlint

.github/workflows/actionlint.yml

@@ -0,0 +1,16 @@
+name: Lint GitHub Actions workflows
+
+on:
+  pull_request:
+    paths:
+      - .github/workflows/*.yml
+
+jobs:
+  actionlint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Check workflow files
+        uses: reviewdog/action-actionlint@v1

.github/workflows/gh-deploy.yml

@@ -33,12 +33,13 @@ jobs:
         uses: ./.github/actions/setup-python-with-uv
 
       - name: Generate cache id
-        run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+        id: cache
+        run: echo "id=$(date --utc '+%V')" >> "$GITHUB_OUTPUT"
 
       - name: Save cache
         uses: actions/cache@v5
         with:
-          key: mkdocs-material-${{ env.cache_id }}
+          key: mkdocs-material-${{ steps.cache.outputs.id }}
           path: .cache
           restore-keys: mkdocs-material-
 

.pre-commit-config.yaml

@@ -52,6 +52,11 @@ repos:
         language: python
         types: [python]
 
+  - repo: https://github.com/rhysd/actionlint
+    rev: v1.7.10
+    hooks:
+      - id: actionlint
+
   - repo: https://github.com/hadolint/hadolint
     rev: v2.12.0
     hooks:

.vscode/cspell.json

@@ -87,6 +87,7 @@
         "pyupgrade",
         "qodo",
         "redoc",
+        "reviewdog",
         "rootdir",
         "ropeproject",
         "scrapy",

CLAUDE.md

@@ -252,6 +252,7 @@ When adding new utilities to `tools/`, add corresponding documentation to `docs/
 ## CI/CD Workflows
 
 GitHub Actions workflows in `.github/workflows/`:
+- **actionlint.yml**: Lint GitHub Actions workflows
 - **docker.yml**: Validate Docker build
 - **devcontainer.yml**: Validate Dev Container configuration
 - **format.yml**: Check Ruff formatting

docs/configurations/pre-commit.md

@@ -13,6 +13,8 @@
 - [https://github.com/sqlfluff/sqlfluff](https://github.com/sqlfluff/sqlfluff)
     - SQLFluff Lint
     - SQLFluff Fix
+- [https://github.com/rhysd/actionlint](https://github.com/rhysd/actionlint)
+    - actionlint
 - [https://github.com/hadolint/hadolint](https://github.com/hadolint/hadolint)
     - Hadolint
 
@@ -44,6 +46,11 @@ repos:
         name: Ruff format
         description: "Run 'ruff format' for extremely fast Python formatting"
 
+  - repo: https://github.com/rhysd/actionlint
+    rev: v1.7.10
+    hooks:
+      - id: actionlint
+
   - repo: https://github.com/hadolint/hadolint
     rev: v2.12.0
     hooks:

docs/guides/index.md

@@ -10,6 +10,7 @@ This template includes several modern Python development tools, each serving a s
 - **Ruff** - Lightning-fast linting and formatting
 - **ty** - Advanced type checking
 - **SQLFluff** - SQL linting and formatting
+- **actionlint** - GitHub Actions workflow linting
 - **pytest** - Comprehensive testing framework
 - **nox** - Task automation and workflow management
 - **pre-commit** - Automated code quality checks

docs/index.md

@@ -15,6 +15,7 @@ This repository provides a complete, batteries-included development environment
 - **Ultra-fast package management** - [uv](https://github.com/astral-sh/uv) is 10-100x faster than pip
 - **Lightning-fast code quality** - [Ruff](https://github.com/astral-sh/ruff) replaces Black, isort, Flake8, and more
 - **SQL linting** - [SQLFluff](https://github.com/sqlfluff/sqlfluff) for SQL code quality
+- **GitHub Actions linting** - [actionlint](https://github.com/rhysd/actionlint) for workflow file quality
 - **Type safety** - ty for comprehensive type checking
 - **Automated testing** - pytest with 75% coverage requirement
 - **Task automation** - nox for streamlined development workflows