finops-workflows

Installation
SKILL.md
Contains Shell Commands

This skill contains shell command directives (!`command`) that may execute system commands. Review carefully before installing.

/finops:workflows

Analyze GitHub Actions workflow runs for a repository - frequency, duration, success rates, and efficiency metrics.

When to Use

Scenario Use this skill Alternative
Analyze workflow run frequency and duration /finops:workflows -
Investigate high failure rates /finops:workflows -
Understand trigger type distribution /finops:workflows -
Org-wide workflow analysis /finops:workflows org <name> -
Quick overall health snapshot /finops:overview Use overview for high-level summary
Fix workflow configuration issues /finops:waste Use waste for actionable config fixes
Compare workflow metrics across repos /finops:compare Use compare for multi-repo view

Context

  • Current repo URL: !git remote get-url origin

Parameters

Parameter Description Default
repo Repository in owner/name format Current repository
--created Date range filter (e.g., >=2026-03-01) None (last 100 runs)
org <name> Org-wide analysis (use instead of repo) -

Execution

Per-repo analysis (default)

bash "${SKILL_DIR}/scripts/workflow-runs.sh" $ARGS

Org-wide analysis

When the user requests org-wide analysis, use the org script:

bash "${SKILL_DIR}/scripts/workflow-runs-org.sh" $ARGS

Output Format

Analyzing workflows for: org/repo

=== Active Workflows ===
  CI (id: 12345)
  Deploy (id: 12346)
  CodeQL (id: 12347)

=== Run Summary ===
CI:
  Total: 156 | Success: 140 | Failure: 10 | Cancelled: 4 | Skipped: 2
  Success rate: 89%
Deploy:
  Total: 45 | Success: 44 | Failure: 1 | Cancelled: 0 | Skipped: 0
  Success rate: 97%

=== Duration Analysis ===
CI:
  Runs: 50 | Avg: 4m32s | Max: 12m15s | Total: 226min
Deploy:
  Runs: 20 | Avg: 2m10s | Max: 3m45s | Total: 43min

=== Trigger Types ===
  push: 89 runs
  pull_request: 67 runs
  schedule: 30 runs
  workflow_dispatch: 5 runs

=== Recent Failures (last 10) ===
  #234 CI - 2025-01-28 - https://github.com/org/repo/actions/runs/...
  #231 CI - 2025-01-27 - https://github.com/org/repo/actions/runs/...

=== High Frequency Workflows ===
  CI: 156 runs (~5.2/day) - consider path filters

Agentic Optimizations

Context Command
Workflow list (JSON) gh workflow list --json name,id,state
Recent runs (compact) gh run list --workflow <name> --limit 20 --json status,conclusion,createdAt
Failed runs only gh run list --status failure --limit 10 --json name,createdAt,url
Run timing (JSON) `gh api "/repos/{owner}/{repo}/actions/runs?per_page=50" --jq '.workflow_runs[]
Compact per-repo analysis bash "${SKILL_DIR}/scripts/workflow-runs.sh" $ARGS
Org-wide analysis bash "${SKILL_DIR}/scripts/workflow-runs-org.sh" $ARGS

Post-actions

Based on findings, suggest:

  • High failure rate -> Investigate recent failures, check logs with gh run view --log-failed
  • High frequency -> Review trigger conditions, add path filters
  • Long durations -> Review caching, parallelization, step optimization
  • Many skipped -> Run /finops:waste for detailed analysis
Weekly Installs
59
GitHub Stars
29
First Seen
Feb 16, 2026