GitHub Actions Artifact Budget Audit

Audit GitHub Actions artifact storage usage from JSON exports so bloated artifacts are flagged before they inflate CI cost.

Use this skill to detect oversized or stale GitHub Actions artifacts across repositories.

What this skill does

• Reads one or more GitHub artifact JSON exports (gh api output)
• Calculates artifact size in MB and totals by repository + artifact name
• Flags warn/critical artifacts by configurable size thresholds
• Highlights soon-to-expire artifact volume to prioritize cleanup
• Supports text and JSON output for terminal or dashboards

Inputs

Optional:

• ARTIFACT_GLOB (default: artifacts/github-actions-artifacts/*.json)
• TOP_N (default: 20)
• OUTPUT_FORMAT (text or json, default: text)
• WARN_MB (default: 250)
• CRITICAL_MB (default: 750)
• SOON_EXPIRES_DAYS (default: 7)
• FAIL_ON_CRITICAL (0 or 1, default: 0)
• REPO_MATCH (regex, optional)
• REPO_EXCLUDE (regex, optional)
• ARTIFACT_MATCH (regex, optional)
• ARTIFACT_EXCLUDE (regex, optional)

Collect artifact JSON

Single repository:

gh api repos/<owner>/<repo>/actions/artifacts --paginate \
  > artifacts/github-actions-artifacts/<owner>-<repo>.json

Combined multi-repo payloads are also supported as long as each file includes an artifacts array.

Run

Text report:

ARTIFACT_GLOB='artifacts/github-actions-artifacts/*.json' \
WARN_MB=300 \
CRITICAL_MB=900 \
bash skills/github-actions-artifact-budget-audit/scripts/artifact-budget-audit.sh

JSON output for automation:

ARTIFACT_GLOB='artifacts/github-actions-artifacts/*.json' \
OUTPUT_FORMAT=json \
FAIL_ON_CRITICAL=1 \
bash skills/github-actions-artifact-budget-audit/scripts/artifact-budget-audit.sh

Filter to one repo and artifact family:

ARTIFACT_GLOB='artifacts/github-actions-artifacts/*.json' \
REPO_MATCH='^flowcreatebot/' \
ARTIFACT_MATCH='(test-results|coverage)' \
bash skills/github-actions-artifact-budget-audit/scripts/artifact-budget-audit.sh

Run with bundled fixtures:

ARTIFACT_GLOB='skills/github-actions-artifact-budget-audit/fixtures/*.json' \
bash skills/github-actions-artifact-budget-audit/scripts/artifact-budget-audit.sh

Output contract

• Exit 0 in reporting mode (default)
• Exit 1 if FAIL_ON_CRITICAL=1 and at least one artifact is at/above CRITICAL_MB
• In text mode: prints summary and top oversized artifact groups
• In json mode: prints summary, grouped artifact stats, and critical artifact instances