Are You Linting Your GitHub Actions?
This title could be clearer and more informative.Try out Clickbait Shieldfor free (5 uses left this month).
A broken GitHub Actions workflow file — using a non-existent `workflows` permission scope — caused every CI run to fail silently with no jobs. The fix is to lint workflow files before they're committed using JSON Schema validation. Two tools are compared: `actionlint` (a Go binary with deeper checks) and `action-validator` (a Rust/WebAssembly npm package that integrates cleanly as a devDependency). The recommended setup uses `action-validator` with Lefthook git hooks, so the validator only runs when workflow files are staged, catching errors at commit time rather than in production.
Table of contents
ContentsA Failed Run with Zero JobsLinting GitHub ActionsValidate at Commit Time with Lefthook210 Impressions