Validate GitHub Actions Online — Workflow Structure Checker

Live structural checks for on, jobs and steps. Not full actionlint — honest browser-local validation.

0 chars · 0 B

Share this tool:

GitHub Actions workflow YAML

Structural checks only — not actionlint. Runs entirely in your browser.

Loading…

GitHub Actions validator — structural checker

Catch missing on/jobs, empty steps, and YAML parse errors before pushing a workflow — honest structural scope, not actionlint.

Developer notes

• Validates structure only: root on + jobs, job runs-on|uses|steps, step run|uses. • Debounced ~300 ms after typing stops. • Empty input shows idle state (not invalid). • Does not evaluate ${{ }} expressions or pin action versions.

When teams pick this route

• Sanity-check a pasted workflow from a ticket. • Find missing script/uses on a step before CI fails. • Teach workflow shape with immediate feedback. • Pair with format-github-actions after fixing structure.

Worked examples

Valid checkout + test job

Input

name: CI
on:
  push:
    branches: [main]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm test

Validation result

Valid workflow structure — no blocking issues.

Step without run or uses

Input

name: Broken
on: push
jobs:
  build:
    steps:
      - name: empty step

Validation result

Invalid — step must define run and/or uses (structural error).

Navigate related CI/CD tools

Format fixed YAML with format GitHub Actions, or explore validate GitLab CI and the CI/CD hub.

GitHub Actions validator FAQ

Structural checks only

Is this actionlint?

No. We check YAML parse and common structural requirements (on, jobs, steps). Expression lint, permissions schemas, and marketplace lookups are out of scope.