---
title: "Lint GitHub Actions workflows before CI runs with actionlint"
description: "Validate workflow syntax, expressions, and shell steps before broken GitHub Actions changes reach CI."
verification: "listed"
source: "https://github.com/rhysd/actionlint"
author: "rhysd"
publisher_type: "individual"
category:
  - "CI/CD Integrations"
framework:
  - "Multi-Framework"
tool_ecosystem:
  github_repo: "rhysd/actionlint"
  github_stars: 3787
---

# Lint GitHub Actions workflows before CI runs with actionlint

Validate workflow syntax, expressions, and shell steps before broken GitHub Actions changes reach CI.

## Prerequisites

actionlint binary and GitHub Actions workflow files

## Installation

Choose whichever fits your setup:

1. Copy this skill folder into your local skills directory.
2. Clone the repo and symlink or copy the skill into your agent workspace.
3. Add the repo as a git submodule if you manage shared skills centrally.
4. Install it through your internal provisioning or packaging workflow.
5. Download the folder directly from GitHub and place it in your skills collection.

Install command or upstream instructions:

```
Install actionlint from the project releases or package manager, then run `actionlint` in the repository root or against specific workflow files before merge.
```

## Documentation

- https://github.com/rhysd/actionlint

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/lint-github-actions-workflows-before-ci-runs-with-actionlint/)