github-actions-validator

Validate GitHub Actions workflows with actionlint and act before deployment.

290|32|Updated Dec 5, 2025
One-click install
npx skills add https://github.com/akin-ozer/cc-devops-skills --skill github-actions-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-actions-validator
Source: https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills/github-actions-validator
Command: npx skills add https://github.com/akin-ozer/cc-devops-skills --skill github-actions-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires docker, curl, bash, act, actionlint, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill helps teams validate and debug GitHub Actions workflows by performing local validation, syntax checks, and actionable remediation guidance.

Core Features & Use Cases

  • Static analysis of YAML workflows using actionlint to catch syntax issues, invalid inputs, and runner labels
  • Local workflow testing with act to verify behavior before pushing
  • Action version validation and remediation guidance with references; support for modern features like workflow_call and OIDC-ready permissions
  • Pre-commit validation for pull requests and debugging failures with actionable suggestions

Quick Start

  1. Install local tooling: bash scripts/install_tools.sh
  2. Validate a workflow: bash scripts/validate_workflow.sh .github/workflows/ci.yml
  3. Check action versions: bash scripts/validate_workflow.sh --check-versions .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 locally before pushing?

You can validate GitHub Actions workflows locally by running static analysis and local execution on YAML files under .github/workflows. This catches syntax errors and misconfigurations before deployment using actionlint and act.

What is the best way to test GitHub Actions workflows without committing changes?

Testing GitHub Actions workflows locally with act allows you to verify workflow behavior before pushing. You can run the workflow execution locally using Docker to simulate the runner environment without committing changes.

Can I check for outdated action versions in my GitHub Actions workflows?

Yes, you can check action versions in GitHub Actions workflows to ensure reliability. The validation process includes action-version checks and provides remediation guidance with references for outdated dependencies.

Do I need Docker and bash installed to run GitHub Actions workflow validation?

Yes, validating GitHub Actions workflows requires Docker, curl, and bash. The skill includes an installation script to set up the required actionlint and act tools for local workflow testing and static analysis.

Does this GitHub Actions validation support reusable workflows and environment protections?

Yes, the GitHub Actions validation supports modern features such as reusable workflows with workflow_call and environment protections. It also handles OIDC-ready permissions during static analysis.

Why does my GitHub Actions workflow fail syntax checks when using custom runner labels?

GitHub Actions workflow syntax checks fail on invalid runner labels because actionlint statically analyzes YAML files to catch invalid inputs and unsupported runner configurations, providing actionable remediation guidance.