GitHub Actions Workflow Validator
Paste your .github/workflows/*.yml and validate it before pushing.
Checks required structure, trigger events, job dependencies, action version pins, secrets handling, and cron expressions.
Nothing is sent to any server — runs entirely in your browser.
Frequently Asked Questions
What does this GitHub Actions validator check?▼
It validates workflow structure (required name/on/jobs keys), trigger event names, job fields (runs-on, steps), needs: dependency references (catching undefined jobs), action version pinning, hardcoded secrets, schedule cron expressions, and security issues like pull_request_target with untrusted head SHA.
What is the difference between this validator and a linter?▼
This tool focuses on structural correctness — does your workflow have the required fields, are job dependencies valid, are event names spelled correctly? A linter additionally checks style and best practices. Both are complementary: validate structure first, then lint for best practices.
Why should I pin actions to version tags instead of branch names?▼
Pinning to @main or @master uses whatever code is on that branch at run time — including potentially malicious changes (supply chain attacks). Pinning to @v4 or a commit SHA (e.g., @abc1234) makes your workflow reproducible and immune to upstream branch changes.
What are valid GitHub Actions trigger events?▼
Common triggers: push, pull_request, pull_request_target, schedule (cron), workflow_dispatch (manual trigger), workflow_call (reusable workflows), release, issues, issue_comment, create, delete, fork, label, milestone, repository_dispatch, discussion, merge_group, and more. Invalid event names silently fail to trigger.
What is needs: used for and what breaks it?▼
The needs: field creates job dependencies — a job with needs: [test, build] only runs after both succeed. If you reference a job name that doesn't exist in the workflow, GitHub will refuse to run it. This validator catches those broken references before you push.
Is my workflow YAML sent to any server?▼
No. All validation runs entirely in your browser using JavaScript. Your workflow YAML never leaves your machine — safe even when your workflows contain secret names, internal endpoint URLs, or repository structure details.
Related Products
on GumroadGitHub Actions CI/CD Templates Pack
12 production-ready GitHub Actions workflow templates covering Node.js, Python, Docker, multi-environment deployments, security scanning, and auto-changelog. Copy, paste, ship.
Buy on Gumroad →Premium Workflow Pack
Production-grade workflows, architecture guides, and deployment scripts for teams that ship. 10 advanced CI/CD workflows (blue-green, canary, E2E, security), 5 architecture deep-dives, code review checklist, PR process guide, and 5 battle-tested Bash deployment scripts.
Buy on Gumroad →Developer Productivity Bundle
Stop rebuilding the same setup every project. 51 VSCode snippets, 40 Git aliases, 5 Docker Compose stacks, 5 GitHub Actions workflows, 5 README templates, and a dotfiles kit. Set up a professional dev environment in under an hour.
Buy on Gumroad →You Might Also Need
GitHub Actions YAML Linter
Lint your GitHub Actions workflow YAML before pushing. Catches broken needs references, invalid trigger events, hardcoded secrets, unversioned action pins, and YAML syntax errors. Free browser tool.
Open free tool →
YAML Validator Pro
Advanced YAML validator with line-number error reporting, JSON preview, and schema hints for common YAML pitfalls. Free, runs in your browser.
Open free tool →
YAML to JSON Converter
Convert YAML to JSON and JSON to YAML online. Bidirectional conversion with syntax highlighting, error detection, and formatted output. Supports multi-document YAML and complex nested structures.
Open free tool →
More Free Tools
Related Articles
GitHub Actions Complete Guide: Build Your First CI/CD Pipeline in 2026
Learn GitHub Actions from scratch. Set up automated testing, linting, Docker builds, and deployments with real workflow examples. No prior CI/CD experience needed.
GitHub Actions 入門必讀:從 0 到自動化部署
完整的 GitHub Actions 新手教學,從基本概念、workflow 語法到實戰 CI/CD 自動部署。附完整 YAML 範例,30 分鐘學會持續整合。
DevOps Automation Tools in 2026: Orchestrating the Software Delivery Pipeline
Master DevOps automation with this guide to the tools that orchestrate modern software delivery. Covers CI/CD pipelines, infrastructure provisioning, configuration management, testing automation, and the emerging AI-assisted automation patterns that define 2026.
GitHub Actions Advanced Guide 2026: Matrix Builds, Caching, OIDC & Cost Optimization
Master GitHub Actions in 2026. Deep-dive into matrix strategies, artifact caching, OIDC authentication with AWS/GCP/Azure, self-hosted runners, reusable workflows, and cost optimization techniques for fast, cheap CI/CD pipelines.
AI-Assisted Code Review Workflow: A Complete Guide for 2026
Learn how to build a production-ready AI-assisted code review workflow using Claude, GitHub Actions, and modern dev tools. Covers setup, prompts, integration patterns, and real-world best practices.
Enjoying this tool? Get more like it.
Weekly developer tool guides, productivity playbooks & AI tricks. Free. No spam.
Unlock AI-Powered Dev Tools
- ⚡ AI Code Review, Doc Generator & SQL Builder
- ⚡ All premium templates & early access
- ⚡ Member discounts on Gumroad products
$9/mo after trial · Cancel anytime
Want the full toolkit?
Get DevPlaybook Pro
Every template, guide, boilerplate, and automation script in one bundle. 13 premium products — grab them all at once and save big.
MIT licensed · Instant download · No subscription
See what's included → Browse all deals →