actionlint
Validate GitHub Actions workflow files for syntax errors, invalid references, and common mistakes. Auto-detects actionlint binary or guides installation. Checks project config or falls back to sensible defaults. Use when creating or modifying GitHub Actions workflows, validating CI/CD pipelines, or catching workflow errors before pushing.
How do I install this agent skill?
npx skills add https://github.com/rshade/agent-skills --skill actionlintIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The actionlint skill provides functionality to validate GitHub Actions workflows for syntax and security issues. It handles installation from official sources, configures the tool, and reports linting errors. Analysis identified standard command execution and binary installation procedures consistent with a developer tool, with no malicious patterns detected.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Actionlint
Validate GitHub Actions workflow files (.github/workflows/*.yml) for
syntax errors, invalid references, expression mistakes, and security
issues. Catches errors that would otherwise only surface at runtime.
What this skill does
- Checks if
actionlintis available; guides installation if missing. - Detects project-specific
.actionlintrc.yamlor falls back to a sensible default config. - Validates workflow files for syntax, action references, expressions, shell scripts, and security issues.
- Reports errors with specific rule categories and fixes.
Installation check
actionlint --version 2>/dev/null
If not installed, install using one of:
# Go (requires Go 1.22+)
go install github.com/rhysd/actionlint/cmd/actionlint@latest
# Homebrew (macOS/Linux)
brew install actionlint
# Download binary (Linux amd64)
curl -sL "$(curl -sL https://api.github.com/repos/rhysd/actionlint/releases/latest \
| grep browser_download_url | grep linux_amd64.tar.gz | cut -d'"' -f4)" \
| tar xz -C /usr/local/bin actionlint
If installation fails, stop and report the issue with remediation steps. Do not silently skip validation.
Optional enhancement: if shellcheck is installed, actionlint
automatically validates shell scripts in run: blocks. This is
recommended but not required.
Config detection priority
.actionlintrc.yamlin project root- Default config (see
references/actionlint-config.yaml)
If no project config exists, create a temporary .actionlintrc.yaml
using the default config from references before running validation.
Validation workflow
1. Check actionlint installation
├─ Installed → continue
└─ Missing → install, then continue (fail if install fails)
2. Detect project config
├─ Found → use it
└─ Not found → use default config from references/
3. Run validation
├─ All workflows:
│ actionlint
├─ Specific files:
│ actionlint .github/workflows/ci.yml
└─ With config:
actionlint -config-file .actionlintrc.yaml
4. Report results
├─ Valid → confirm and proceed
└─ Invalid → show errors, suggest fixes, re-validate after correction
Validation methods
Validate all workflow files (auto-discovers .github/workflows/)
actionlint
Validate specific files
actionlint .github/workflows/ci.yml .github/workflows/release.yml
Validate with explicit config
actionlint -config-file .actionlintrc.yaml
Validate from stdin (useful for generated workflows)
cat workflow.yml | actionlint -
Error handling
Install failure
If actionlint cannot be installed, report the error and provide remediation steps. Do not proceed with validation.
Validation failure
When validation fails, report each error with:
- The file and line number
- The error category (syntax, action, expression, runner, shell, etc.)
- What was wrong
- A concrete fix
Example:
Validation failed:
1. .github/workflows/ci.yml:15:9
action "actions/checkout@master" — use a commit hash or version tag
Fix: actions/checkout@v4
2. .github/workflows/ci.yml:23:14
expression error: property "repo" not defined in "github" context
Fix: use "github.repository" instead of "github.repo"
3. .github/workflows/deploy.yml:8:5
"push" event does not support "paths" filter with "tags" filter
Fix: split into separate workflows or remove one filter
After reporting errors, suggest fixes and re-validate after correction.
Rule reference
See references/actionlint-rules.md for the full rule reference,
common error categories, security checks, and fix examples.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/rshade/agent-skills/actionlint">View actionlint on skillZs</a>