Action — actionlint
Validates GitHub Actions workflow files with actionlint.
Usage
yaml
steps:
- uses: actions/checkout@v7
- uses: KevinDeBenedetti/github-workflows/.github/actions/actionlint@main
with:
paths: .github/workflows/Inputs
| Input | Type | Default | Description |
|---|---|---|---|
paths | string | .github/workflows/ | Space-separated list of workflow files or directories to validate |
flags | string | '' | Extra flags passed to actionlint (e.g. -ignore 'SC2086') |
Steps
- Download and install
actionlint1.7.11into$RUNNER_TEMP/actionlint - Collect all
.yml/.yamlfiles from the given paths - Run
actionlint [flags] <files>
Notes
When
pathspoints to a directory, all.ymland.yamlfiles within it are collected recursively.Use
flags: '-ignore SC2086'to suppress specific ShellCheck rules that actionlint embeds.actionlint is downloaded fresh each run; no system-wide install is required.
actionlint does not know the
ubuntu-26.04andubuntu-26.04-armrunner labels yet, and fails a literalruns-on: ubuntu-26.04as an unknown label. List them in the repository's.github/actionlint.yaml, which actionlint reads by itself, as this repository does:yamlself-hosted-runner: labels: - ubuntu-26.04 - ubuntu-26.04-arm