Add actionlint

[a5chin]

User description

Type of Change

• Hotfix
• Bug Fix
• Dependency Update
• Feature
• Refactor
• CI/CD
• Documentation

Related Issues

Breaking Changes

• No breaking changes
• API signature changed
• Configuration changed
• Behavior changed
• Dependencies changed
• Features removed

Checklist

• Dependencies added/updated
• New environment variables
• Performance impact assessed
• Security implications reviewed
• Deployment notes

Additional Context

---

PR Type

Enhancement, Documentation

---

Description

• Introduce actionlint for GitHub Actions workflow linting.

• Integrate actionlint into pre-commit hooks for automated checks.

• Update documentation to reflect actionlint integration and usage.

• Enhance gh-deploy cache key generation for improved reliability.

---

Diagram Walkthrough

flowchart LR
  A[New actionlint.yml workflow] --> B{Lint GitHub Actions}
  C[pre-commit-config.yaml] --> D{Add actionlint hook}
  E[Documentation files] --> F{Update with actionlint info}
  G[gh-deploy.yml] --> H{Improve cache key}
  B -- "Ensures workflow quality" --> F
  D -- "Automates local checks" --> F

Loading

File Walkthrough

	Relevant files
Ci/cd	2 files actionlint.yml Add GitHub Actions workflow for `actionlint` linting.        +16/-0    gh-deploy.yml Enhance `gh-deploy` cache key generation using content hash. +3/-2
Configuration changes	2 files .pre-commit-config.yaml Integrate `actionlint` into pre-commit hooks.                        +5/-0      cspell.json Add `reviewdog` to the cspell dictionary.                                +1/-0
Documentation	4 files CLAUDE.md Document the new `actionlint.yml` GitHub Actions workflow. +1/-0      pre-commit.md Document `actionlint` pre-commit hook and configuration.  +7/-0      index.md Include `actionlint` in the list of development tools.      +1/-0      index.md Highlight `actionlint` as a new repository feature.            +1/-0
Formatting	1 files index.md Improve formatting of the configuration files table.          +9/-9

---

[a5chin]

/review

[github-actions]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 3 🔵🔵🔵⚪⚪

🧪 No relevant tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Cache Strategy The cache key for mkdocs-material is generated based on the UTC week number, leading to weekly cache invalidation. Evaluate if this weekly invalidation is the optimal strategy for the cached content. If the cached items (e.g., dependencies or build artifacts) do not change weekly, a more stable key (e.g., based on a hash of relevant dependency files) might improve cache hit rates and build efficiency. id: cache run: echo "id=$(date --utc '+%V')" >> "$GITHUB_OUTPUT" - name: Save cache uses: actions/cache@v5 with: key: mkdocs-material-${{ steps.cache.outputs.id }}

[a5chin]

/improve