{"id":26802388,"url":"https://github.com/raven-actions/actionlint","last_synced_at":"2026-01-30T08:24:49.029Z","repository":{"id":160117672,"uuid":"634710241","full_name":"raven-actions/actionlint","owner":"raven-actions","description":"✅ Run actionlint in your GitHub workflow","archived":false,"fork":false,"pushed_at":"2025-06-20T05:48:13.000Z","size":574,"stargazers_count":32,"open_issues_count":4,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-21T12:33:33.381Z","etag":null,"topics":["actionlint","actions","ci","code-quality","code-review","composite-action","github","github-actions","lint","linter","raven-actions","workflows"],"latest_commit_sha":null,"homepage":"https://github.com/marketplace/actions/actionlint","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raven-actions.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-05-01T01:24:39.000Z","updated_at":"2025-06-20T05:48:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"9a7a7f02-f65e-4b8f-993d-e1d573d03a01","html_url":"https://github.com/raven-actions/actionlint","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/raven-actions/actionlint","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raven-actions%2Factionlint","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raven-actions%2Factionlint/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raven-actions%2Factionlint/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raven-actions%2Factionlint/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raven-actions","download_url":"https://codeload.github.com/raven-actions/actionlint/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raven-actions%2Factionlint/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271103202,"owners_count":24699646,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-19T02:00:09.176Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actionlint","actions","ci","code-quality","code-review","composite-action","github","github-actions","lint","linter","raven-actions","workflows"],"created_at":"2025-03-29T21:17:54.441Z","updated_at":"2026-01-30T08:24:48.972Z","avatar_url":"https://github.com/raven-actions.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# ✅ actionlint Action\n\n[![GitHub - marketplace](https://img.shields.io/badge/marketplace-actionlint-blue?logo=github\u0026style=flat-square)](https://github.com/marketplace/actions/actionlint)\n[![GitHub - release](https://img.shields.io/github/v/release/raven-actions/actionlint?style=flat-square)](https://github.com/raven-actions/actionlint/releases/latest)\n[![GitHub - ci](https://img.shields.io/github/actions/workflow/status/raven-actions/actionlint/ci.yml?logo=github\u0026label=CI\u0026style=flat-square\u0026branch=main\u0026event=push)](https://github.com/raven-actions/actionlint/actions/workflows/ci.yml?query=branch%3Amain+event%3Apush)\n[![GitHub - license](https://img.shields.io/github/license/raven-actions/actionlint?style=flat-square)](https://github.com/raven-actions/actionlint/blob/main/LICENSE)\n\nThis [GitHub Action](https://github.com/features/actions) allows you to quickly and easily run [actionlint](https://github.com/rhysd/actionlint) in your GitHub workflow using native Runner OS without installing 3rd party dependencies. It is based on an official action lint usage proposal from [Use actionlint on GitHub Actions](https://github.com/rhysd/actionlint/blob/main/docs/usage.md#use-actionlint-on-github-actions) together with [Problem Matchers](https://github.com/rhysd/actionlint/blob/main/docs/usage.md#problem-matchers).\n\n- Action is platform-independent and tested on all the latest GitHub-hosted runners (`ubuntu-latest`, `macos-latest`, `windows-latest`).\n- Uses [GitHub cache](https://docs.github.com/en/actions/using-workflows/caching-dependencies-to-speed-up-workflows) for caching `actionlint` binaries for faster and more efficient workflow run.\n  - 3rd party `actionlint` dependencies like `shellcheck` or `pyflakes` are not cached, but action installs them if not present on the GitHub Runner using [pipx](https://pipx.pypa.io/) (make sure your GitHub Runner has it).\n\n![demo-error](https://raw.githubusercontent.com/raven-actions/actionlint/main/assets/images/demo-error.png)\n\n![demo-ok](https://raw.githubusercontent.com/raven-actions/actionlint/main/assets/images/demo-ok.png)\n\n## 📑 Table of Contents \u003c!-- omit in toc --\u003e\n\n- [🛠️ Usage](#️-usage)\n  - [Quick Start](#quick-start)\n  - [Customization](#customization)\n- [📥 Inputs](#-inputs)\n- [📤 Outputs](#-outputs)\n- [👥 Contributing](#-contributing)\n- [🛡️ License](#️-license)\n\n## 🛠️ Usage\n\n### Quick Start\n\nJust place in your GitHub workflow steps:\n\n```yaml\n- name: actionlint\n  uses: raven-actions/actionlint@v2\n```\n\n### Customization\n\nYou can modify the default configuration with optional inputs. All optional inputs are listed in the [📥 Inputs](#-inputs) section.\n\nAction returns some basic information. For more details, follow [📤 Outputs](#-outputs) section.\n\n```yaml\n- name: actionlint\n  id: actionlint  #optional, id required only when outputs are used in the workflow steps later\n  uses: raven-actions/actionlint@v2\n  with:\n    matcher: false  # optional\n    cache: false  # optional\n    fail-on-error: false  # optional\n    files: \"tests/*.yml, tests/*.yaml\"  # optional, example on how to grab all .yml and .yaml files from the test directory\n    flags: \"-ignore SC2086\"  # optional\n\n- name: actionlint Summary\n  if: ${{ steps.actionlint.outputs.exit-code != 0 }}  # example usage, do echo only when actionlint action failed\n  run: |\n    echo \"Used actionlint version ${{ steps.actionlint.outputs.version-semver }}\"\n    echo \"Used actionlint release ${{ steps.actionlint.outputs.version-tag }}\"\n    echo \"actionlint ended with ${{ steps.actionlint.outputs.exit-code }} exit code\"\n    echo \"actionlint ended because '${{ steps.actionlint.outputs.exit-message }}'\"\n    echo \"actionlint found ${{ steps.actionlint.outputs.total-errors }} errors\"\n    echo \"actionlint checked ${{ steps.actionlint.outputs.total-files }} files\"\n    echo \"actionlint cache used: ${{ steps.actionlint.outputs.cache-hit }}\"\n    exit ${{ steps.actionlint.outputs.exit-code }}\n```\n\n## 📥 Inputs\n\n|       Name       | Required |   Type   |  Default value   | Description                                                                                                                                                 |\n| :--------------: | :------: | :------: | :--------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |\n|    `version`     |  false   | `string` |     `latest`     | SemVer version of `actionlint`, recommended to keep default: `latest`                                                                                       |\n|    `matcher`     |  false   |  `bool`  |      `true`      | Use matcher for GitHub annotations.                                                                                                                         |\n|     `files`      |  false   | `string` |    _not set_     | To lint different workflow files (default searching directory is `.github/workflows`), use comma-separated glob patterns, e.g., `tests/*.yml, tests/*.yaml` |\n|     `flags`      |  false   | `string` |    _not set_     | Extra flags to use with `actionlint`                                                                                                                        |\n|  `group-result`  |  false   |  `bool`  |      `true`      | Use the GitHub log grouping feature for failure actionlint results.                                                                                         |\n| `fail-on-error`  |  false   |  `bool`  |      `true`      | Fail action on `actionlint` errors.                                                                                                                         |\n|   `shellcheck`   |  false   |  `bool`  |      `true`      | Use `shellcheck` with `actionlint` (and install if it does not exist)                                                                                       |\n|    `pyflakes`    |  false   |  `bool`  |      `true`      | Use `pyflakes` with `actionlint` (and install if it does not exist)                                                                                         |\n|     `cache`      |  false   |  `bool`  |      `true`      | Use GitHub cache for caching binaries for the next runs.                                                                                                    |\n|  `github-token`  |  false   | `string` |  `github.token`  | GitHub Token for API authentication.                                                                                                                        |\n\n## 📤 Outputs\n\n|       Name       |   Type   | Description                                                                                                                    |\n| :--------------: | :------: | :----------------------------------------------------------------------------------------------------------------------------- |\n| `version-semver` | `string` | SemVer version of `actionlint`, recommended to keep default: latest                                                            |\n|  `version-tag`   | `string` | Use matcher for GitHub annotations                                                                                             |\n|   `exit-code`    |  `int`   | Exit status code based on [actionlint exit status](https://github.com/rhysd/actionlint/blob/main/docs/usage.md#exit-status)    |\n|  `exit-message`  | `string` | Exit status message based on [actionlint exit status](https://github.com/rhysd/actionlint/blob/main/docs/usage.md#exit-status) |\n|  `total-errors`  |  `int`   | Total number of errors found during the linting                                                                                |\n|  `total-files`   |  `int`   | Total number of checked files                                                                                                  |\n|   `cache-hit`    |  `bool`  | GitHub cache has been used?                                                                                                    |\n\n## 👥 Contributing\n\nContributions to the project are welcome! Please follow [Contributing Guide](https://github.com/raven-actions/actionlint/blob/main/.github/CONTRIBUTING.md).\n\n## 🛡️ License\n\nThis project is distributed under the terms of the [MIT](https://github.com/raven-actions/actionlint/blob/main/LICENSE) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraven-actions%2Factionlint","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraven-actions%2Factionlint","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraven-actions%2Factionlint/lists"}