mcpField
F
finops-workflows

finops-workflows

github.com/laurigatesCloud & DevOps5959 installsUpdated 1d ago
Repository

About finops-workflows

A FinOps skill for analyzing GitHub Actions workflow runs in a repository or across an organization. It reports run frequency, duration, success rates, trigger distributions, and efficiency metrics.

Key features

  1. 01Analyze run frequency and duration
  2. 02Review workflow success rates
  3. 03Break down runs by trigger type
  4. 04Analyze a repository or organization
  5. 05Filter runs by creation date

Use cases

  1. 01Investigate high workflow failure rates
  2. 02Find workflows with long runtimes
  3. 03Review trigger patterns across a repository
  4. 04Compare workflow activity across an organization

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/laurigates/claude-plugins --skill finops-workflows

After installing, type/finops-workflowsin Claude Code to confirm it loaded.

Bundled filesscripts/workflow-runs-org.shscripts/workflow-runs.sh

Details

From the project README

/finops:workflows

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

When to Use

ScenarioUse this skillAlternative
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:overviewUse overview for high-level summary
Fix workflow configuration issues/finops:wasteUse waste for actionable config fixes
Compare workflow metrics across repos/finops:compareUse compare for multi-repo view

Context

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

Parameters

ParameterDescriptionDefault
repoRepository in owner/name formatCurrent repository
--createdDate 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

ContextCommand
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 onlygh 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 analysisbash "${SKILL_DIR}/scripts/workflow-runs.sh" $ARGS
Org-wide analysisbash "${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

Comments

Markdown supported