GitHub Actions Validator
Paste a GitHub Actions workflow YAML and check it for common structural problems before committing it.
Paste your GitHub Actions workflow YAML below - this tool checks it's valid YAML and looks for the structure a working workflow needs.
This checks common structural requirements, not GitHub's full runtime behavior - always verify a workflow with a real run if possible.
What Does This Tool Check?
It parses your YAML and checks for the structure every working GitHub Actions workflow needs: a valid on trigger, at least one job under jobs, a runs-on for each job, and a steps list where each step has either a uses (an action) or a run (a shell command).
Why Use This Tool?
A workflow YAML with a structural mistake (like a missing runs-on or an incorrectly indented step) will fail before your actual build/test logic ever runs, and GitHub's own error messages for this can be terse. This tool surfaces common mistakes before you commit and wait for a CI run to fail.
How to Use It
- Paste your workflow YAML.
- Click Validate.
- Review any errors (structural problems that would likely break the workflow) and warnings (things worth double-checking).
Limitations
This checks common structural requirements - it does not verify that a referenced action actually exists, that your shell commands are correct, or that secrets/permissions are configured correctly on GitHub itself.