/finops:workflows
Analyze GitHub Actions workflow runs for a repository - frequency, duration, success rates, and efficiency metrics.
When to Use This Skill
| Use this skill when... |
Use a sibling instead when... |
| You need to analyze workflow run frequency, duration, and trigger distribution |
You only need a quick high-level health snapshot — use /finops:overview |
| You are investigating high failure rates on specific workflows |
You want actionable fixes for workflow config waste — use /finops:waste |
You need org-wide workflow timing analysis (/finops:workflows org <name>) |
You want to compare workflow metrics across many repos — use /finops:compare |
| You want to identify slow or noisy workflows by duration |
You are investigating cache size or stale caches — use /finops:caches |
Context
- Current repo URL: !
git remote -v
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
1---2name: finops-workflows3description: Analyze workflow runs — frequency, duration, success rates, efficiency. Use when investigating slow CI, high failure rates, or run patterns over time.4---5
6# /finops:workflows
7
8Analyze GitHub Actions workflow runs for a repository - frequency, duration, success rates, and efficiency metrics.
9
10## When to Use This Skill
11
12| Use this skill when... | Use a sibling instead when... |
13|---|---|
14| You need to analyze workflow run frequency, duration, and trigger distribution | You only need a quick high-level health snapshot — use `/finops:overview` |
15| You are investigating high failure rates on specific workflows | You want actionable fixes for workflow config waste — use `/finops:waste` |
16| You need org-wide workflow timing analysis (`/finops:workflows org <name>`) | You want to compare workflow metrics across many repos — use `/finops:compare` |
17| You want to identify slow or noisy workflows by duration | You are investigating cache size or stale caches — use `/finops:caches` |
18
19## Context
20
21- Current repo URL: !`git remote -v`
22
23## Parameters
24
25| Parameter | Description | Default |
26|-----------|-------------|---------|
27| `repo` | Repository in owner/name format | Current repository |
28| `--created` | Date range filter (e.g., `>=2026-03-01`) | None (last 100 runs) |
29| `org <name>` | Org-wide analysis (use instead of repo) | - |
30
31## Execution
32
33### Per-repo analysis (default)
34
35```bash
36bash "${SKILL_DIR}/scripts/workflow-runs.sh" $ARGS
37```
38
39### Org-wide analysis
40
41When the user requests org-wide analysis, use the org script:
42
43```bash
44bash "${SKILL_DIR}/scripts/workflow-runs-org.sh" $ARGS
45```
46
47## Output Format
48
49```
50Analyzing workflows for: org/repo
51
52=== Active Workflows ===
53 CI (id: 12345)
54 Deploy (id: 12346)
55 CodeQL (id: 12347)
56
57=== Run Summary ===
58CI:
59 Total: 156 | Success: 140 | Failure: 10 | Cancelled: 4 | Skipped: 2
60 Success rate: 89%
61Deploy:
62 Total: 45 | Success: 44 | Failure: 1 | Cancelled: 0 | Skipped: 0
63 Success rate: 97%
64
65=== Duration Analysis ===
66CI:
67 Runs: 50 | Avg: 4m32s | Max: 12m15s | Total: 226min
68Deploy:
69 Runs: 20 | Avg: 2m10s | Max: 3m45s | Total: 43min
70
71=== Trigger Types ===
72 push: 89 runs
73 pull_request: 67 runs
74 schedule: 30 runs
75 workflow_dispatch: 5 runs
76
77=== Recent Failures (last 10) ===
78 #234 CI - 2025-01-28 - https://github.com/org/repo/actions/runs/...
79 #231 CI - 2025-01-27 - https://github.com/org/repo/actions/runs/...
80
81=== High Frequency Workflows ===
82 CI: 156 runs (~5.2/day) - consider path filters
83```
84
85## Agentic Optimizations
86
87| Context | Command |
88|---------|---------|
89| Workflow list (JSON) | `gh workflow list --json name,id,state` |
90| Recent runs (compact) | `gh run list --workflow <name> --limit 20 --json status,conclusion,createdAt` |
91| Failed runs only | `gh run list --status failure --limit 10 --json name,createdAt,url` |
92| Run timing (JSON) | `gh api "/repos/{owner}/{repo}/actions/runs?per_page=50" --jq '.workflow_runs[] | {name,created_at,updated_at,conclusion}'` |
93| Compact per-repo analysis | `bash "${SKILL_DIR}/scripts/workflow-runs.sh" $ARGS` |
94| Org-wide analysis | `bash "${SKILL_DIR}/scripts/workflow-runs-org.sh" $ARGS` |
95
96## Post-actions
97
98Based on findings, suggest:
99- High failure rate -> Investigate recent failures, check logs with `gh run view --log-failed`
100- High frequency -> Review trigger conditions, add path filters
101- Long durations -> Review caching, parallelization, step optimization
102- Many skipped -> Run `/finops:waste` for detailed analysis