workflow-optimizer

Analyze GitHub Actions workflows and surface speed & reliability improvements.

What it does

Scans your .github/workflows/ directory for common performance and reliability issues:

• Missing dependency caching
• Broad push triggers without branch filters
• Missing concurrency groups
• Actions pinned to branch refs instead of version tags

Posts a report as a PR comment (optional) or logs to the Actions output.

Usage

name: Optimize Workflows
on: [pull_request]

jobs:
  optimize:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: ollieb89/workflow-optimizer@v1.0.0
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          pr-number: ${{ github.event.pull_request.number }}

Inputs

Input	Required	Default	Description
token	✅	—	GitHub token
workflows-dir	❌	.github/workflows	Directory to scan
pr-number	❌	—	PR to comment on

Outputs

Output	Description
suggestions-count	Number of suggestions found
report	Markdown optimization report

Checks

Rule	Severity	Description
missing-cache	⚠️ Warning	No dependency caching detected
broad-trigger	⚠️ Warning	Push trigger lacks branch filter
missing-concurrency	ℹ️ Info	No concurrency group defined
unpinned-actions	⚠️ Warning	Actions pinned to branch refs

Keywords

github-actions, workflow-optimizer, ci-cd, automation, performance, github, developer-tools

License

MIT © 2026 ollieb89