github-actions-validator

Validate, lint, and test GitHub Actions workflow files and local actions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/sudohakan/claude-code-dotfiles --skill github-actions-validator-sudohakan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-actions-validator
Source: https://github.com/sudohakan/claude-code-dotfiles/tree/main/config/skills/cc-devops-skills/devops-skills-plugin/skills/github-actions-validator
Command: npx skills add https://github.com/sudohakan/claude-code-dotfiles --skill github-actions-validator-sudohakan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the validation, linting, and local testing of GitHub Actions workflow files, preventing errors before they reach production and ensuring best practices.

Core Features & Use Cases

  • Syntax Validation: Catches YAML syntax errors and schema compliance issues.
  • Local Testing: Runs workflows locally using act to simulate execution.
  • Best Practice Enforcement: Checks for common errors, security vulnerabilities, and outdated action versions.
  • Use Case: Before committing a new workflow file, use this Skill to ensure it's syntactically correct, uses valid runner labels, and won't fail unexpectedly in CI.

Quick Start

Validate the workflow file located at .github/workflows/ci.yml.

Frequently Asked Questions about github-actions-validator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate GitHub Actions workflows before committing?

To validate GitHub Actions workflows before committing, you can lint `.github/workflows/*.yml` files to catch YAML syntax errors, check schema compliance, and enforce best practices to prevent unexpected CI failures.

Can I run GitHub Actions workflows locally to test execution?

Yes, you can run GitHub Actions workflows locally to test execution by using the `act` tool, which simulates the CI environment on your local machine to ensure jobs execute as expected before pushing changes.

Does workflow validation support custom composite and Docker actions?

Workflow validation fully supports custom composite, Docker, and JavaScript actions, alongside public actions from the GitHub Marketplace, allowing you to lint and test local action configurations for syntax and schema compliance.

What is the best way to check GitHub Actions for security vulnerabilities?

The best way to check GitHub Actions for security vulnerabilities is to use a linter that enforces best practices, identifies common configuration errors, and detects outdated action versions during the workflow validation process.

Why does my GitHub Actions workflow fail with an invalid runner label?

Your GitHub Actions workflow fails with an invalid runner label because of schema compliance issues, which can be caught and resolved by linting the YAML configuration to validate runner labels before reaching production.